Set-SCVirtualCOMPort
Ändrar egenskaper för en virtuell COM-port för en virtuell dator, mall för virtuella datorer eller maskinvaruprofil.
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
Cmdleten Set-SCVirtualCOMPort ändrar en eller flera egenskaper för en COM-port (virtual communications). En virtuell COM-port är en del av en virtuell dator, mall för virtuella datorer eller maskinvaruprofil som används i en VMM-miljö (Virtual Machine Manager). Ange en COM-port med hjälp av parametern VirtualCOMPort eller ange ett virtuellt COM-port-ID för parametern GuestPort . Giltiga värden för GuestPort är noll (0) och en (1).
Den här cmdleten kan ansluta en virtuell COM-port till en fysisk COM-port, till en textfil eller till en namngiven pipe. Den här cmdleten kan koppla från en virtuell COM-port. Om du ansluter en virtuell COM-port på en virtuell dator till en fysisk COM-port på värden kan den virtuella datorn använda den fysiska COM-porten för indata och utdata. Värdtyperna stöder följande anslutningstyper för virtuell COM-port:
- Hyper-V. Ansluter endast till ett namngivet rör.
- VMware ESX. Ansluter till en fysisk COM-port, textfil eller namngiven pipe.
- Citrix XenServer. Stöds inte.
Parametern WaitForModem anger om en virtuell COM-port på en virtuell dator ansluter direkt till en fysisk COM-port på värden när den virtuella datorn startar.
Om du anger värdet $True för WaitForModem försöker den virtuella datorn ansluta till den fysiska COM-porten på värden endast om ett program som körs på den virtuella datorn skickar ett modemkommando till den fysiska COM-porten. Om COM-porten på värden redan är ansluten kan den virtuella datorn inte ansluta till den. Om den virtuella datorn ansluter till den fysiska COM-porten släpper den virtuella datorn senare den fysiska COM-porten tillbaka till värdoperativsystemet om programmet på den virtuella datorn som använder COM-porten slutar använda COM-porten.
Om du anger värdet $False för WaitForModem försöker den virtuella datorn ansluta till den fysiska COM-porten på värden så snart den virtuella datorn startar. Om COM-porten på värden redan har registrerats kan den virtuella datorn inte ansluta till den. Det här är samma beteende som för värdet $True. Om den virtuella datorn ansluter till den fysiska COM-porten släpper den virtuella datorn inte tillbaka den fysiska COM-porten till värdoperativsystemet förrän den virtuella datorn har stängts av.
Exempel
Exempel 1: Ansluta en virtuell COM-port till en namngiven pipe
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"Det första kommandot hämtar den virtuella datorn med namnet VM02 och lagrar sedan objektet i variabeln $VM.
Det andra kommandot hämtar den virtuella COM-porten med namnet COM1 från VM02 och lagrar sedan objektet i variabeln $COM 1.
Det sista kommandot ansluter den virtuella COM-porten i $COM 1 till den namngivna pipe \Contoso\Pipe\PipeName.
Exempel 2: Koppla från en virtuell COM-port
PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $COM1 = Get-SCVirtualCOMPort -VM $VM | where {$_.Name -eq "COM1"}
PS C:\> Set-SCVirtualCOMPort -VirtualCOMPort $COM1 -NoAttachDet första kommandot hämtar den virtuella datorn med namnet VM04 och lagrar sedan objektet i variabeln $VM.
Det andra kommandot hämtar den virtuella COM-porten på VM04 med namnet COM1 och lagrar sedan objektet i variabeln $COM 1.
Det sista kommandot anger parametern NoAttach . Detta gör att kommandot kopplar från den virtuella COM-porten i $COM 1. Du kan använda det här kommandot för att koppla från en virtuell COM-port som för närvarande är ansluten till en fysisk COM-port på en värd, till en namngiven pipe eller till en textfil.
Parametrar
-GuestPort
Anger ID för en virtuell COM-port på en virtuell dator. Giltiga värden är: 0 och 1.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-JobGroup
Anger en identifierare för en serie kommandon som körs som en uppsättning precis innan det slutliga kommandot som innehåller samma jobbgruppsidentifierare körs.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Anger en variabel där jobbstatus spåras och lagras.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NamedPipe
Anger en namngiven pipe som en virtuell COM-port ansluter till. Vanliga användningsområden är att ansluta en virtuell dator till ett felsökningsprogram på värden. Du kan också skapa en virtuell null-modemkabel mellan två virtuella datorer. Ange en pipe i följande format: \.\ComputerName\Pipe\PipeName
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoAttach
Anger att denna cmdlet anger att ingen fysisk COM-port på en värd, med namnet pipe eller fil ansluter till en virtuell COM-port. Om du anger den här parametern kopplar cmdleten från en virtuell COM-port som redan är ansluten till en fysisk COM-port, till en namngiven pipe eller till en textfil.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Anger ID för tipset Prestanda- och resursoptimering (PRO) som utlöste den här åtgärden. På så sätt kan du granska PRO-tips.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Anger att jobbet körs asynkront så att kontrollen återgår till kommandogränssnittet omedelbart.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TextFile
Anger en textfil på värden som den virtuella COM-porten ansluter till. Den virtuella datorn skickar utdata från den virtuella COM-porten som textfilen som den här parametern anger. Textfilen kan finnas på valfri giltig diskenhet på värden.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualCOMPort
Anger ett virtuellt COM-portobjekt som den här cmdleten ändrar. VMM stöder konfiguration av två COM-portar på en virtuell dator, mall eller maskinvaruprofil.
| Type: | VirtualCOMPort |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMHostCOMPort
Anger ett fysiskt COM-portobjekt på en värdserver som den virtuella datorn kan ansluta en virtuell COM-port till.
| Type: | Byte |
| Aliases: | HostPort |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Anger en VMM-server.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WaitForModem
Anger om en virtuell COM-port på en virtuell dator ansluter direkt till en fysisk COM-port på värden när den virtuella datorn startas.
Om du anger värdet $True väntar den virtuella COM-porten på att ansluta till en fysisk COM-port på värden. Om du anger värdet $False ansluter den virtuella COM-porten omedelbart till en fysisk COM-port på värden så snart den virtuella datorn startar.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Utdata
VirtualCOMPort
Den här cmdleten returnerar ett VirtualCOMPort-objekt .
Kommentarer
- Kräver ett VMM-portobjekt för virtuell COM. Du kan hämta det här objektet med cmdleten Get-SCVirtualCOMPort .