Share via

Set-SCVirtualCOMPort

  • Başvuru
Modül:
VirtualMachineManager

Sanal makine, sanal makine şablonu veya donanım profili için sanal COM bağlantı noktasının özelliklerini değiştirir.

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

Set-SCVirtualCOMPort cmdlet'i bir sanal iletişim (COM) bağlantı noktasının bir veya daha fazla özelliğini değiştirir. Sanal COM bağlantı noktası, Virtual Machine Manager (VMM) ortamında kullanılan bir sanal makine, sanal makine şablonu veya donanım profilinin parçasıdır. VirtualCOMPort parametresini kullanarak bir COM bağlantı noktası belirtin veya GuestPort parametresi için bir sanal COM bağlantı noktası kimliği belirtin. GuestPort için geçerli değerler sıfır (0) ve bir (1) değerleridir.

Bu cmdlet bir sanal COM bağlantı noktasını fiziksel bir COM bağlantı noktasına, bir metin dosyasına veya adlandırılmış kanala bağlayabilir. Bu cmdlet bir sanal COM bağlantı noktasının bağlantısını kesebilir. Sanal makinedeki bir sanal COM bağlantı noktasını konağındaki fiziksel bir COM bağlantı noktasına bağlarsanız, sanal makine giriş ve çıkış için fiziksel COM bağlantı noktasını kullanabilir. Konak türleri aşağıdaki sanal COM bağlantı noktası bağlantı türlerini destekler:

  • Hyper-V. Yalnızca adlandırılmış kanala bağlanır.
  • VMware ESX. Fiziksel com bağlantı noktasına, metin dosyasına veya adlandırılmış kanala bağlanır.
  • Citrix XenServer. Desteklenmiyor.

WaitForModem parametresi, sanal makine başlatıldığında bir sanal makinedeki sanal COM bağlantı noktasının konak üzerindeki fiziksel com bağlantı noktasına hemen bağlanıp bağlanmayacağını belirtir.

WaitForModem için $True değeri belirtirseniz, sanal makine yalnızca sanal makinede çalışan bir program fiziksel COM bağlantı noktasına modem komutu gönderdiğinde konak üzerindeki fiziksel COM bağlantı noktasına bağlanmaya çalışır. Konak üzerindeki COM bağlantı noktası zaten bağlıysa, sanal makine buna bağlanamaz. Sanal makine fiziksel COM bağlantı noktasına başarıyla bağlanırsa, COM bağlantı noktasını kullanan sanal makinedeki program COM bağlantı noktasını kullanmayı durdurursa, sanal makine daha sonra fiziksel COM bağlantı noktasını konak işletim sistemine geri bırakır.

WaitForModem için $False değeri belirtirseniz, sanal makine başlatılır başlatılmaz konak üzerindeki fiziksel COM bağlantı noktasına bağlanmayı dener. Konak üzerindeki COM bağlantı noktası zaten yakalanmışsa, sanal makine buna bağlanamaz. Bu, $True değeriyle aynı davranıştır. Sanal makine fiziksel COM bağlantı noktasına başarıyla bağlanırsa, sanal makine kapatana kadar fiziksel COM bağlantı noktasını konak işletim sistemine geri bırakmaz.

Örnekler

Örnek 1: Sanal com bağlantı noktasını adlandırılmış kanala bağlama

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"

İlk komut VM02 adlı sanal makineyi alır ve ardından bu nesneyi $VM değişkeninde depolar.

İkinci komut, VM02'den COM1 adlı sanal COM bağlantı noktasını alır ve ardından bu nesneyi $COM 1 değişkeninde depolar.

Son komut, $COM 1'deki sanal COM bağlantı noktasını \Contoso\Pipe\PipeName adlı kanala bağlar.

Örnek 2: Sanal COM bağlantı noktasının bağlantısını kesme

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

İlk komut VM04 adlı sanal makineyi alır ve ardından bu nesneyi $VM değişkeninde depolar.

İkinci komut, VM04'te COM1 adlı sanal COM bağlantı noktasını alır ve ardından bu nesneyi $COM 1 değişkeninde depolar.

Son komut NoAttach parametresini belirtir. Bu, komutun $COM 1'deki sanal COM bağlantı noktasının bağlantısını kesmesine neden olur. Bir konakta fiziksel COM bağlantı noktasına, adlandırılmış kanala veya metin dosyasına bağlı olan bir sanal COM bağlantı noktasının bağlantısını kesmek için bu komutu kullanabilirsiniz.

Parametreler

-GuestPort

Bir sanal makinedeki sanal COM bağlantı noktasının kimliğini belirtir. Geçerli değerler şunlardır: 0 ve 1.

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

-JobGroup

Aynı iş grubu tanımlayıcısını içeren son komutun çalıştırılmasından hemen önce küme olarak çalışan bir dizi komut için tanımlayıcı belirtir.

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

-JobVariable

İş ilerleme durumunun izlendiği ve depolandığı bir değişken belirtir.

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

-NamedPipe

Sanal COM bağlantı noktasının bağlandığı adlandırılmış kanalı belirtir. Tipik kullanımlar, bir sanal makineyi konak üzerindeki bir hata ayıklama programına bağlamayı içerir. İki sanal makine arasında sanal null modem kablosu da oluşturabilirsiniz. Şu biçimde bir kanal belirtin: \.\ComputerName\Pipe\PipeName

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

-NoAttach

Bu cmdlet'in bir konakta, adlandırılmış kanalda veya dosyada sanal COM bağlantı noktasına fiziksel COM bağlantı noktası bağlanılmayacağını belirttiğini belirtir. Bu parametreyi belirtirseniz, cmdlet fiziksel COM bağlantı noktasına, adlandırılmış kanala veya metin dosyasına zaten bağlı olan bir sanal COM bağlantı noktasının bağlantısını keser.

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

-PROTipID

Bu eylemi tetikleyen Performans ve Kaynak İyileştirme (PRO) ipucunun kimliğini belirtir. Bu, PRO ipuçlarının denetlenmesini sağlar.

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

-RunAsynchronously

Denetimin komut kabuğuna hemen döndürülmesi için işin zaman uyumsuz olarak çalıştığını gösterir.

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

-TextFile

Sanal COM bağlantı noktasının bağlandığı konakta bir metin dosyası belirtir. Sanal makine, sanal COM bağlantı noktasından bu parametrenin belirttiği metin dosyasının çıkışını gönderir. Metin dosyası konak üzerindeki herhangi bir geçerli disk sürücüsünde olabilir.

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

-VirtualCOMPort

Bu cmdlet'in değiştirildiği sanal bir COM bağlantı noktası nesnesi belirtir. VMM, bir sanal makine, şablon veya donanım profilinde iki COM bağlantı noktası yapılandırmayı destekler.

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

-VMHostCOMPort

Sanal makinenin bir sanal COM bağlantı noktasına bağlanabileceği bir konak sunucusundaki fiziksel com bağlantı noktası nesnesini belirtir.

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

-VMMServer

Bir VMM sunucusu belirtir.

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

-WaitForModem

Bir sanal makinedeki sanal COM bağlantı noktasının, sanal makine başlatıldığında konak üzerindeki fiziksel bir COM bağlantı noktasına hemen bağlanıp bağlanmadığını gösterir.

$True değerini belirtirseniz, sanal COM bağlantı noktası konakta fiziksel bir COM bağlantı noktasına bağlanmak için bekler. $False değerini belirtirseniz, sanal COM bağlantı noktası sanal makine başlatılır başlatılmaz konak üzerindeki fiziksel bir COM bağlantı noktasına hemen bağlanır.

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

Çıkışlar

VirtualCOMPort

Bu cmdlet bir VirtualCOMPort nesnesi döndürür.

Notlar

  • VMM sanal COM bağlantı noktası nesnesi gerektirir. Get-SCVirtualCOMPort cmdlet'ini kullanarak bu nesneyi alabilirsiniz.