Partager via


Get-AzContext

Obtient les métadonnées utilisées pour authentifier les requêtes Azure Resource Manager.

Syntaxe

Get-AzContext
   [-DefaultProfile <IAzureContextContainer>]
   [[-Name] <String>]
   [<CommonParameters>]
Get-AzContext
   [-ListAvailable]
   [-RefreshContextFromTokenCache]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzContext obtient les métadonnées actuelles utilisées pour authentifier les requêtes Azure Resource Manager. Cette applet de commande obtient le compte Active Directory, le locataire Active Directory, l’abonnement Azure et l’environnement Azure ciblé. Les applets de commande Azure Resource Manager utilisent ces paramètres par défaut lors de la création de requêtes Azure Resource Manager. Lorsque la quantité d’abonnement disponible dépasse la limite par défaut de 25, certains abonnements peuvent ne pas apparaître dans les résultats de Get-AzContext -ListAvailable. Exécutez Connect-AzAccount -MaxContextPopulation <int> pour obtenir plus de contextes.

Exemples

Exemple 1 : Obtention du contexte actuel

Connect-AzAccount
Get-AzContext

Name                                     Account             SubscriptionName    Environment         TenantId
----                                     -------             ----------------    -----------         --------
Subscription1 (xxxxxxxx-xxxx-xxxx-xxx... test@outlook.com    Subscription1       AzureCloud          xxxxxxxx-x...

Dans cet exemple, nous nous connectons à notre compte avec un abonnement Azure à l’aide de Connect-AzAccount, puis nous obtenons le contexte de la session active en appelant Get-AzContext.

Exemple 2 : Liste de tous les contextes disponibles

Get-AzContext -ListAvailable

Name                                     Account             SubscriptionName    Environment         TenantId
----                                     -------             ----------------    -----------         --------
Subscription1 (xxxxxxxx-xxxx-xxxx-xxx... test@outlook.com    Subscription1       AzureCloud          xxxxxxxx-x...
Subscription2 (xxxxxxxx-xxxx-xxxx-xxx... test@outlook.com    Subscription2       AzureCloud          xxxxxxxx-x...
Subscription3 (xxxxxxxx-xxxx-xxxx-xxx... test@outlook.com    Subscription3       AzureCloud          xxxxxxxx-x...

Dans cet exemple, tous les contextes actuellement disponibles sont affichés. L’utilisateur peut sélectionner l’un de ces contextes à l’aide de Select-AzContext.

Paramètres

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ListAvailable

Répertorier tous les contextes disponibles dans la session active.

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

-Name

Nom du contexte

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

-RefreshContextFromTokenCache

Actualiser les contextes à partir du cache de jetons

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

Entrées

None

Sorties

PSAzureContext