Sdílet prostřednictvím

Set-SCVirtualCOMPort

  • Reference
Modul:
VirtualMachineManager

Upraví vlastnosti virtuálního portu COM pro virtuální počítač, šablonu virtuálního počítače nebo hardwarový profil.

Syntax

Set-SCVirtualCOMPort
   [-VMMServer <ServerConnection>]
   -GuestPort <Byte>
   -VMHostCOMPort <Byte>
   [-WaitForModem <Boolean>]
   -JobGroup <Guid>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualCOMPort
   [-VMMServer <ServerConnection>]
   -GuestPort <Byte>
   -TextFile <String>
   -JobGroup <Guid>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualCOMPort
   [-VMMServer <ServerConnection>]
   -GuestPort <Byte>
   [-NoAttach]
   -JobGroup <Guid>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualCOMPort
   [-VMMServer <ServerConnection>]
   -GuestPort <Byte>
   -NamedPipe <String>
   -JobGroup <Guid>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualCOMPort
   [-VirtualCOMPort] <VirtualCOMPort>
   -TextFile <String>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualCOMPort
   [-VirtualCOMPort] <VirtualCOMPort>
   [-NoAttach]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualCOMPort
   [-VirtualCOMPort] <VirtualCOMPort>
   -VMHostCOMPort <Byte>
   [-WaitForModem <Boolean>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualCOMPort
   [-VirtualCOMPort] <VirtualCOMPort>
   -NamedPipe <String>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

Rutina Set-SCVirtualCOMPort upraví jednu nebo více vlastností portu virtuální komunikace (COM). Virtuální port COM je součástí virtuálního počítače, šablony virtuálního počítače nebo hardwarového profilu používaného v prostředí nástroje Virtual Machine Manager (VMM). Zadejte port MODELU COM pomocí parametru VirtualCOMPort nebo zadejte ID virtuálního portu COM parametru GuestPort . Platné hodnoty pro GuestPort jsou nula (0) a jedna (1).

Tato rutina může připojit virtuální port COM k fyzickému portu COM, k textovému souboru nebo k pojmenované rouce. Tato rutina může odpojit virtuální port COM. Pokud připojíte virtuální port MODELU COM na virtuálním počítači k fyzickému portu COM na jeho hostiteli, může virtuální počítač pro vstup a výstup použít fyzický port MODELU COM. Typy hostitelů podporují následující typy připojení portu MODELU COM:

  • Hyper-V. Připojí se pouze k pojmenované trubce.
  • VMware ESX. Připojí se k fyzickému portu MODELU COM, textovému souboru nebo pojmenovaným kanálům.
  • Citrix XenServer. Nepodporuje se.

Parametr WaitForModem určuje, jestli se virtuální port MODELU COM na virtuálním počítači okamžitě připojí k fyzickému portu COM na hostiteli při spuštění virtuálního počítače.

Pokud zadáte hodnotu $True pro WaitForModem, virtuální počítač se pokusí připojit k fyzickému portu COM na hostiteli pouze v případě, že program, který běží na virtuálním počítači, odešle do fyzického portu COM příkaz modemu. Pokud je port MODELU COM na hostiteli již připojený, virtuální počítač se k němu nemůže připojit. Pokud se virtuální počítač úspěšně připojí k fyzickému portu COM, virtuální počítač později uvolní fyzický port COM zpět do hostitelského operačního systému, pokud program na virtuálním počítači, který používá port COM, přestane používat port COM.

Pokud zadáte hodnotu $False pro WaitForModem, virtuální počítač se pokusí připojit k fyzickému portu COM na hostiteli, jakmile se virtuální počítač spustí. Pokud je port MODELU COM na hostiteli již zachycený, virtuální počítač se k němu nemůže připojit. Toto chování je stejné jako u hodnoty $True. Pokud se virtuální počítač úspěšně připojí k fyzickému portu COM, virtuální počítač nevyvolá fyzický port COM zpět do hostitelského operačního systému, dokud se virtuální počítač nevypíná.

Příklady

Příklad 1: Připojení virtuálního portu COM k pojmenované kanálu

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $COM1 = Get-SCVirtualCOMPort -VM $VM | where {$_.Name -eq "COM1"}
PS C:\> Set-SCVirtualCOMPort -VirtualCOMPort $COM1 -NamedPipe "\\Contoso\Pipe\PipeName"

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

Druhý příkaz získá virtuální port COM s názvem COM1 z VM02 a pak tento objekt uloží do proměnné $COM 1.

Poslední příkaz připojí virtuální port COM v $COM 1 s pojmenovaným kanálem \Contoso\Pipe\PipeName.

Příklad 2: Odpojení virtuálního portu COM

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $COM1 = Get-SCVirtualCOMPort -VM $VM | where {$_.Name -eq "COM1"}
PS C:\> Set-SCVirtualCOMPort -VirtualCOMPort $COM1 -NoAttach

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

Druhý příkaz získá virtuální port COM na VM04 s názvem COM1 a pak tento objekt uloží do proměnné $COM 1.

Poslední příkaz určuje parametr NoAttach . To způsobí, že příkaz odpojí virtuální port COM v $COM 1. Tento příkaz můžete použít k odpojení virtuálního portu COM, který je aktuálně připojený k fyzickému portu COM na hostiteli, k pojmenovaným kanálům nebo k textovému souboru.

Parametry

-GuestPort

Určuje ID virtuálního portu COM na virtuálním počítači. Platné hodnoty jsou: 0 a 1.

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

-JobGroup

Určuje identifikátor řady příkazů, které běží jako sada těsně před posledním příkazem, který obsahuje stejné spuštění identifikátoru skupiny úloh.

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

-JobVariable

Určuje proměnnou, ve které se sleduje a ukládá průběh úlohy.

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

-NamedPipe

Určuje pojmenovaný kanál, ke kterému se připojuje virtuální port COM. Mezi typické použití patří připojení virtuálního počítače k ladicímu programu na hostiteli. Můžete také vytvořit virtuální modem s hodnotou null mezi dvěma virtuálními počítači. Zadejte kanál v následujícím formátu: \.\ComputerName\Pipe\PipeName

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

-NoAttach

Označuje, že tato rutina určuje, že se žádný fyzický port MODELU COM na hostiteli, pojmenovaném kanálu nebo souboru nepřipojí k virtuálnímu portu COM. Pokud zadáte tento parametr, rutina odpojí virtuální port MODELU COM, který je již připojený k fyzickému portu COM, k pojmenovaným kanálům nebo k textovému souboru.

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

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (PRO), který tuto akci aktivoval. To umožňuje auditování tipů PRO.

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

-RunAsynchronously

Označuje, že úloha se spouští asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

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

-TextFile

Určuje textový soubor na hostiteli, ke kterému se virtuální port COM připojuje. Virtuální počítač odesílá výstup z virtuálního portu COM textový soubor, který tento parametr určuje. Textový soubor může být na libovolné platné diskové jednotce na hostiteli.

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

-VirtualCOMPort

Určuje virtuální objekt portu COM, který tato rutina upraví. Nástroj VMM podporuje konfiguraci dvou portů COM na virtuálním počítači, šabloně nebo hardwarovém profilu.

Type:VirtualCOMPort
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHostCOMPort

Určuje fyzický objekt portu COM na hostitelském serveru, ke kterému může virtuální počítač připojit virtuální port COM.

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

-VMMServer

Určuje server VMM.

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

-WaitForModem

Určuje, jestli se virtuální port MODELU COM na virtuálním počítači okamžitě připojí k fyzickému portu COM na hostiteli při spuštění virtuálního počítače.

Pokud zadáte hodnotu $True, virtuální port COM čeká na připojení k fyzickému portu COM na hostiteli. Pokud zadáte hodnotu $False, virtuální port COM se okamžitě připojí k fyzickému portu COM na hostiteli, jakmile se virtuální počítač spustí.

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

Výstupy

VirtualCOMPort

Tato rutina vrátí objekt VirtualCOMPort .

Poznámky

  • Vyžaduje objekt portu virtuálního modelu COM VMM. Tento objekt můžete načíst pomocí rutiny Get-SCVirtualCOMPort .