Partager via


Get-AzContext

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

Syntaxe

GetSingleContext (Par défaut)

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

ListAllContexts

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ListAvailable

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ListAllContexts
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Nom du contexte

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

GetSingleContext
Position:0
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RefreshContextFromTokenCache

Actualiser les contextes à partir du cache de jetons

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ListAllContexts
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

None

Sorties

PSAzureContext