Edit

Share via

Set-NetworkSwitchEthernetPortIPAddress

  • Reference
Module:
NetworkSwitchManager

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

Syntax

Set-NetworkSwitchEthernetPortIPAddress
   -CimSession <CimSession>
   -IpAddress <String>
   -SubnetAddress <String>
   -PortNumber <Int32>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-NetworkSwitchEthernetPortIPAddress
   -CimSession <CimSession>
   -IpAddress <String>
   -SubnetAddress <String>
   -InputObject <CimInstance[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

Examples

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.

Parameters

-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.

Type:CimSession
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifies the input object that is used in a pipeline command.

Type:CimInstance[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-IpAddress

Specifies an IP address for the Ethernet port.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PortNumber

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

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SubnetAddress

Specifies a subnet mask for the IP address.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

CimInstance[]

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

Outputs

Object