共用方式為

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>]

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 埠的完整清單。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-HardwareProfile

指定硬體配置檔物件。

類型:HardwareProfile
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-VM

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

類型:VM
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-VMMServer

指定 VMM 伺服器物件。

類型:ServerConnection
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-VMTemplate

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

類型:Template
別名:Template
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

輸出

VirtualCOMPort

此 Cmdlet 會傳回 VirtualCOMPort 物件。