Partager via

Get-SCVirtualMachine

  • Référence
Module:
VirtualMachineManager

Obtient des objets de machine virtuelle.

Syntax

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 obtient un ou plusieurs objets de machine virtuelle à partir de la base de données VMM (Virtual Machine Manager). Cette applet de commande obtient des 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é 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épendants 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 modèle auquel chaque objet de lecteur de disque virtuel est associé.

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

-Cloud

Spécifie un objet de cloud privé.

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

-ComputerTier

Spécifie un objet de niveau ordinateur.

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

-ID

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

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

-Name

Spécifie le nom d’un objet VMM.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Service

Spécifie un objet de service VMM.

Type:Service
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHost

Spécifie un objet ordinateur hôte d’ordinateur virtuel. 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
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

Sorties

VirtualMachine

Cette applet de commande retourne un objet VirtualMachine .