Delen via


Get-AzContext

Hiermee haalt u de metagegevens op die worden gebruikt voor het verifiëren van Azure Resource Manager-aanvragen.

Syntaxis

GetSingleContext (Standaard)

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

ListAllContexts

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

Description

De Get-AzContext cmdlet haalt de huidige metagegevens op die worden gebruikt voor het verifiëren van Azure Resource Manager-aanvragen. Met deze cmdlet worden het Active Directory-account, de Active Directory-tenant, het Azure-abonnement en de beoogde Azure-omgeving opgehaald. Azure Resource Manager-cmdlets gebruiken deze instellingen standaard bij het maken van Azure Resource Manager-aanvragen. Wanneer de beschikbare hoeveelheid abonnement de standaardlimiet van 25 overschrijdt, worden sommige abonnementen mogelijk niet weergegeven in de resultaten van Get-AzContext -ListAvailable. Voer de opdracht uit Connect-AzAccount -MaxContextPopulation <int> om meer contexten te krijgen.

Voorbeelden

Voorbeeld 1: De huidige context ophalen

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

In dit voorbeeld melden we ons aan bij ons account met een Azure-abonnement met behulp van Connect-AzAccount. Vervolgens krijgen we de context van de huidige sessie door Get-AzContext aan te roepen.

Voorbeeld 2: alle beschikbare contexten weergeven

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 dit voorbeeld worden alle momenteel beschikbare contexten weergegeven. De gebruiker kan een van deze contexten selecteren met Select-AzContext.

Parameters

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ListAvailable

Alle beschikbare contexten in de huidige sessie weergeven.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ListAllContexts
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

De naam van de context

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

GetSingleContext
Position:0
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-RefreshContextFromTokenCache

Contexten vernieuwen van tokencache

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ListAllContexts
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

None

Uitvoerwaarden

PSAzureContext