Partager via


New-WAPackVMRole

Crée un rôle de machine virtuelle.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

New-WAPackVMRole
   -Name <String>
   -Label <String>
   -ResourceDefinition <VMRoleResourceDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-WAPackVMRole
   -Name <String>
   -Label <String>
   -ResourceDefinition <VMRoleResourceDefinition>
   -CloudService <CloudService>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

Ces rubriques sont déconseillées et seront supprimées à l’avenir. Cette rubrique décrit l’applet de commande dans la version 0.8.1 du module Microsoft Azure PowerShell. Pour connaître la version du module que vous utilisez, à partir de la console Azure PowerShell, tapez (Get-Module -Name Azure).Version.

L’applet de commande New-WAPackVMRole crée un rôle de machine virtuelle.

Exemples

Exemple 1 : Créer un rôle de machine virtuelle (émulant le comportement WAP)

PS C:\> New-WAPackVMRole -Name "ContosoVMRole01" -Label "ContosoVMRoleLabel01" -ResourceDefinition $resdef

Étant donné que nous ne spécifions aucun service cloud (émulant le comportement WAP), la commande crée un service cloud pour nous qui aura le même nom que le rôle de machine virtuelle. Dans ce cas, la commande suivante crée un rôle de machine virtuelle avec le nom ContosoVMRole01, étiquette ContosoVMRoleLabel01. Notez que la définition de ressource utilisée ici doit être créée manuellement avec PowerShell.

Paramètres

-CloudService

Spécifie un service cloud pour le rôle de machine virtuelle.

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

-Label

Spécifie une étiquette pour le rôle de machine virtuelle.

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

-Name

Spécifie un nom pour le rôle de machine virtuelle.

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

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-ResourceDefinition

Spécifie une définition de ressource pour le rôle de machine virtuelle.

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