Get-SCVirtualCOMPort

  • リファレンス
モジュール:
VirtualMachineManager

仮想マシン、仮想マシン テンプレート、またはハードウェア プロファイルから仮想 COM ポートを取得します。

構文

Get-SCVirtualCOMPort
   [-VMMServer <ServerConnection>]
   [-All]
   [<CommonParameters>]
Get-SCVirtualCOMPort
   -HardwareProfile <HardwareProfile>
   [<CommonParameters>]
Get-SCVirtualCOMPort
   -VM <VM>
   [<CommonParameters>]
Get-SCVirtualCOMPort
   -VMTemplate <Template>
   [<CommonParameters>]

説明

Get-SCVirtualCOMPort コマンドレットは、仮想通信 (COM) ポート オブジェクトを取得します。 このコマンドレットは、仮想マシン オブジェクト、仮想マシン テンプレート オブジェクト、または Virtual Machine Manager (VMM) が管理するハードウェア プロファイル オブジェクトから、一方または両方の COM ポートを取得します。

仮想 COM ポートは、仮想マシン ホスト サーバー上の物理ポート、テキスト ファイル、または名前付きパイプに接続できます。 各仮想マシン、仮想マシン テンプレート、ハードウェア プロファイルには、正確に 2 つの COM ポートが含まれています。

例

例 1: 仮想マシンの COM ポートを取得する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualCOMPort -VM $VM

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

2 番目のコマンドは、VM01 上の仮想 COM ポート オブジェクトを取得し、これらのポートに関する情報を表示します。

例 2: テンプレートの COM ポートを取得する

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualCOMPort -VMTemplate $VMTemplate

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

2 番目のコマンドは、VMTemplate01 の仮想 COM ポート オブジェクトを取得し、これらのポートに関する情報を表示します。

例 3: ハードウェア プロファイルの COM ポートを取得する

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualCOMPort -HardwareProfile $HWProfile

最初のコマンドは NewHWProfile01 という名前のハードウェア プロファイルを取得し、そのオブジェクトを $HWProfile 変数に格納します。

2 番目のコマンドは、NewHWProfile01 の仮想 COM ポート オブジェクトを取得し、これらのポートに関する情報を表示します。

パラメーター

-All

このコマンドレットは、親オブジェクトに依存しない下位 COM ポートの完全な一覧を取得することを示します。

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

-HardwareProfile

ハードウェア プロファイル オブジェクトを指定します。

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

-VM

このコマンドレットが仮想 COM ポートを取得する仮想マシンを指定します。 仮想マシン オブジェクトを取得するには、 Get-SCVirtualMachine コマンドレットを使用します。

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

-VMMServer

VMM サーバー オブジェクトを指定します。

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

-VMTemplate

このコマンドレットが仮想 COM ポートを取得する仮想マシンの作成に使用される VMM テンプレートを指定します。 VMM テンプレート オブジェクトを取得するには、 Get-SCVMTemplate コマンドレットを使用します。

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

出力

VirtualCOMPort

このコマンドレットは 、VirtualCOMPort オブジェクトを返します。