Set-NetworkSwitchEthernetPortIPAddress

NAME Set-NetworkSwitchEthernetPortIPAddress



SYNOPSIS

Sets the IP address on a port on a network switch.





SYNTAX

Set-NetworkSwitchEthernetPortIPAddress [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]

[-InformationVariable <System.String>] -CimSession <CimSession> -IpAddress <String> -PortNumber <Int32> -SubnetAddress <String>

[<CommonParameters>]



Set-NetworkSwitchEthernetPortIPAddress [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]

[-InformationVariable <System.String>] -CimSession <CimSession> -IpAddress <String> -SubnetAddress <String> [<CommonParameters>]





DESCRIPTION

The Set-NetworkSwitchEthernetPortIPAddress cmdlet sets the IP address of an Ethernet port on a network switch.





PARAMETERS

-CimSession <CimSession>

Specifies the CimSession that this cmdlet uses to connect to the network switch. For more information about CimSession objects, type Get-Help

New-CimSession.



Required? true

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-InformationAction [<System.Management.Automation.ActionPreference>]

Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:



-- SilentlyContinue

-- Stop

-- Continue

-- Inquire

-- Ignore

-- Suspend



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-InformationVariable [<System.String>]

Specifies a variable in which to store an information event message.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-IpAddress <String>

Specifies an IP address for the Ethernet port.



Required? true

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-PortNumber <Int32>

Specifies a port number. This cmdlet sets the IP address on the port that this parameter specifies.



Required? true

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-SubnetAddress <String>

Specifies a subnet mask for the IP address.



Required? true

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

CimInstance[]



You can pipe an array of CimInstance objects that refer to an EthernetPort object.





OUTPUTS

None



This cmdlet does not generate any output.





Example 1: Assign an IP address to a port



PS C:\\>$Session = New-CimSession -ComputerName "NetworkSwitch08"

PS C:\\> Set-NetworkSwitchEthernetPortIPAddress -IpAddress "10.4.10.12" -PortNumber 21 -SubnetAddress "255.255.255.248" ????????CimSession $Session



The first command creates a CimSession for a network switch, and then stores it in the $Session variable. For more information about CimSession

objects, type Get-Help New-CimSession.



The second command assigns an IP address and subnet address to the specified port by using the $Session object.







RELATED LINKS

Remove-NetworkSwitchEthernetPortIPAddress

Get-NetworkSwitchEthernetPort