Partager via

New-SCVMConfiguration

  • Référence
Module:
VirtualMachineManager

Crée une configuration de machine virtuelle à partir d’un modèle de machine virtuelle.

Syntax

New-SCVMConfiguration
   -VMTemplate <Template>
   [-Name <String>]
   [-Description <String>]
   [-CostCenter <String>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMConfiguration
   -VMTemplate <Template>
   -Name <String>
   [-Description <String>]
   -Cloud <Cloud>
   [-CostCenter <String>]
   [-CapabilityProfile <CapabilityProfile>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMConfiguration
   -VMTemplate <Template>
   -Name <String>
   [-Description <String>]
   -VMHostGroup <HostGroup>
   [-CostCenter <String>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMConfiguration
   -ComputerTier <ComputerTier>
   [-Name <String>]
   [-Description <String>]
   [-CostCenter <String>]
   [-ComputerName <String>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande New-SCVMConfiguration crée une configuration de machine virtuelle à partir d’un modèle de machine virtuelle. La configuration de la machine virtuelle est utilisée pour spécifier des valeurs spécifiques à l’instance à utiliser lors du déploiement de la configuration de la machine virtuelle.

Exemples

Exemple 1 : Créer une configuration de machine virtuelle pour le placement d’une machine virtuelle sur un groupe hôte

PS C:\> $HostGroup = Get-SCVMHostGroup -Name "Production"
PS C:\> $VMTemplate = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $VMConfig = New-SCVMConfiguration -VMTemplate $VMTemplate -VMHostGroup $HostGroup -CostCenter 1234 -Name "VMConfig01"

La première commande obtient l’objet de groupe hôte nommé Production et stocke l’objet dans la variable $HostGroup.

La deuxième commande obtient tous les objets de modèle de machine virtuelle, sélectionne le modèle nommé VMTemplate01, puis stocke l’objet dans la variable $VMTemplate.

La dernière commande crée une configuration de machine virtuelle nommée VMConfig01 pour le modèle de machine virtuelle stockée dans $VMTemplate pour le déploiement sur le groupe hôte stocké dans $HostGroup, en spécifiant une valeur de centre de coût de 1234.

Paramètres

-AvailabilitySetNames

Spécifie une liste de noms de 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 VMM peut identifier de manière unique sur votre réseau. Les formats valides sont les suivants :

  • FQDN
  • Adresse IPv4
  • Adresse IPv6
  • Nom NetBIOS
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerTier

Spécifie un objet de niveau ordinateur.

Type:ComputerTier
Position:Named
Default value:None
Required:True
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 de la machine virtuelle.

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 Virtual Machine Manager (VMM).

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

-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:True
Accept pipeline input:False
Accept wildcard characters:False

-VMTemplate

Spécifie un objet modèle VMM utilisé pour créer des ordinateurs virtuels.

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

Sorties

VMConfiguration

Cette applet de commande retourne un objet VMConfiguration .

Notes

  • Nécessite un objet de modèle de machine virtuelle VMM, que vous pouvez obtenir à l’aide de l’applet de commande Get-SCVMTemplate .