Get-AzContext
获取用于对 Azure 资源管理器请求进行身份验证的元数据。
语法
GetSingleContext (默认值)
Get-AzContext
[[-Name] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ListAllContexts
Get-AzContext
[-ListAvailable]
[-RefreshContextFromTokenCache]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
说明
Get-AzContext cmdlet 获取用于对 Azure 资源管理器请求进行身份验证的当前元数据。
此 cmdlet 获取 Active Directory 帐户、Active Directory 租户、Azure 订阅和目标 Azure 环境。
发出 Azure 资源管理器请求时,Azure 资源管理器 cmdlet 默认使用这些设置。 当可用订阅量超过默认限制 25 时,某些订阅可能不会显示在结果 Get-AzContext -ListAvailable
中。 请运行 Connect-AzAccount -MaxContextPopulation <int>
以获取更多上下文。
示例
示例 1:获取当前上下文
Connect-AzAccount
Get-AzContext
Name Account SubscriptionName Environment TenantId
---- ------- ---------------- ----------- --------
Subscription1 (xxxxxxxx-xxxx-xxxx-xxx... test@outlook.com Subscription1 AzureCloud xxxxxxxx-x...
在此示例中,我们使用 Connect-AzAccount 通过 Azure 订阅登录到帐户,然后通过调用 Get-AzContext 获取当前会话的上下文。
示例 2:列出所有可用上下文
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...
在此示例中,将显示所有当前可用的上下文。 用户可以使用 Select-AzContext 选择其中一个上下文。
参数
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅
参数属性
类型: | IAzureContextContainer |
默认值: | None |
支持通配符: | False |
不显示: | False |
别名: | AzContext, AzureRmContext, AzureCredential |
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-ListAvailable
列出当前会话中的所有可用上下文。
参数属性
类型: | SwitchParameter |
默认值: | None |
支持通配符: | False |
不显示: | False |
参数集
ListAllContexts
Position: | Named |
必需: | True |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-Name
上下文的名称
参数属性
类型: | String |
默认值: | None |
支持通配符: | False |
不显示: | False |
参数集
GetSingleContext
Position: | 0 |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-RefreshContextFromTokenCache
从令牌缓存刷新上下文
参数属性
类型: | SwitchParameter |
默认值: | None |
支持通配符: | False |
不显示: | False |
参数集
ListAllContexts
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。