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 对象。