Partager via

Get-SCVirtualCOMPort

  • Référence
Module:
VirtualMachineManager

Obtient un port COM virtuel à partir d’une machine virtuelle, d’un modèle de machine virtuelle ou d’un profil matériel.

Syntaxe

Get-SCVirtualCOMPort
   [-VMMServer <ServerConnection>]
   [-All]
   [<CommonParameters>]
Get-SCVirtualCOMPort
   -HardwareProfile <HardwareProfile>
   [<CommonParameters>]
Get-SCVirtualCOMPort
   -VM <VM>
   [<CommonParameters>]
Get-SCVirtualCOMPort
   -VMTemplate <Template>
   [<CommonParameters>]

Description

La cmdlet get-SCVirtualCOMPort 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 se connecter à un port physique sur un serveur hôte de machine virtuelle, à 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 $VM

La 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 $VMTemplate

La 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 $HWProfile

La 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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-HardwareProfile

Spécifie un objet de profil matériel.

Type:HardwareProfile
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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 get-SCVMTemplate.

Type:Template
Alias:Template
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Sorties

VirtualCOMPort

Cette applet de commande retourne un objet VirtualCOMPort.