Set-SCVirtualCOMPort

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

Set-SCVirtualCOMPort
    -GuestPort <Byte>
    -TextFile <String>
    -JobGroup <Guid>
    [-VMMServer <ServerConnection>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Set-SCVirtualCOMPort
    -GuestPort <Byte>
    -JobGroup <Guid>
    [-VMMServer <ServerConnection>]
    [-NoAttach]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Set-SCVirtualCOMPort
    -GuestPort <Byte>
    -NamedPipe <String>
    -JobGroup <Guid>
    [-VMMServer <ServerConnection>]
    [-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>]

Mit dem Cmdlet Set-SCVirtualCOMPort werden eine oder mehrere Eigenschaften eines COM-Ports (Virtual Communications) geändert. Ein virtueller COM-Port ist Teil eines virtuellen Computers, einer VM-Vorlage oder eines Hardwareprofils, das in einer Virtual Machine Manager (VMM)-Umgebung verwendet wird. Geben Sie mithilfe des Parameters VirtualCOMPort einen COM-Port an, oder geben Sie eine virtuelle COM-Port-ID für den Parameter GuestPort an. Gültige Werte für GuestPort sind null (0) und eins (1).

Mit diesem Cmdlet kann ein virtueller COM-Port mit einem physischen COM-Port, mit einer Textdatei oder mit einer Named Pipe verbunden werden. Mit diesem Cmdlet kann ein virtueller COM-Port getrennt werden. 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 die Ein- und Ausgabe verwenden. Die Hosttypen unterstützen die folgenden Verbindungstypen für virtuelle COM-Ports:

• Hyper-V. Stellt nur eine Verbindung zu einer Named Pipe her.
• VMware ESX. Stellt eine Verbindung zu einem physischen COM-Port, einer Textdatei oder einer Named Pipe her.
• Citrix XenServer. Nicht unterstützt.

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

Wenn Sie den Wert $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. Wenn der COM-Port auf dem Host bereits verbunden ist, kann der virtuelle Computer keine Verbindung mit ihm herstellen. Wenn der virtuelle Computer erfolgreich eine Verbindung mit dem physischen COM-Port herstellt, gibt der virtuelle Computer den physischen COM-Port später wieder für das Hostbetriebssystem frei, wenn das Programm auf dem virtuellen Computer, der den COM-Port verwendet, den COM-Port nicht mehr verwendet.

Wenn Sie den Wert $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 ist, kann der virtuelle Computer keine Verbindung mit ihm 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, gibt der virtuelle Computer den physischen COM-Port erst wieder für das Hostbetriebssystem frei, wenn der virtuelle Computer heruntergefahren wird.

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 mit dem Namen VM02 ab und speichert dieses Objekt dann in der Variablen $VM.

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

Mit dem letzten Befehl wird der virtuelle COM-Port in $COM 1 mit der Named Pipe \Contoso\Pipe\PipeName verbunden.

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 mit dem Namen VM04 ab und speichert dieses Objekt dann in der Variablen $VM.

Der zweite Befehl ruft den virtuellen COM-Port auf VM04 mit dem Namen COM1 ab und speichert dieses Objekt dann in der Variablen $COM 1.

Der letzte Befehl gibt den Parameter NoAttach an. Dies führt dazu, dass der Befehl den virtuellen COM-Port in $COM 1 trennt. Mit diesem Befehl können Sie einen virtuellen COM-Port trennen, der derzeit mit einem physischen COM-Port auf einem Host, mit einer Named Pipe oder mit einer Textdatei verbunden ist.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Dieses Cmdlet gibt ein VirtualCOMPort-Objekt zurück.

• Erfordert ein virtuelles VMM-COM-Portobjekt. Sie können dieses Objekt mit dem Cmdlet Get-SCVirtualCOMPort abrufen.