Udostępnij za pośrednictwem

Get-SCVirtualCOMPort

  • Odwołanie
Moduł:
VirtualMachineManager

Pobiera wirtualny port COM z maszyny wirtualnej, szablonu maszyny wirtualnej lub profilu sprzętu.

Składnia

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

Opis

Polecenie cmdlet Get-SCVirtualCOMPort pobiera obiekty portów komunikacji wirtualnej (COM). To polecenie cmdlet pobiera jeden lub oba porty COM z obiektu maszyny wirtualnej, obiektu szablonu maszyny wirtualnej lub obiektu profilu sprzętowego zarządzanego przez program Virtual Machine Manager (VMM).

Wirtualny port COM może łączyć się z portem fizycznym na serwerze hosta maszyny wirtualnej, z plikiem tekstowym lub z nazwanym potokiem. Każda maszyna wirtualna, szablon maszyny wirtualnej i profil sprzętu zawiera dokładnie dwa porty COM.

Przykłady

Przykład 1. Pobieranie portów COM dla maszyny wirtualnej

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

Pierwsze polecenie pobiera maszynę wirtualną o nazwie VM01, a następnie przechowuje ten obiekt w zmiennej $VM.

Drugie polecenie pobiera obiekty wirtualnego portu COM na maszynie WIRTUALNEJ VM01 i wyświetla informacje o tych portach.

Przykład 2. Pobieranie portów COM dla szablonu

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

Pierwsze polecenie pobiera szablon maszyny wirtualnej o nazwie VMTemplate01, a następnie przechowuje ten obiekt w zmiennej $VMTemplate.

Drugie polecenie pobiera obiekty portów wirtualnych COM dla maszyny wirtualnej VMTemplate01 i wyświetla informacje o tych portach.

Przykład 3. Pobieranie portów COM dla profilu sprzętowego

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

Pierwsze polecenie pobiera profil sprzętu o nazwie NewHWProfile01, a następnie przechowuje ten obiekt w zmiennej $HWProfile.

Drugie polecenie pobiera obiekty wirtualnego portu COM dla newHWProfile01 i wyświetla informacje o tych portach.

Parametry

-All

Wskazuje, że to polecenie cmdlet pobiera pełną listę podrzędnych portów COM niezależnie od obiektu nadrzędnego.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-HardwareProfile

Określa obiekt profilu sprzętowego.

Typ:HardwareProfile
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VM

Określa maszynę wirtualną, dla której to polecenie cmdlet pobiera wirtualne porty COM. Aby uzyskać obiekt maszyny wirtualnej, użyj polecenia cmdlet Get-SCVirtualMachine.

Typ:VM
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VMMServer

Określa obiekt serwera programu VMM.

Typ:ServerConnection
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VMTemplate

Określa szablon programu VMM używany do tworzenia maszyn wirtualnych, dla których to polecenie cmdlet pobiera wirtualne porty COM. Aby uzyskać obiekt szablonu programu VMM, użyj polecenia cmdlet Get-SCVMTemplate.

Typ:Template
Aliasy:Template
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

VirtualCOMPort

To polecenie cmdlet zwraca obiekt VirtualCOMPort.