Partager via

Update-SCVMConfiguration

  • Référence
Module:
VirtualMachineManager

Met à jour les propriétés d’un objet de configuration de machine virtuelle VMM.

Syntaxe

Update-SCVMConfiguration
      [-VMConfiguration] <BaseVMConfiguration>
      [-ValidateOnly <Boolean>]
      [-VMName <String>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Update-SCVMConfiguration
      -VMConfigurationList <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.BaseVMConfiguration]>
      [-ValidateOnly <Boolean>]
      [-VMName <String>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

L’applet de commande Update-SCVMConfiguration met à jour les propriétés d’un objet de configuration de machine virtuelle VMM (Virtual Machine Manager).

Exemples

Exemple 1 : Mettre à jour une configuration de machine virtuelle existante

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $VMConfig = Get-SCVMConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> Update-SCVMConfiguration -VMConfiguration $VMConfig[0] -ValidateOnly $True

La première commande obtient l’objet de configuration de service nommé Service01 à partir de la bibliothèque VMM et stocke l’objet dans la variable $ServiceConfig.

La deuxième commande obtient l’objet de configuration de machine virtuelle pour la configuration de service stockée dans $ServiceConfig et stocke l’objet de configuration de machine virtuelle dans $VMConfig.

La dernière commande définit la propriété ValidateOnly sur True pour le premier objet de configuration stocké dans $VMConfig.

Paramètres

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

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

-OnBehalfOfUser

Spécifie le nom d’un utilisateur. Cette applet de commande définit le compte de l’utilisateur en tant qu’utilisateur spécifié par ce paramètre.

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. Cette applet de commande définit le rôle d’utilisateur pour le compte de l’utilisateur comme rôle d’utilisateur spécifié par ce paramètre. Pour obtenir un objet de rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole.

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

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

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

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-ValidateOnly

Indique si la validation du placement est effectuée, mais que le placement n’est pas réellement effectué.

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

-VMConfiguration

Spécifie un objet de configuration de machine virtuelle.

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

-VMConfigurationList

Spécifie une liste d’objets de configuration.

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.BaseVMConfiguration]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMName

Spécifie le nom d’une machine virtuelle à placer sur un serveur hôte physique. Utilisez ce paramètre pour vérifier qu’une autre machine virtuelle portant le même nom n’est pas déjà déployée sur cet hôte.

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

Sorties

ComputerConfig

Cette applet de commande retourne un objet ComputerConfig.

Notes

  • Nécessite un objet de configuration de machine virtuelle VMM, qui peut être obtenu à l’aide de l’applet de commande get-SCVMConfiguration .