Remove-NetworkSwitchVlan

아티클
11/16/2015

적용 대상: 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.

별칭	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

별칭	infa
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-InformationVariable<System.String>

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

별칭	iv
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-InstanceId<String>

Specifies the instance ID of a VLAN to remove.

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

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-VlanId<Int32>

Specifies the ID of a VLAN to remove.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216)

<WorkflowParameters>

입력

입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.

CimInstance[]

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

출력

출력 형식은 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*"

Remove-NetworkSwitchVlan