Get-SCVirtualCOMPort
Obtient un port COM virtuel à partir d’une machine virtuelle, d’un modèle de machine virtuelle ou d’un profil matériel.
Syntax
Get-SCVirtualCOMPort
[-VMMServer <ServerConnection>]
[-All]
[<CommonParameters>] Get-SCVirtualCOMPort
-HardwareProfile <HardwareProfile>
[<CommonParameters>] Get-SCVirtualCOMPort
-VM <VM>
[<CommonParameters>] Get-SCVirtualCOMPort
-VMTemplate <Template>
[<CommonParameters>] Description
L’applet de commande Get-SCVirtualCOMPort obtient des objets de port de communication virtuelle (COM). Cette applet de commande obtient un ou les deux ports COM à partir d’un objet de machine virtuelle, d’un objet de modèle de machine virtuelle ou d’un objet de profil matériel que Virtual Machine Manager (VMM) gère.
Un port COM virtuel peut établir une connexion à un port physique sur le serveur hôte d’un ordinateur virtuel, à un fichier texte ou à un canal nommé. Chaque machine virtuelle, modèle de machine virtuelle et profil matériel contient exactement deux ports COM.
Exemples
Exemple 1 : Obtenir des ports COM pour une machine virtuelle
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualCOMPort -VM $VMLa première commande obtient la machine virtuelle nommée VM01, puis stocke cet objet dans la variable $VM.
La deuxième commande obtient les objets de port COM virtuels sur VM01 et affiche des informations sur ces ports.
Exemple 2 : Obtenir des ports COM pour un modèle
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualCOMPort -VMTemplate $VMTemplateLa première commande obtient le modèle de machine virtuelle nommé VMTemplate01, puis stocke cet objet dans la variable $VMTemplate.
La deuxième commande obtient les objets de port COM virtuels pour VMTemplate01 et affiche des informations sur ces ports.
Exemple 3 : Obtenir des ports COM pour un profil matériel
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualCOMPort -HardwareProfile $HWProfileLa première commande obtient le profil matériel nommé NewHWProfile01, puis stocke cet objet dans la variable $HWProfile.
La deuxième commande obtient les objets de port COM virtuels pour NewHWProfile01 et affiche des informations sur ces ports.
Paramètres
-All
Indique que cette applet de commande obtient une liste complète des ports COM subordonnés indépendamment de l’objet parent.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HardwareProfile
Spécifie un objet profil matériel.
| Type: | HardwareProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VM
Spécifie une machine virtuelle pour laquelle cette applet de commande obtient des ports COM virtuels. Pour obtenir un objet de machine virtuelle, utilisez l’applet de commande Get-SCVirtualMachine .
| Type: | VM |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
Spécifie un objet serveur VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMTemplate
Spécifie un modèle VMM utilisé pour créer des machines virtuelles pour lesquelles cette applet de commande obtient des ports COM virtuels. Pour obtenir un objet de modèle VMM, utilisez l’applet de commande Get-SCVMTemplate .
| Type: | Template |
| Aliases: | Template |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Sorties
VirtualCOMPort
Cette applet de commande retourne un objet VirtualCOMPort .