Get-SCVirtualCOMPort
Lekér egy virtuális COM-portot egy virtuális gépről, egy virtuálisgép-sablonból vagy egy hardverprofilból.
Syntax
Get-SCVirtualCOMPort
[-VMMServer <ServerConnection>]
[-All]
[<CommonParameters>]
Get-SCVirtualCOMPort
-HardwareProfile <HardwareProfile>
[<CommonParameters>]
Get-SCVirtualCOMPort
-VM <VM>
[<CommonParameters>]
Get-SCVirtualCOMPort
-VMTemplate <Template>
[<CommonParameters>]
Description
A Get-SCVirtualCOMPort parancsmag lekéri a virtuális kommunikációs (COM) portobjektumokat. Ez a parancsmag egy vagy mindkét COM-portot lekér egy virtuálisgép-objektumból, egy virtuálisgép-sablonobjektumból vagy egy hardverprofil-objektumból, amelyet a Virtual Machine Manager (VMM) felügyel.
A virtuális COM-portok csatlakozhatnak egy virtuálisgép-gazdakiszolgáló fizikai portjához, egy szövegfájlhoz vagy egy elnevezett csőhöz. Minden virtuális gép, virtuálisgép-sablon és hardverprofil pontosan két COM-portot tartalmaz.
Példák
1. példa: COM-portok lekérése virtuális géphez
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualCOMPort -VM $VM
Az első parancs lekéri a VM01 nevű virtuális gépet, majd az objektumot a $VM változóban tárolja.
A második parancs lekéri a virtuális COM-port objektumait a VM01-en, és megjeleníti a portokkal kapcsolatos információkat.
2. példa: COM-portok lekérése sablonhoz
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualCOMPort -VMTemplate $VMTemplate
Az első parancs lekéri a VMTemplate01 nevű virtuálisgép-sablont, majd az objektumot a $VMTemplate változóban tárolja.
A második parancs lekéri a VMTemplate01 virtuális COM-portobjektumait, és megjeleníti a portokkal kapcsolatos információkat.
3. példa: COM-portok lekérése hardverprofilhoz
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualCOMPort -HardwareProfile $HWProfile
Az első parancs lekéri a NewHWProfile01 nevű hardverprofilt, majd az objektumot a $HWProfile változóban tárolja.
A második parancs lekéri a NewHWProfile01 virtuális COM-portobjektumait, és megjeleníti a portokkal kapcsolatos információkat.
Paraméterek
-All
Azt jelzi, hogy ez a parancsmag lekéri az alárendelt COM-portok teljes listáját a szülőobjektumtól függetlenül.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HardwareProfile
Hardverprofil-objektumot ad meg.
Type: | HardwareProfile |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VM
Megadja azt a virtuális gépet, amelyhez ez a parancsmag virtuális COM-portokat kap. Virtuálisgép-objektum beszerzéséhez használja a Get-SCVirtualMachine parancsmagot.
Type: | VM |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMMServer
VMM-kiszolgálóobjektumot ad meg.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMTemplate
Olyan VMM-sablont ad meg, amely virtuális gépek létrehozására szolgál, amelyekhez ez a parancsmag virtuális COM-portokat kap. VMM-sablonobjektum beszerzéséhez használja a Get-SCVMTemplate parancsmagot.
Type: | Template |
Aliases: | Template |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Kimenetek
VirtualCOMPort
Ez a parancsmag egy VirtualCOMPort objektumot ad vissza.