Partager via

Get-SCVirtualMachine

  • Référence
Module:
VirtualMachineManager

Obtient des objets de machine virtuelle.

Syntaxe

Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   -VMHost <Host>
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -Cloud <Cloud>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -Service <Service>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -ComputerTier <ComputerTier>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -StorageQoSPolicy <StorageQoSPolicy>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande get-SCVirtualMachine get-SCVirtualMachine obtient un ou plusieurs objets de machine virtuelle à partir de la base de données Virtual Machine Manager (VMM). Cette applet de commande obtient les machines virtuelles déployées sur un hôte de machine virtuelle ou stockées dans la bibliothèque VMM.

Exemples

Exemple 1 : Obtenir toutes les machines virtuelles et afficher des informations sur chacune d’elles

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com"

Cette commande obtient tous les objets de machine virtuelle sur VMMServer01 et affiche des informations sur ces objets de machine virtuelle.

Exemple 2 : Obtenir toutes les machines virtuelles et afficher des informations sur des propriétés spécifiques

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Format-List -Property Name, Owner, Description, HostName, OperatingSystem, CPUCount, Memory

Cette commande obtient tous les objets de machine virtuelle sur VMMServer01 et affiche les valeurs des propriétés spécifiées.

Exemple 3 : Obtenir une machine virtuelle par nom stockée sur un serveur de bibliothèque spécifié

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Get-SCVirtualMachine | Where-Object { $_.Name -Eq "VM02" -And $_.LibraryServer -Eq "LibraryServer01" } | Select-Object Name,LibraryServer,Status

La première commande se connecte à VMMServer01.

La deuxième commande obtient l’objet de machine virtuelle nommé VM02 stocké sur LibraryServer01, puis affiche le nom de la machine virtuelle, le nom du serveur de bibliothèque et l’état de la machine virtuelle.

Exemple 4 : Obtenir toutes les machines virtuelles sur l’hôte spécifié

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Get-SCVirtualMachine -VMHost "VMHost01.Contoso.com"

La première commande se connecte à VMMServer01.

La deuxième commande obtient tous les objets de machine virtuelle déployés sur VMHost01 et affiche des informations sur ces machines virtuelles.

Paramètres

-All

Indique que cette applet de commande obtient tous les objets subordonnés indépendamment de l’objet parent. Par exemple, la commande Get-SCVirtualDiskDrive -All obtient tous les objets de lecteur de disque virtuel, quel que soit l’objet de machine virtuelle ou l’objet de modèle auquel chaque objet de lecteur de disque virtuel est associé.

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

-Cloud

Spécifie un objet de cloud privé.

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

-ComputerTier

Spécifie un objet de niveau ordinateur.

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

-ID

Spécifie l’ID unique d’un objet.

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

-Name

Spécifie le nom d’un objet VMM.

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

-OnBehalfOfUser

Spécifie un nom d’utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur que ce paramètre spécifie.

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

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet Get-SCUserRole. Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

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

-Service

Spécifie un objet de service VMM.

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

-StorageQoSPolicy

Spécifie la stratégie Qualité de service (QoS) pour les machines virtuelles que cette applet de commande obtient.

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

-VMHost

Spécifie un objet hôte de machine virtuelle. VMM prend en charge les hôtes Hyper-V, les hôtes VMware ESX et les hôtes Citrix XenServer.

Pour plus d’informations sur chaque type d’hôte, consultez l’applet de commande Add-SCVMHost .

Type:Host
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

Sorties

VirtualMachine

Cette applet de commande retourne un objet VirtualMachine.