Edit

Share via


Remove-NetworkSwitchEthernetPortIPAddress

Removes an IP address from a port of a network switch.

Syntax

PortNumberSet

Remove-NetworkSwitchEthernetPortIPAddress
    -CimSession <CimSession>
    -PortNumber <Int32>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectSet

Remove-NetworkSwitchEthernetPortIPAddress
    -CimSession <CimSession>
    -InputObject <CimInstance[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Remove-NetworkSwitchEthernetPortIPAddress cmdlet removes an assigned IP address from a port of a network switch.

Examples

Example 1: Remove an IP address from a port by using the pipeline

PS C:\>$Session = New-CimSession -ComputerName "NetworkSwitch08"
PS C:\> Remove-NetworkSwitchEthernetPortIPAddress -CimSession $Session -PortNumber 21

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 removes the IP address of port 21 by using the $Session object.

Parameters

-CimSession

Specifies the CimSession to connect to the network switch. For more information about CimSession objects, type Get-Help New-CimSession.

Parameter properties

Type:CimSession
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputObject

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

Parameter properties

Type:

CimInstance[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

InputObjectSet
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-PortNumber

Specifies the number of a port. This cmdlet removes the IP address from the port that this parameter specifies.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

PortNumberSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

CimInstance

Outputs

Object