Get-SCVirtualCOMPort

从虚拟机、虚拟机模板或硬件配置文件获取虚拟 COM 端口。

语法

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

说明

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

指定用于创建此 cmdlet 获取虚拟 COM 端口的虚拟机的 VMM 模板。 若要获取 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 对象。