Remove-SCVirtualNetworkAdapter

モジュール:

VirtualMachineManager

VMM から仮想ネットワーク アダプター オブジェクトを削除します。

構文

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

説明

Remove-SCVirtualNetworkAdapter コマンドレットは、仮想マシン マネージャー (VMM) 環境で使用される仮想マシン、仮想マシン テンプレート、またはハードウェア プロファイルから 1 つ以上の仮想ネットワーク アダプター オブジェクトを削除します。

このコマンドレットは、成功した場合にオブジェクトを返すか (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 変数に格納します。

2 番目のコマンドは、指定された 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 変数に格納します。

2 番目のコマンドは、指定された仮想ネットワークに接続されている 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 変数に格納します。

2 番目のコマンドは、VM03 上の仮想ネットワーク アダプター オブジェクトを取得し、そのオブジェクトを $Adapter 変数に格納します。 この例では、VM03 に仮想ネットワーク アダプターが 1 つしかないことを前提としています。

最後のコマンドは、vm03 から$Adapterに格納されている仮想ネットワーク アダプター オブジェクトを削除します。

例 4: 仮想マシンからすべての仮想ネットワーク アダプターを削除する

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

最初のコマンドは、VM04 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 番目のコマンドは、VM04 上のすべての仮想ネットワーク アダプター オブジェクトを取得し、$Adapters オブジェクト配列にオブジェクトを格納します。

最後のコマンドは、$Adaptersに格納されている各オブジェクトを Remove-SCVirtualNetworkAdapter に渡します。これにより、VM04 から各仮想ネットワーク アダプター オブジェクトが削除されます。

例 5: 3 つの仮想ネットワーク アダプターを持つ仮想マシンから 2 番目の仮想ネットワーク アダプターを削除する

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

最初のコマンドは、VM05 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 番目のコマンドは、VM05 上のすべての仮想ネットワーク アダプター オブジェクトを取得し、$Adapters オブジェクト配列にオブジェクトを格納します。 この例では、VM05 に 3 つの仮想ネットワーク アダプターがあることを前提としています。

最後のコマンドは、2 番目の仮想ネットワーク アダプター オブジェクト ($Adapters [1]) を Remove-SCVirtualNetworkAdapter コマンドレットに渡します。これにより、この仮想ネットワーク アダプター オブジェクトが VM05 から削除されます。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されたユーザーに代わって動作します。

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

-OnBehalfOfUserRole

ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを 使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。

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

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

メモ

• Get-SCVirtualNetworkAdapter コマンドレットを使用して取得できる VMM 仮想ネットワーク アダプター オブジェクトが必要です。

関連リンク

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