次の方法で共有


Remove-SCVirtualNetworkAdapter

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

構文

VirtualNicSpecified

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

SlotIdSpecified

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

説明

Remove-SCVirtualNetworkAdapter コマンドレットは、Virtual Machine Manager (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 変数に格納します。

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

例 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 つだけあることを前提としています。

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

例 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

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

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-JobGroup

同じジョブ グループ識別子を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの識別子を指定します。

パラメーターのプロパティ

型:Guid
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

VirtualNicSpecified
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-JobVariable

ジョブの進行状況を追跡され、このパラメーターで指定された変数に格納するように指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-OnBehalfOfUser

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-OnBehalfOfUserRole

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

パラメーターのプロパティ

型:UserRole
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

パラメーターのプロパティ

型:Guid
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RunAsynchronously

コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SlotID

デバイスの識別に使用する数値 ID を指定します。

パラメーターのプロパティ

型:Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SlotIdSpecified
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-VirtualNetworkAdapter

仮想マシンの仮想ネットワーク アダプター オブジェクトを指定します。

ホストの種類では、次の数の仮想ネットワーク アダプターがサポートされています。

  • Hyper-V。 仮想マシンごとに最大 4 つのエミュレートされたアダプター。 Windows Server 2003 x64 ゲスト オペレーティング システム上のエミュレートされたネットワーク アダプターに使用できるドライバーはありません。
  • Hyper-V。 仮想マシンごとに最大 8 つの合成アダプター。
  • VMware ESX。 仮想マシンごとに最大 4 つのエミュレートされたアダプター。
  • Citrix XenServer。 仮想マシンごとに最大 7 つのエミュレートされたアダプター。

パラメーターのプロパティ

型:VirtualNetworkAdapter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

VirtualNicSpecified
配置:0
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

メモ

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