Get-AzContext

  • Riferimento
Modulo:
Az.Accounts

Ottiene i metadati usati per autenticare le richieste di Azure Resource Manager.

Sintassi

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

Descrizione

Il cmdlet Get-AzContext ottiene i metadati correnti usati per autenticare le richieste di Azure Resource Manager. Questo cmdlet ottiene l'account Active Directory, il tenant di Active Directory, la sottoscrizione di Azure e l'ambiente di Azure di destinazione. I cmdlet di Azure Resource Manager usano queste impostazioni per impostazione predefinita quando si effettuano richieste di Azure Resource Manager. Quando la quantità di sottoscrizione disponibile supera il limite predefinito di 25, alcune sottoscrizioni potrebbero non essere visualizzate nei risultati di Get-AzContext -ListAvailable. Connect-AzAccount -MaxContextPopulation <int> Eseguire per ottenere altri contesti.

Esempio

Esempio 1: Recupero del contesto corrente

Connect-AzAccount
Get-AzContext

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

In questo esempio si accede all'account con una sottoscrizione di Azure usando Connect-AzAccount e quindi si ottiene il contesto della sessione corrente chiamando Get-AzContext.

Esempio 2: Elencare tutti i contesti disponibili

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...

In questo esempio vengono visualizzati tutti i contesti attualmente disponibili. L'utente può selezionare uno di questi contesti usando Select-AzContext.

Parametri

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ListAvailable

Elencare tutti i contesti disponibili nella sessione corrente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Nome del contesto

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RefreshContextFromTokenCache

Aggiornare i contesti dalla cache dei token

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

PSAzureContext