Partager via

Set-SCVMConfiguration

  • Référence
Module:
VirtualMachineManager

Modifie la configuration de la machine virtuelle pour un niveau ordinateur.

Syntaxe

Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMMServer <ServerConnection>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   -VMHost <Host>
   [-PinVMHost <Boolean>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   [-VMHostGroup <HostGroup>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMMServer <ServerConnection>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   -Cloud <Cloud>
   [-CapabilityProfile <CapabilityProfile>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande Set-SCVMConfiguration modifie la configuration de la machine virtuelle pour un niveau ordinateur. La configuration de la machine virtuelle décrit la façon dont la machine virtuelle sera configurée lors du déploiement du service.

Exemples

Exemple 1 : Mettre à jour la configuration de la machine virtuelle pour un niveau machine avant de déployer le service

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -Description "This is the updated virtual machine configuration"

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

La deuxième commande obtient la configuration de la couche ordinateur pour la configuration du service stockée dans $ServiceConfig et stocke l’objet dans la variable $TierConfig.

La troisième commande obtient la configuration de la machine virtuelle pour la configuration de niveau ordinateur stockée dans $TierConfig et stocke la variable dans la variable $VMConfig.

La dernière commande définit la propriété de description du premier objet de configuration de machine virtuelle stocké dans $VMConfig et affiche les propriétés de la configuration de la machine virtuelle à l’utilisateur.

Exemple 2 : Configurer l’objet de configuration de machine virtuelle d’un niveau machine pour épingler l’hôte pour une machine virtuelle

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01" 
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig 
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -PinVMHost $True

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

La deuxième commande obtient l’objet de configuration de la couche ordinateur pour la configuration de service stockée dans $ServiceConfig et stocke l’objet dans la variable $TierConfig.

La troisième commande obtient les objets de configuration de machine virtuelle pour la configuration de la couche ordinateur stockée dans $TierConfig et stocke les objets dans la variable $VMConfig.

La dernière commande définit le propety PinVMHost sur $True pour le premier objet de configuration de machine virtuelle stocké dans $VMConfig. Par conséquent, lorsque le service est déployé, l’hôte de la machine virtuelle créée avec cette configuration ne sera pas modifié.

Exemple 3 : Configurer l’objet de configuration de machine virtuelle pour un service dans un cloud privé

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig 
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $Cloud = Get-SCCloud -Name "Production"
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[1] -Cloud $Cloud -Description "This is the new virtual machine configuration"

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

La deuxième commande obtient la configuration de la couche ordinateur pour la configuration du service stockée dans $ServiceConfig et stocke l’objet dans la variable $TierConfig.

La troisième commande obtient les objets de configuration de machine virtuelle pour la configuration de la couche ordinateur stockée dans $TierConfig et stocke les objets dans la variable $VMConfig.

La quatrième commande obtient l’objet de cloud privé nommé Production et stocke l’objet dans la variable $Cloud.

La dernière commande met à jour la description du deuxième objet de configuration de machine virtuelle stocké dans $VMConfig pour le cloud privé stocké dans $Cloud.

Paramètres

-AvailabilitySetNames

Spécifie une liste de noms de groupes à haute disponibilité.

Type:System.Collections.Generic.List`1[System.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

-CapabilityProfile

Spécifie un objet de profil de capacité.

Type:CapabilityProfile
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:False
Accepter les caractères génériques:False

-ComputerName

Spécifie le nom d’un ordinateur que Virtual Machine Manager (VMM) peut identifier de manière unique sur votre réseau. Les formats valides sont les suivants :

  • FQDN
  • Adresse IPv4 ou IPv6
  • Nom NetBIOS
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

-CostCenter

Spécifie le centre de coûts d’une machine virtuelle afin de pouvoir collecter des données sur l’allocation de machines virtuelles (ou les ressources allouées aux machines virtuelles) pour utiliser votre système de facturation.

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

-Description

Spécifie une description de la configuration.

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

-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

-Name

Spécifie le nom d’un objet VMM.

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

-NoConnectedHost

Supprime l’hôte d’une configuration de machine virtuelle.

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

-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

-PinVMHost

Indique si l’hôte de machine virtuelle choisi par l’utilisateur est conservé pendant la configuration du déploiement du service.

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

-PinVMLocation

Indique si l’emplacement de la machine virtuelle choisi par l’utilisateur est conservé pendant la configuration du déploiement du service.

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

-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

-Tag

Spécifie un mot ou une expression à associer à un objet afin que vous puissiez rechercher tous les objets avec l’ensemble spécifié de balises. Vous pouvez rechercher un sous-ensemble de balises ou rechercher l’ensemble complet des balises.

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

-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

-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:False
Accepter les caractères génériques:False

-VMHostGroup

Spécifie un objet de groupe hôte de machine virtuelle ou un tableau d’objets de groupe hôte.

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

-VMLocation

Spécifie le chemin d’accès à une machine virtuelle.

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

-VMMServer

Spécifie un objet serveur VMM.

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

VMConfiguration

Cette applet de commande retourne un objet VMConfiguration.