Delen via

Set-SCVirtualCOMPort

  • Referentie
Module:
VirtualMachineManager

Wijzigt eigenschappen van een virtuele COM-poort voor een virtuele machine, virtuele-machinesjabloon of hardwareprofiel.

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

De cmdlet Set-SCVirtualCOMPort wijzigt een of meer eigenschappen van een COM-poort (virtual communications). Een virtuele COM-poort maakt deel uit van een virtuele machine, virtuele-machinesjabloon of hardwareprofiel dat wordt gebruikt in een VMM-omgeving (Virtual Machine Manager). Geef een COM-poort op met behulp van de parameter VirtualCOMPort of geef een virtuele COM-poort-id op voor de parameter GuestPort . Geldige waarden voor GuestPort zijn nul (0) en één (1).

Met deze cmdlet kunt u een virtuele COM-poort verbinden met een fysieke COM-poort, een tekstbestand of een benoemde pijp. Met deze cmdlet kan de verbinding met een virtuele COM-poort worden verbroken. Als u een virtuele COM-poort op een virtuele machine verbindt met een fysieke COM-poort op de host, kan de virtuele machine de fysieke COM-poort gebruiken voor invoer en uitvoer. De hosttypen ondersteunen de volgende verbindingstypen voor virtuele COM-poorten:

  • Hyper-V. Maakt alleen verbinding met een benoemde pijp.
  • VMware ESX. Maakt verbinding met een fysieke COM-poort, tekstbestand of benoemde pijp.
  • Citrix XenServer. Niet ondersteund.

De parameter WaitForModem geeft aan of een virtuele COM-poort op een virtuele machine onmiddellijk verbinding maakt met een fysieke COM-poort op de host wanneer de virtuele machine wordt gestart.

Als u een waarde opgeeft van $True voor WaitForModem, probeert de virtuele machine alleen verbinding te maken met de fysieke COM-poort op de host als een programma dat wordt uitgevoerd op de virtuele machine een modemopdracht naar de fysieke COM-poort verzendt. Als de COM-poort op de host al is verbonden, kan de virtuele machine er geen verbinding mee maken. Als de virtuele machine verbinding maakt met de fysieke COM-poort, geeft de virtuele machine de fysieke COM-poort later weer vrij aan het hostbesturingssysteem als het programma op de virtuele machine die gebruikmaakt van de COM-poort stopt met het gebruik van de COM-poort.

Als u een waarde opgeeft van $False voor WaitForModem, probeert de virtuele machine verbinding te maken met de fysieke COM-poort op de host zodra de virtuele machine wordt gestart. Als de COM-poort op de host al is vastgelegd, kan de virtuele machine er geen verbinding mee maken. Dit is hetzelfde gedrag als voor een waarde van $True. Als de virtuele machine verbinding maakt met de fysieke COM-poort, geeft de virtuele machine de fysieke COM-poort pas weer vrij aan het hostbesturingssysteem als de virtuele machine is afgesloten.

Voorbeelden

Voorbeeld 1: Een virtuele COM-poort verbinden met een benoemde pijp

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"

Met de eerste opdracht wordt de virtuele machine met de naam VM02 opgehaald en wordt dat object vervolgens opgeslagen in de variabele $VM.

Met de tweede opdracht wordt de virtuele COM-poort met de naam COM1 opgehaald van VM02 en wordt dat object vervolgens opgeslagen in de variabele $COM 1.

Met de laatste opdracht wordt de virtuele COM-poort in $COM 1 verbonden met de benoemde pijp \Contoso\Pipe\PipeName.

Voorbeeld 2: Verbinding met een virtuele COM-poort verbreken

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

Met de eerste opdracht wordt de virtuele machine met de naam VM04 opgehaald en wordt dat object vervolgens opgeslagen in de $VM variabele.

Met de tweede opdracht wordt de virtuele COM-poort op VM04 met de naam COM1 opgehaald en wordt dat object vervolgens opgeslagen in de variabele $COM 1.

Met de laatste opdracht wordt de parameter NoAttach opgegeven. Hierdoor wordt de verbinding met de virtuele COM-poort in $COM 1 verbroken. U kunt deze opdracht gebruiken om een virtuele COM-poort die momenteel is verbonden met een fysieke COM-poort op een host, te verbreken met een benoemde pijp of met een tekstbestand.

Parameters

-GuestPort

Hiermee geeft u de id van een virtuele COM-poort op een virtuele machine. Geldige waarden zijn: 0 en 1.

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

-JobGroup

Hiermee geeft u een id op voor een reeks opdrachten die worden uitgevoerd als een set vlak voor de laatste opdracht die dezelfde taakgroep-id bevat.

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

-JobVariable

Hiermee geeft u een variabele op waarin de voortgang van de taak wordt bijgehouden en opgeslagen.

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

-NamedPipe

Hiermee geeft u een benoemde pijp waarmee een virtuele COM-poort verbinding maakt. Typische toepassingen zijn onder andere het verbinden van een virtuele machine met een foutopsporingsprogramma op de host. U kunt ook een virtuele null-modemkabel tussen twee virtuele machines maken. Geef een pijp op in de volgende indeling: \.\ComputerName\Pipe\PipeName

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

-NoAttach

Geeft aan dat deze cmdlet aangeeft dat er geen fysieke COM-poort op een host, benoemde pijp of bestand verbinding maakt met een virtuele COM-poort. Als u deze parameter opgeeft, verbreekt de cmdlet een virtuele COM-poort die al is verbonden met een fysieke COM-poort, met een benoemde pijp of met een tekstbestand.

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

-PROTipID

Hiermee geeft u de id op van de PRO-tip (Performance and Resource Optimization) die deze actie heeft geactiveerd. Hierdoor kunnen PRO-tips worden gecontroleerd.

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

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

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

-TextFile

Hiermee geeft u een tekstbestand op de host waarmee de virtuele COM-poort verbinding maakt. De virtuele machine verzendt uitvoer van de virtuele COM-poort het tekstbestand dat met deze parameter wordt opgegeven. Het tekstbestand kan zich op elk geldig schijfstation op de host bevinden.

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

-VirtualCOMPort

Hiermee geeft u een virtueel COM-poortobject op dat door deze cmdlet wordt gewijzigd. VMM ondersteunt het configureren van twee COM-poorten op een virtuele machine, sjabloon of hardwareprofiel.

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

-VMHostCOMPort

Hiermee geeft u een fysiek COM-poortobject op een hostserver waarmee de virtuele machine een virtuele COM-poort kan verbinden.

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

-VMMServer

Hiermee geeft u een VMM-server.

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

-WaitForModem

Hiermee wordt aangegeven of een virtuele COM-poort op een virtuele machine onmiddellijk verbinding maakt met een fysieke COM-poort op de host wanneer de virtuele machine wordt gestart.

Als u een waarde van $True opgeeft, wacht de virtuele COM-poort om verbinding te maken met een fysieke COM-poort op de host. Als u een waarde van $False opgeeft, maakt de virtuele COM-poort onmiddellijk verbinding met een fysieke COM-poort op de host zodra de virtuele machine wordt gestart.

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

Uitvoerwaarden

VirtualCOMPort

Deze cmdlet retourneert een VirtualCOMPort-object .

Notities

  • Hiervoor is een VMM virtual COM-poortobject vereist. U kunt dit object ophalen met behulp van de Cmdlet Get-SCVirtualCOMPort .