Remove-SCVirtualNetworkAdapter

構文

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

-JobGroup

-JobVariable

-OnBehalfOfUser

-OnBehalfOfUserRole

-PROTipID

-RunAsynchronously

-SlotID

-VirtualNetworkAdapter

-WhatIf

メモ

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

関連リンク

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