|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Set-NaNetInterface
NAME
Set-NaNetInterface
SYNOPSIS
Configure network interface.
SYNTAX
Set-NaNetInterface [-InterfaceName] <String> [-Alias] [-RemoveAlias] [-NoDdn
s] [[-Address] <String>] [-Netmask <String>] [-PrefixLength <UInt32>] [-Broa
dcast <String>] [-MediaType <String>] [-FlowControl <String>] [-DadAttempts
<UInt32>] [-MtuSize <UInt32>] [-Up] [-Down] [-Trusted [<Boolean>]] [-Wins [<
Boolean>]] [-Nfo [<Boolean>]] [-Partner <String>] [-Controller <NaController
>] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Configure network interface. This affects both the current configuration an
d the persistent configuration in /etc/rc.
PARAMETERS
-InterfaceName <String>
The name of the interface to configure.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Alias
Specify to add an address as an alias.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-RemoveAlias
Specify to remove an address as an alias.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-NoDdns
Specify to prevent DDNS advertisement.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Address <String>
IP address.
Required? false
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Netmask <String>
Netmask for the specified address. Mutually exclusive with PrefixLength
.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-PrefixLength <UInt32>
The number of bits reserved for subdividing networks into subnetworks.
Mutually exclusive with Netmask.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Broadcast <String>
The broadcast address for this network address.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-MediaType <String>
Specifies the Ethernet media type used. Values are tp, tp-fd, 100tx, 10
0tx-fd, 1000fx, 10g-sr, auto.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-FlowControl <String>
Flow control type. Values are none, receive, send, full.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-DadAttempts <UInt32>
(Inet6 only) Specifies Duplicate Address Detection-attempts to use for t
he multicast interface.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-MtuSize <UInt32>
The MTU (maximum transmission unit) to use for the network interface. R
ange: 296-9196
Required? false
Position? named
Default value 1500
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Up
Specify to bring this interface online.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Down
Specify to take this interface offline.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Trusted [<Boolean>]
Specifies that the network to which the interface is attached is trusted
relative to firewall-style security (default).
Required? false
Position? named
Default value true
Accept pipeline input? false
Accept wildcard characters? false
-Wins [<Boolean>]
Specifies that the network interface is to be registered with Windows In
ternet Name Services (default).
Required? false
Position? named
Default value true
Accept pipeline input? false
Accept wildcard characters? false
-Nfo [<Boolean>]
Specifies that negotiated failover is to be enabled for the network inte
rface.
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? false
-Partner <String>
Name of cluster partner interface that will failover to this interface.
Specify an empty string to clear the partner interface.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".
INPUTS
OUTPUTS
DataONTAP.Types.Net.InterfaceConfigInfo
NOTES
Category: net
API: system-cli, net-ifconfig-set
Privilege: security-priv-admin, cli-ifconfig
-------------- Example 1 --------------
C:\PS>Set-NaNetInterface e0b -Down
Down interface 'e0b'.
Aliases : {10.10.10.22}
DadAttempts : 5
Flowcontrol :
InterfaceName : e0b
IpspaceName : default-ipspace
IsEnabled : False
IsNfoEnabled : False
IsTrusted : True
IsWinsEnabled : False
MacAddress : 00:a0:98:06:c2:26
Mediatype :
Mtusize : 1200
Partner : e0b
V4PrimaryAddress : 10.10.10.10
V6PrimaryAddress : 3ffe:1900:4545:3:200:f8ff:fe21:67cf
DadAttemptsSpecified : True
IsEnabledSpecified : True
IsNfoEnabledSpecified : False
IsTrustedSpecified : False
IsWinsEnabledSpecified : True
MtusizeSpecified : True
-------------- Example 2 --------------
C:\PS>Set-NaNetInterface e0b -Alias -Address 10.10.10.23 -Netmask 255.255.25
5.0 -Broadcast 10.10.10.255
Add an alias address to interface 'e0b'.
Aliases : {10.10.10.22, 10.10.10.23}
DadAttempts : 5
Flowcontrol :
InterfaceName : e0b
IpspaceName : default-ipspace
IsEnabled : False
IsNfoEnabled : False
IsTrusted : True
IsWinsEnabled : False
MacAddress : 00:a0:98:06:c2:26
Mediatype :
Mtusize : 1200
Partner : e0b
V4PrimaryAddress : 10.10.10.10
V6PrimaryAddress : 3ffe:1900:4545:3:200:f8ff:fe21:67cf
DadAttemptsSpecified : True
IsEnabledSpecified : True
IsNfoEnabledSpecified : False
IsTrustedSpecified : False
IsWinsEnabledSpecified : True
MtusizeSpecified : True
RELATED LINKS
Get-NaNetInterface
| Copyright © 2012 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|