Set-SCVMConfiguration
Modifie la configuration de la machine virtuelle pour un niveau ordinateur.
Syntax
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 configuration de la machine virtuelle lorsque le service est déployé.
Exemples
Exemple 1 : Mettre à jour la configuration de la machine virtuelle pour un niveau de 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 du niveau 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 du 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ée 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 pour 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 $TrueLa 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 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 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 du niveau 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 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 des noms des groupes à haute disponibilité.
| Type: | System.Collections.Generic.List`1[System.String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CapabilityProfile
Spécifie un objet de profil de capacité.
| Type: | CapabilityProfile |
| 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: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CostCenter
Spécifie le centre de coûts d’un ordinateur virtuel, de telle sorte que vous puissiez collecter des données relatives à l’allocation des ordinateurs virtuels (ou relatives aux ressources allouées aux ordinateurs virtuels) en vue de les utiliser dans votre système de facturation.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Spécifie une description de la configuration.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.
| Type: | String |
| 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: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoConnectedHost
Supprime l’hôte d’une configuration de machine virtuelle.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Spécifie le nom d'un utilisateur. Cette applet de commande définit le nom de l’utilisateur comme utilisateur spécifié par ce paramètre.
| 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. Cette applet de commande définit le rôle d’utilisateur au nom 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PinVMHost
Indique si l’hôte de machine virtuelle choisi par l’utilisateur est conservé pendant la configuration du déploiement de service.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PinVMLocation
Indique si l’emplacement de la machine virtuelle choisi par l’utilisateur est conservé pendant la configuration du déploiement de service.
| Type: | Boolean |
| 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 |
-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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMConfiguration
Spécifie un objet de configuration de machine virtuelle.
| Type: | BaseVMConfiguration |
| 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: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMLocation
Spécifie le chemin d’accès à une machine virtuelle.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Spécifie un objet serveur VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Sorties
VMConfiguration
Cette applet de commande retourne un objet VMConfiguration .