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 コマンドレットを使用して取得できます。