Share via

Get-SCVirtualCOMPort

  • 參考
模組:
VirtualMachineManager

從虛擬機器、虛擬機器範本或硬體設定檔取得虛擬 COM 埠。

Syntax

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

Description

Get-SCVirtualCOMPort Cmdlet 會 (COM) 埠物件取得虛擬通訊。 此 Cmdlet 會從虛擬機器物件、虛擬機器範本物件或 Virtual Machine Manager (VMM) 管理的硬體設定檔物件取得一或兩個 COM 埠。

虛擬 COM 通訊埠可以連線至虛擬機器主機伺服器的實體通訊埠、文字檔案或具名管道。 每個虛擬機器、虛擬機器範本和硬體設定檔都只包含兩個 COM 埠。

範例

範例 1：取得虛擬機器的 COM 埠

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

第一個命令會取得名為 VM01 的虛擬機器，然後將該物件儲存在 $VM 變數中。

第二個命令會取得 VM01 上的虛擬 COM 埠物件，並顯示這些埠的相關資訊。

範例 2：取得範本的 COM 埠

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

第一個命令會取得名為 VMTemplate01 的虛擬機器範本，然後將該物件儲存在$VMTemplate變數中。

第二個命令會取得 VMTemplate01 的虛擬 COM 埠物件，並顯示這些埠的相關資訊。

範例 3：取得硬體設定檔的 COM 埠

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

第一個命令會取得名為 NewHWProfile01 的硬體設定檔，然後將該物件儲存在$HWProfile變數中。

第二個命令會取得 NewHWProfile01 的虛擬 COM 埠物件，並顯示這些埠的相關資訊。

參數

-All

指出此 Cmdlet 會取得與父物件無關之從屬 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

指定此 Cmdlet 取得虛擬 COM 埠的虛擬機器。 若要取得虛擬機器物件，請使用 Get-SCVirtualMachine Cmdlet。

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

指定 VMM 範本，用來建立此 Cmdlet 取得虛擬 COM 埠的虛擬機器。 若要取得 VMM 範本物件，請使用 Get-SCVMTemplate Cmdlet。

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

輸出

VirtualCOMPort

此 Cmdlet 會傳回 VirtualCOMPort 物件。