你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Set-AzContext

设置要在当前会话中使用的 cmdlet 的租户、订阅和环境。

语法

Set-AzContext
   [-Context] <PSAzureContext>
   [-ExtendedProperty <System.Collections.Generic.IDictionary`2[System.String,System.String]>]
   [-Name <String>]
   [-Force]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzContext
   [-TenantObject] <PSAzureTenant>
   [-ExtendedProperty <System.Collections.Generic.IDictionary`2[System.String,System.String]>]
   [-Name <String>]
   [-Force]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzContext
   [-SubscriptionObject] <PSAzureSubscription>
   [-ExtendedProperty <System.Collections.Generic.IDictionary`2[System.String,System.String]>]
   [-Name <String>]
   [-Force]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzContext
   [-Tenant <String>]
   [-Subscription] <String>
   [-ExtendedProperty <System.Collections.Generic.IDictionary`2[System.String,System.String]>]
   [-Name <String>]
   [-Force]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzContext
   -Tenant <String>
   [-ExtendedProperty <System.Collections.Generic.IDictionary`2[System.String,System.String]>]
   [-Name <String>]
   [-Force]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-AzContext cmdlet 为当前会话中运行的 cmdlet 设置身份验证信息。 上下文包括租户、订阅和环境信息。

示例

示例 1:设置订阅上下文

Set-AzContext -Subscription "xxxx-xxxx-xxxx-xxxx"

Name    Account             SubscriptionName    Environment         TenantId
----    -------             ----------------    -----------         --------
Work    test@outlook.com    Subscription1       AzureCloud          xxxxxxxx-x...

此命令将上下文设置为使用指定的订阅。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Context

指定当前会话的上下文。

类型:PSAzureContext
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、租户和订阅。

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ExtendedProperty

其他上下文属性

类型:IDictionary<TKey,TValue>[System.String,System.String]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Force

使用同名覆盖现有上下文(如果有)。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

上下文的名称

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Scope

确定上下文更改的范围,例如,更改仅适用于当前进程,还是应用于此用户启动的所有会话。

类型:ContextModificationScope
接受的值:Process, CurrentUser
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Subscription

上下文应设置为的订阅的名称或 ID。 此参数具有 -SubscriptionName 和 -SubscriptionId 的别名,因此,为了清楚起见,可以在指定名称和 ID 时分别使用这些别名,而不是 -Subscription。

类型:String
别名:SubscriptionId, SubscriptionName
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-SubscriptionObject

订阅对象

类型:PSAzureSubscription
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Tenant

租户域名或 ID

类型:String
别名:Domain, TenantId
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-TenantObject

租户对象

类型:PSAzureTenant
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

PSAzureContext

PSAzureTenant

PSAzureSubscription

输出

PSAzureContext