Bagikan melalui

Set-SCVirtualCOMPort

  • Referensi
Modul:
VirtualMachineManager

Memodifikasi properti port COM virtual untuk komputer virtual, templat komputer virtual, atau profil perangkat keras.

Sintaks

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

Deskripsi

Cmdlet Set-SCVirtualCOMPort memodifikasi satu atau beberapa properti port komunikasi virtual (COM). Port COM virtual adalah bagian dari komputer virtual, templat komputer virtual, atau profil perangkat keras yang digunakan di lingkungan Virtual Machine Manager (VMM). Tentukan port COM dengan menggunakan parameter VirtualCOMPort atau tentukan ID port COM virtual untuk parameter GuestPort . Nilai yang valid untuk GuestPort adalah nol (0) dan satu (1).

Cmdlet ini dapat menyambungkan port COM virtual ke port COM fisik, ke file teks, atau ke pipa bernama. Cmdlet ini dapat memutuskan sambungan port COM virtual. Jika Anda menyambungkan port COM virtual pada komputer virtual ke port COM fisik pada host-nya, komputer virtual dapat menggunakan port COM fisik untuk input dan output. Jenis host mendukung jenis koneksi port COM virtual berikut:

  • Hyper-V. Menyambungkan ke pipa bernama saja.
  • VMware ESX. Menyambungkan ke port COM fisik, file teks, atau pipa bernama.
  • Citrix XenServer. Tidak didukung.

Parameter WaitForModem menentukan apakah port COM virtual pada komputer virtual langsung terhubung ke port COM fisik pada host saat komputer virtual dimulai.

Jika Anda menentukan nilai $True untuk WaitForModem, komputer virtual mencoba untuk terhubung ke port COM fisik pada host hanya jika program yang berjalan pada komputer virtual mengirim perintah modem ke port COM fisik. Jika port COM pada host sudah tersambung, komputer virtual tidak dapat tersambung ke host tersebut. Jika komputer virtual berhasil terhubung ke port COM fisik, komputer virtual kemudian merilis port COM fisik kembali ke sistem operasi host jika program pada komputer virtual yang menggunakan port COM berhenti menggunakan port COM.

Jika Anda menentukan nilai $False untuk WaitForModem, komputer virtual mencoba terhubung ke port COM fisik pada host segera setelah komputer virtual dimulai. Jika port COM pada host sudah ditangkap, komputer virtual tidak dapat tersambung ke host tersebut. Ini adalah perilaku yang sama seperti untuk nilai $True. Jika komputer virtual berhasil terhubung ke port COM fisik, komputer virtual tidak merilis port COM fisik kembali ke sistem operasi host sampai komputer virtual dimatikan.

Contoh

Contoh 1: Menyambungkan port COM virtual ke pipa bernama

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"

Perintah pertama mendapatkan komputer virtual bernama VM02, lalu menyimpan objek tersebut dalam variabel $VM.

Perintah kedua mendapatkan port COM virtual bernama COM1 dari VM02, lalu menyimpan objek tersebut dalam variabel $COM 1.

Perintah terakhir menyambungkan port COM virtual di $COM 1 ke pipe \Contoso\Pipe\PipeName yang bernama.

Contoh 2: Memutuskan sambungan port COM virtual

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

Perintah pertama mendapatkan komputer virtual bernama VM04, lalu menyimpan objek tersebut dalam variabel $VM.

Perintah kedua mendapatkan port COM virtual pada VM04 bernama COM1, lalu menyimpan objek tersebut dalam variabel $COM 1.

Perintah terakhir menentukan parameter NoAttach . Ini menyebabkan perintah memutuskan sambungan port COM virtual di $COM 1. Anda dapat menggunakan perintah ini untuk memutuskan sambungan port COM virtual yang saat ini terhubung ke port COM fisik pada host, ke pipa bernama, atau ke file teks.

Parameter

-GuestPort

Menentukan ID port COM virtual pada komputer virtual. Nilai yang valid adalah: 0 dan 1.

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

-JobGroup

Menentukan pengidentifikasi untuk serangkaian perintah yang berjalan sebagai set tepat sebelum perintah akhir yang menyertakan pengidentifikasi grup pekerjaan yang sama berjalan.

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

-JobVariable

Menentukan variabel tempat kemajuan pekerjaan dilacak dan disimpan.

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

-NamedPipe

Menentukan pipa bernama tempat port COM virtual tersambung. Penggunaan umum termasuk menghubungkan komputer virtual ke program penelusuran kesalahan pada host. Anda juga dapat membuat kabel modem null virtual antara dua komputer virtual. Tentukan pipa dalam format berikut: \.\ComputerName\Pipe\PipeName

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

-NoAttach

Menunjukkan bahwa cmdlet ini menentukan bahwa tidak ada port COM fisik pada host, pipa bernama, atau file yang terhubung ke port COM virtual. Jika Anda menentukan parameter ini, cmdlet memutuskan sambungan port COM virtual yang sudah tersambung ke port COM fisik, ke pipa bernama, atau ke file teks.

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

-PROTipID

Menentukan ID tip Performa dan Pengoptimalan Sumber Daya (PRO) yang memicu tindakan ini. Ini memungkinkan audit tips PRO.

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

-RunAsynchronously

Menunjukkan bahwa pekerjaan berjalan secara asinkron sehingga kontrol segera kembali ke shell perintah.

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

-TextFile

Menentukan file teks pada host tempat port COM virtual tersambung. Komputer virtual mengirim output dari port COM virtual file teks yang ditentukan parameter ini. File teks dapat berada di drive disk yang valid pada host.

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

-VirtualCOMPort

Menentukan objek port COM virtual yang dimodifikasi cmdlet ini. VMM mendukung konfigurasi dua port COM pada komputer virtual, templat, atau profil perangkat keras.

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

-VMHostCOMPort

Menentukan objek port COM fisik pada server host tempat komputer virtual dapat menyambungkan port COM virtual.

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

-VMMServer

Menentukan server VMM.

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

-WaitForModem

Menunjukkan apakah port COM virtual pada komputer virtual segera terhubung ke port COM fisik pada host saat komputer virtual dimulai.

Jika Anda menentukan nilai $True, port COM virtual menunggu untuk terhubung ke port COM fisik pada host. Jika Anda menentukan nilai $False, port COM virtual segera terhubung ke port COM fisik pada host segera setelah komputer virtual dimulai.

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

Output

VirtualCOMPort

Cmdlet ini mengembalikan objek VirtualCOMPort .

Catatan

  • Memerlukan objek port COM virtual VMM. Anda dapat mengambil objek ini dengan menggunakan cmdlet Get-SCVirtualCOMPort .