Remove-SCVirtualNetworkAdapter

모듈:

VirtualMachineManager

VMM에서 가상 네트워크 어댑터 개체를 제거합니다.

Syntax

Remove-SCVirtualNetworkAdapter
      [-VirtualNetworkAdapter] <VirtualNetworkAdapter>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Remove-SCVirtualNetworkAdapter
      -SlotID <Int32>
      -JobGroup <Guid>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

Remove-SCVirtualNetworkAdapter cmdlet은 VMM(Virtual Machine Manager) 환경에서 사용되는 가상 머신, 가상 머신 템플릿 또는 하드웨어 프로필에서 하나 이상의 가상 네트워크 어댑터 개체를 제거합니다.

이 cmdlet은 성공 시 개체를 반환하거나(MarkedForDeletion 속성이 $True 설정됨) 실패 시 오류 메시지를 반환합니다.

예제

예제 1: 가상 머신에서 지정된 MAC 주소가 있는 가상 네트워크 어댑터 제거

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.PhysicalAddress -eq "00:16:D3:CC:00:1B" }
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter

첫 번째 명령은 VM01이라는 가상 머신 개체를 가져오고 개체를 $VM 변수에 저장합니다.

두 번째 명령은 지정된 MAC 주소가 있는 VM01의 가상 네트워크 어댑터 개체를 가져오고 개체를 $Adapter 변수에 저장합니다.

마지막 명령은 VM01에서 $Adapter 저장된 가상 네트워크 어댑터를 제거합니다.

예제 2: 가상 머신에서 특정 가상 네트워크에 연결된 가상 네트워크 어댑터 제거

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.VirtualNetwork -eq "ExternalVirtualNetwork01" }
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter

첫 번째 명령은 VM02라는 가상 머신 개체를 가져오고 개체를 $VM 변수에 저장합니다.

두 번째 명령은 지정된 가상 네트워크에 연결된 VM02의 가상 네트워크 어댑터 개체를 가져오고 개체를 $Adapter 변수에 저장합니다.

마지막 명령은 $Adapter에 보관되어 있는 가상 네트워크 어댑터 개체를 VM02에서 제거합니다.

예제 3: 가상 머신에서 유일한 가상 네트워크 어댑터 제거

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter

첫 번째 명령은 VM03이라는 가상 머신 개체를 가져오고 개체를 $VM 변수에 저장합니다.

두 번째 명령은 VM03에서 가상 네트워크 어댑터 개체를 가져오고 개체를 $Adapter 변수에 저장합니다. 이 예제에서는 VM03에 가상 네트워크 어댑터가 하나만 있다고 가정합니다.

마지막 명령은 VM03에서 $Adapter 저장된 가상 네트워크 어댑터 개체를 제거합니다.

예제 4: 가상 머신에서 모든 가상 네트워크 어댑터 제거

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters | Remove-SCVirtualNetworkAdapter

첫 번째 명령은 VM04라는 가상 머신 개체를 가져오고 개체를 $VM 변수에 저장합니다.

두 번째 명령은 VM04의 모든 가상 네트워크 어댑터 개체를 가져오고 개체를 $Adapters 개체 배열에 저장합니다.

마지막 명령은 VM04에서 각 가상 네트워크 어댑터 개체를 제거하는 Remove-SCVirtualNetworkAdapter에 $Adapters 저장된 각 개체를 전달합니다.

예제 5: 가상 네트워크 어댑터 3개가 있는 가상 머신에서 두 번째 가상 네트워크 어댑터 제거

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters[1] | Remove-SCVirtualNetworkAdapter

첫 번째 명령은 VM05라는 가상 머신 개체를 가져오고 개체를 $VM 변수에 저장합니다.

두 번째 명령은 VM05의 모든 가상 네트워크 어댑터 개체를 가져오고 개체를 $Adapters 개체 배열에 저장합니다. 이 예제에서는 VM05에 3개의 가상 네트워크 어댑터가 있다고 가정합니다.

마지막 명령은 두 번째 가상 네트워크 어댑터 개체($Adapters [1])를 Remove-SCVirtualNetworkAdapter cmdlet에 전달하여 VM05에서 이 가상 네트워크 어댑터 개체를 제거합니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

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

-JobGroup

동일한 작업 그룹 식별자를 포함하는 마지막 명령이 실행되기 직전에 하나의 집합으로 실행되는 일련의 명령에 대한 식별자를 지정합니다.

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

-JobVariable

작업 진행률을 추적하여 이 매개 변수로 이름이 지정된 변수에 보관하도록 지정합니다.

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

-OnBehalfOfUser

사용자 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자를 대신하여 작동합니다.

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

-OnBehalfOfUserRole

사용자 역할을 지정합니다. 사용자 역할을 가져오려면 Get-SCUserRole cmdlet을 사용합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자 역할을 대신하여 작동합니다.

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

-PROTipID

이 작업을 트리거한 PRO 팁(성능 및 리소스 최적화 팁)의 ID를 지정합니다. 이 매개 변수를 사용하면 PRO 팁을 감사할 수 있습니다.

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

-RunAsynchronously

컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.

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

-SlotID

디바이스를 식별하는 데 사용되는 숫자 ID를 지정합니다.

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

-VirtualNetworkAdapter

가상 컴퓨터의 가상 네트워크 어댑터 개체를 지정합니다.

호스트 유형은 다음과 같은 수의 가상 네트워크 어댑터를 지원합니다.

• Hyper-V. 가상 머신당 최대 4개의 에뮬레이트된 어댑터. Windows Server 2003 x64 게스트 운영 체제에서는 에뮬레이트된 네트워크 어댑터에 사용할 수 있는 드라이버가 없습니다.
• Hyper-V. 가상 머신당 최대 8개의 가상 어댑터.
• VMware ESX. 가상 머신당 최대 4개의 에뮬레이트된 어댑터.
• Citrix XenServer. 가상 머신당 최대 7개의 에뮬레이트된 어댑터.

Type:	VirtualNetworkAdapter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

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

참고

• Get-SCVirtualNetworkAdapter cmdlet을 사용하여 검색할 수 있는 VMM 가상 네트워크 어댑터 개체가 필요합니다.

관련 링크

• Get-SCVirtualMachine
• Get-SCVirtualNetworkAdapter
• New-SCVirtualNetworkAdapter
• Repair-SCVirtualNetworkAdapter
• Set-SCVirtualNetworkAdapter