Sdílet prostřednictvím

Get-SCVirtualCOMPort

  • Reference
Modul:
VirtualMachineManager

Získá virtuální port MODELU COM z virtuálního počítače, šablony virtuálního počítače nebo hardwarového profilu.

Syntax

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

Description

Rutina Get-SCVirtualCOMPort získá objekty portu virtuální komunikace (COM). Tato rutina získá jeden nebo oba porty MODELU COM z objektu virtuálního počítače, objekt šablony virtuálního počítače nebo objekt profilu hardwaru, který nástroj Virtual Machine Manager (VMM) spravuje.

Virtuální port COM se může připojit k fyzickému portu na hostitelském serveru virtuálního počítače, k textovému souboru nebo k pojmenované kanálu. Každý virtuální počítač, šablona virtuálního počítače a hardwarový profil obsahují přesně dva porty COM.

Příklady

Příklad 1: Získání portů MODELU COM pro virtuální počítač

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

První příkaz získá virtuální počítač s názvem VM01 a pak tento objekt uloží do proměnné $VM.

Druhý příkaz získá virtuální objekty portu COM na virtuálním počítači VM01 a zobrazí informace o těchto portech.

Příklad 2: Získání portů MODELU COM pro šablonu

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

První příkaz získá šablonu virtuálního počítače s názvem VMTemplate01 a pak tento objekt uloží do proměnné $VMTemplate.

Druhý příkaz získá virtuální objekty portu COM pro VMTemplate01 a zobrazí informace o těchto portech.

Příklad 3: Získání portů MODELU COM pro hardwarový profil

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

První příkaz získá hardwarový profil NewHWProfile01 a pak tento objekt uloží do proměnné $HWProfile.

Druhý příkaz získá virtuální objekty portu COM pro NewHWProfile01 a zobrazí informace o těchto portech.

Parametry

-All

Označuje, že tato rutina získá úplný seznam podřízených portů COM nezávisle na nadřazeného objektu.

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

-HardwareProfile

Určuje objekt hardwarového profilu.

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

-VM

Určuje virtuální počítač, pro který tato rutina získá virtuální porty COM. K získání objektu virtuálního počítače použijte rutinu Get-SCVirtualMachine .

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

-VMMServer

Určuje objekt serveru VMM.

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

-VMTemplate

Určuje šablonu VMM, která se používá k vytvoření virtuálních počítačů, pro které tato rutina získá virtuální porty COM. K získání objektu šablony VMM použijte rutinu Get-SCVMTemplate .

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

Výstupy

VirtualCOMPort

Tato rutina vrátí objekt VirtualCOMPort .