Remove-NetworkSwitchVlan

適用対象: Windows 10 Technical Preview

Remove-NetworkSwitchVlan

Removes network switch VLANs.

構文

Parameter Set: InputObjectSet
Remove-NetworkSwitchVlan -CimSession <CimSession> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: InstanceIdSet
Remove-NetworkSwitchVlan -CimSession <CimSession> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-InstanceId <String> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: NameSet
Remove-NetworkSwitchVlan -CimSession <CimSession> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-Name <String> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: VlanIdSet
Remove-NetworkSwitchVlan -CimSession <CimSession> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-VlanId <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]

詳細説明

The Remove-NetworkSwitchVlan cmdlet removes virtual local area networks (VLANs) from a network switch.

パラメーター

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

Aliases

none

必須/オプション

true

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-InformationAction<System.Management.Automation.ActionPreference>

Specifies how this cmdlet responds to an information event. このパラメーターに指定できる値は、次のとおりです。

-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend

Aliases

infa

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-InformationVariable<System.String>

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

Aliases

iv

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-InstanceId<String>

Specifies the instance ID of a VLAN to remove.

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-Name<String>

Specifies a name for a VLAN to remove. You can use wildcard characters to select multiple VLANs to remove.

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-VlanId<Int32>

Specifies the ID of a VLAN to remove.

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

<CommonParameters>

このコマンドレットは共通のパラメーターをサポートしています(-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable)。詳細については、TechNet の「 「about_CommonParameters」 (https://go.microsoft.com/fwlink/p/?LinkID=113216) を参照してください。

<WorkflowParameters>

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

  • CimInstance[]

    You can pipe an array of CimInstance objects that correspond to network switch VLANs to this cmdlet.

出力

出力型は、コマンドレットが出力するオブジェクトの型です。

  • None

    This cmdlet does not generate any output.

使用例

Example 1: Remove a VLAN that has a specified ID

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 VLAN that has a VLAN ID of 2 for the switch NetworkSwitch08 by using the $Session object.

PS C:\> $Session = New-CimSession -ComputerName "NetworkSwitch08"
PS C:\> Remove-NetworkSwitchVlan -CimSession $Session -VlanID 2

Example 2: Remove a VLAN for a specified instance ID

This command removes the VLAN for the specified instance ID. The command includes a CimSession, similar to the first example.

PS C:\> Remove-NetworkSwitchVlan -CimSession $Session -InstanceID "Contoso:NetworkVLAN:Vlan4"

Example 3: Remove VLANs that have names that contain a string

This command removes all VLANs that have friendly names that include the string Contoso. The command includes a CimSession, similar to the first example.

PS C:\> Remove-NetworkSwitchVlan -CimSession $Session -Name "*Contoso*" 

関連項目

Disable-NetworkSwitchVlan

Enable-NetworkSwitchVlan

Get-NetworkSwitchVlan

New-NetworkSwitchVlan

Set-NetworkSwitchVlanProperty