Share via

Read-SCVirtualMachine

  • Référence
Module:
VirtualMachineManager

Actualise les propriétés d’une machine virtuelle afin que la console VMM affiche des informations mises à jour sur la machine virtuelle.

Syntax

Read-SCVirtualMachine
    [-VM] <VM>
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Read-SCVirtualMachine
    [-VMHost] <Host>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Description

L’applet de commande Read-SCVirtualMachine met à jour les propriétés d’une machine virtuelle afin que la console Virtual Machine Manager (VMM) affiche des informations mises à jour sur la machine virtuelle. Les propriétés mises à jour incluent Name, Status, Host, Owner, CPUAverage, Service, OperatingSystem et autres propriétés.

Exemples

Exemple 1 : Actualiser des informations sur une machine virtuelle spécifique

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Read-SCVirtualMachine -VM $VM

La première commande obtient l’objet de machine virtuelle nommé VM01, puis stocke cet objet dans la variable $VM.

La deuxième commande met à jour les propriétés de la machine virtuelle stockée dans $VM. Une fois cette commande terminée, elle affiche les informations actuelles sur cette machine virtuelle.

Exemple 2 : Actualiser toutes les machines virtuelles sur les hôtes dont le nom correspond à la chaîne spécifiée

PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Where-Object { $_.VMHost.Name -Match "VMM" }
PS C:\> $VMs | Read-SCVirtualMachine

La première commande obtient tous les objets de machine virtuelle de VMMServer01 déployés sur les hôtes dont le nom contient la chaîne VMM, puis stocke ces objets de machine virtuelle dans le tableau $VMs.

La deuxième commande met à jour les propriétés de chaque objet de machine virtuelle stockée dans $VMs.

Paramètres

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-JobVariable

Spécifie une variable dans laquelle la progression du travail est suivie et stockée.

Type:String
Position:Named
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

-PROTipID

Spécifie l’ID du conseil d’optimisation des performances et des ressources qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.

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

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-VM

Spécifie un objet ordinateur virtuel.

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

Sorties

VirtualMachine

Notes

  • Cette applet de commande nécessite un objet de machine virtuelle, qui peut être récupéré à l’aide de l’applet de commande Get-SCVirtualMachine .