Get-AzureRole

Référence

Module:: Azure

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

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

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
Renseignez-vous
SilentlyContinue
Arrêter
Suspendre

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Spécifie une variable d’informations.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceDetails

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

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

-RoleName

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

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ServiceName

Spécifie le nom du service Azure.

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

Set-AzureRole