Partager via

Get-AzureRole

  • Référence
Module:
Azure

Retourne une liste de rôles dans votre service Microsoft Azure.

Remarque

Les applets de commande référencées dans cette documentation concernent la gestion des 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

Get-AzureRole
   [-ServiceName] <String>
   [[-Slot] <String>]
   [[-RoleName] <String>]
   [-InstanceDetails]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzureRole retourne un objet de liste avec des détails sur les rôles dans votre service Microsoft Azure. Si vous spécifiez le paramètre RoleName , Get-AzureRole retourne des détails sur ce rôle uniquement. Si vous spécifiez le paramètre InstanceDetails , des détails supplémentaires spécifiques à l’instance sont retournés.

Exemples

Exemple 1 : Obtenir la liste des rôles d’un service

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production"

Cette commande retourne un objet avec des détails sur tous les rôles de production exécutés sur le service MySvc01.

Exemple 2 : Obtenir des détails sur un rôle en cours d’exécution sur un service

PS C:\> Get-AzureRole -ServiceName "MySvc1" -Slot "Staging" -RoleName "MyTestVM3"

Cette commande retourne un objet avec des détails sur le rôle MyTestVM3, en cours d’exécution sur l’environnement intermédiaire du service MySvc01.

Exemple 3 : Obtenir des informations sur les instances d’un rôle s’exécutant sur un service

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production" -RoleName "MyTestVM02" -InstanceDetails

Cette commande retourne un objet avec des détails sur les instances du rôle MyTestVM02 s’exécutant dans l’environnement de production sur le service MySvc01.

Exemple 4 : Obtenir une table des instances de rôle associées à un service

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production" -InstanceDetails | Format-Table -Auto "InstanceName", "InstanceSize", "InstanceStatus"

Cette commande retourne une table du nom, de la taille et de l’état de toutes les instances de rôle exécutées dans l’environnement de production sur le service MySvc01.

Paramètres

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Demander
  • SilentlyContinue
  • Arrêter
  • Suspendre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’informations.

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

-InstanceDetails

Spécifie que cette applet de commande retourne des détails sur les instances de chaque rôle.

Type:SwitchParameter
Position:3
Valeur par défaut:None
Obligatoire:False
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

-RoleName

Spécifie le nom du rôle à obtenir.

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

-ServiceName

Spécifie le nom du service Azure.

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

-Slot

Spécifie l’environnement de déploiement Azure. Les valeurs acceptables pour ce paramètre sont : Production ou Préproduction.

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