Freigeben über

Set-SCVirtualCOMPort

  • Referenz
Modul:
VirtualMachineManager

Ändert die Eigenschaften eines virtuellen COM-Ports für einen virtuellen Computer, eine virtuelle Computervorlage oder ein Hardwareprofil.

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>]

Beschreibung

Das Cmdlet Set-SCVirtualCOMPort ändert eine oder mehrere Eigenschaften eines virtuellen Kommunikationsports (COM). Ein virtueller COM-Port ist Teil eines virtuellen Computers, einer virtuellen Computervorlage oder eines Hardwareprofils, das in einer Virtual Machine Manager -Umgebung (VMM) verwendet wird. Geben Sie einen COM-Port mithilfe des VirtualCOMPort-Parameters an oder geben Sie eine virtuelle COM-Port-ID für den GuestPort-Parameter an. Gültige Werte für GastPort sind Null (0) und eine (1).

Dieses Cmdlet kann einen virtuellen COM-Port mit einem physischen COM-Port, einer Textdatei oder einem benannten Pipe verbinden. Dieses Cmdlet kann einen virtuellen COM-Port trennen. Wenn Sie einen virtuellen COM-Port auf einem virtuellen Computer mit einem physischen COM-Port auf seinem Host verbinden, kann der virtuelle Computer den physischen COM-Port für Eingabe und Ausgabe verwenden. Die Hosttypen unterstützen die folgenden virtuellen COM-Portverbindungstypen:

  • Hyper-V. Verbindet nur eine Verbindung mit einem benannten Rohr.
  • VMware ESX. Stellt eine Verbindung mit einem physischen COM-Port, einer Textdatei oder einer benannten Pipe bereit.
  • Citrix XenServer. Nicht unterstützt.

Der Parameter WaitForModem gibt an, ob ein virtueller COM-Port auf einem virtuellen Computer sofort mit einem physischen COM-Port auf dem Host verbunden ist, wenn der virtuelle Computer gestartet wird.

Wenn Sie einen Wert von $True für WaitForModem angeben, versucht der virtuelle Computer nur, eine Verbindung mit dem physischen COM-Port auf dem Host herzustellen, wenn ein Programm, das auf dem virtuellen Computer ausgeführt wird, einen Modembefehl an den physischen COM-Port sendet. Ist der COM-Anschluss auf dem Host bereits verbunden, kann die virtuelle Maschine keine Verbindung zu ihm herstellen. Wenn der virtuelle Computer erfolgreich eine Verbindung mit dem physischen COM-Port herstellt, wird der virtuelle Computer später den physischen COM-Port wieder in das Hostbetriebssystem freigegeben, wenn das Programm auf dem virtuellen Computer, auf dem der COM-Port verwendet wird, mit dem COM-Port beendet wird.

Wenn Sie einen Wert von $False für WaitForModem angeben, versucht der virtuelle Computer, eine Verbindung mit dem physischen COM-Port auf dem Host herzustellen, sobald der virtuelle Computer gestartet wird. Wenn der COM-Port auf dem Host bereits erfasst wird, kann der virtuelle Computer keine Verbindung mit dem Host herstellen. Dies ist das gleiche Verhalten wie bei einem Wert von $True. Wenn der virtuelle Computer erfolgreich eine Verbindung mit dem physischen COM-Port herstellt, wird der physische COM-Port nicht wieder auf das Hostbetriebssystem freigegeben, bis der virtuelle Computer heruntergefahren wird.

Beispiele

Beispiel 1: Verbinden eines virtuellen COM-Ports mit einem benannten Rohr

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"

Der erste Befehl ruft den virtuellen Computer vm02 ab, und speichert dieses Objekt dann in der $VM Variablen.

Der zweite Befehl ruft den virtuellen COM-Port mit dem Namen COM1 von VM02 ab, und speichert dieses Objekt dann in der $COM 1-Variable.

Der letzte Befehl verbindet den virtuellen COM-Port in $COM 1 mit der benannten Pipe \Contoso\Pipe\PipeName.

Beispiel 2: Trennen eines virtuellen COM-Ports

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

Der erste Befehl ruft den virtuellen Computer vm04 ab, und speichert dieses Objekt dann in der $VM Variablen.

Der zweite Befehl ruft den virtuellen COM-Port auf VM04 namens COM1 ab und speichert dieses Objekt dann in der $COM 1-Variable.

Der letzte Befehl gibt den NoAttach-Parameter an. Dadurch kann der Befehl den virtuellen COM-Port in $COM 1 trennen. Mit diesem Befehl können Sie die Verbindung eines virtuellen COM-Anschlusses trennen, der zurzeit mit einem physischen COM-Anschluss auf dem Host, einer Named Pipe oder einer Textdatei verbunden ist.

Parameter

-GuestPort

Gibt die ID eines virtuellen COM-Ports auf einem virtuellen Computer an. Gültige Werte sind: 0 und 1.

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

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem letzten Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.

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

-JobVariable

Gibt eine Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.

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

-NamedPipe

Gibt eine benannte Pipe an, mit der ein virtueller COM-Port verbunden ist. Typische Verwendungen umfassen die Verbindung eines virtuellen Computers mit einem Debugprogramm auf dem Host. Sie können auch ein virtuelles Null-Modemkabel zwischen zwei virtuellen Computern erstellen. Geben Sie eine Pipe im folgenden Format an: \.\ComputerName\Pipe\PipeName

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

-NoAttach

Gibt an, dass dieses Cmdlet angibt, dass kein physischer COM-Port auf einem Host, benanntem Pipe oder einer Datei mit einem virtuellen COM-Port verbunden ist. Wenn Sie diesen Parameter angeben, trennt das Cmdlet einen virtuellen COM-Port, der bereits mit einem physischen COM-Port verbunden ist, mit einer benannten Pipe oder einer Textdatei.

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

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO) an, durch den die Aktion ausgelöst wurde. Dies ermöglicht die Überwachung von PRO-Tipps.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-TextFile

Gibt eine Textdatei auf dem Host an, mit der der virtuelle COM-Port verbunden ist. Der virtuelle Computer sendet aus dem virtuellen COM-Port die Textdatei, die dieser Parameter angibt. Die Textdatei kann sich auf jedem gültigen Laufwerk auf dem Host befinden.

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

-VirtualCOMPort

Gibt ein virtuelles COM-Portobjekt an, das dieses Cmdlet ändert. In VMM wird das Konfigurieren von zwei COM-Anschlüssen auf einer virtuellen Maschine, in einer Vorlage oder in einem Hardwareprofil unterstützt.

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

-VMHostCOMPort

Gibt ein physisches COM-Portobjekt auf einem Hostserver an, mit dem der virtuelle Computer einen virtuellen COM-Port herstellen kann.

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

-VMMServer

Gibt einen VMM-Server an.

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

-WaitForModem

Gibt an, ob ein virtueller COM-Port auf einem virtuellen Computer sofort mit einem physischen COM-Port auf dem Host verbunden ist, wenn der virtuelle Computer gestartet wird.

Wenn Sie einen Wert von $True angeben, wartet der virtuelle COM-Port auf die Verbindung mit einem physischen COM-Port auf dem Host. Wenn Sie einen Wert von $False angeben, verbinden sich die virtuelle COM-Port sofort mit einem physischen COM-Port auf dem Host, sobald der virtuelle Computer gestartet wird.

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

Ausgaben

VirtualCOMPort

Dieses Cmdlet gibt ein VirtualCOMPort-Objekt zurück.

Hinweise

  • Erfordert ein virtuelles COM-Portobjekt von VMM. Sie können dieses Objekt mithilfe des Cmdlets Get-SCVirtualCOMPort abrufen.