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.

Syntaxe

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 COM pomocí parametru VirtualCOMPort nebo zadejte ID virtuálního portu COM pro parametr 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é kanálu. Tato rutina může odpojit virtuální port COM. Pokud připojíte virtuální port COM na virtuálním počítači k fyzickému portu COM na jeho hostiteli, může virtuální počítač použít fyzický port COM pro vstup a výstup. Typy hostitelů podporují následující typy připojení k virtuálnímu portu COM:

  • Hyper-V. Připojí se pouze k pojmenované svislé sadě.
  • VMware ESX. Připojí se k fyzickému portu COM, textovému souboru nebo pojmenované svislé sadě.
  • Citrix XenServer. Nepodporuje se.

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

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 modemový příkaz na fyzický port COM. 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 hned po spuštění virtuálního počítače. Pokud je port COM na hostiteli již zachycen, virtuální počítač se k němu nemůže připojit. Jedná se o stejné chování 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 virtuálního počítače 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 načte 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 virtuálním počítači 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é svislé sadě 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.

Typ:Byte
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-JobGroup

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

Typ:Guid
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobVariable

Určuje proměnnou, ve které je průběh úlohy sledován a uložen.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NamedPipe

Určuje pojmenovaný kanál, ke kterému se připojí 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

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NoAttach

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:VirtualCOMPort
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:Byte
Aliasy:HostPort
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VMMServer

Určuje server VMM.

Typ:ServerConnection
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WaitForModem

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

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Výstupy

VirtualCOMPort

Tato rutina vrátí objekt VirtualCOMPort.

Poznámky

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