Condividi tramite


Get-AzContext

Ottiene i metadati utilizzati per autenticare Azure Resource Manager richieste.

Sintassi

GetSingleContext (Impostazione predefinita)

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

ListAllContexts

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 Active Directory, la sottoscrizione Azure e l'ambiente di Azure di destinazione. Azure Resource Manager cmdlet usano queste impostazioni per impostazione predefinita durante l'esecuzione di 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 . 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 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

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ListAvailable

Elencare tutti i contesti disponibili nella sessione corrente.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ListAllContexts
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Nome del contesto

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

GetSingleContext
Posizione:0
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-RefreshContextFromTokenCache

Aggiornare i contesti dalla cache dei token

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ListAllContexts
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

None

Output

PSAzureContext