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

Rename-AzContext

重命名 Azure 上下文。 默认情况下,上下文由用户帐户和订阅命名。

语法

Rename-AzContext
      -InputObject <PSAzureContext>
      [-Force]
      [-PassThru]
      [-Scope <ContextModificationScope>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [-TargetName] <String>
      [<CommonParameters>]
Rename-AzContext
      [-Force]
      [-PassThru]
      [-Scope <ContextModificationScope>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [-SourceName] <String>
      [-TargetName] <String>
      [<CommonParameters>]

说明

重命名 Azure 上下文。 默认情况下,上下文由用户帐户和订阅命名。

示例

示例 1:使用命名参数重命名上下文

Rename-AzContext -SourceName "[user1@contoso.org; 12345-6789-2345-3567890]" -TargetName "Work"

将订阅“12345-6789-2345-3567890”的“user1@contoso.org”上下文重命名为“Work”。 此命令后,你将能够使用“Select-AzContext Work”以上下文为目标。 请注意,可以使用 Tab 完成通过“SourceName”的值进行选项卡式选项卡。

示例 2:使用位置参数重命名上下文

Rename-AzContext "My context" "Work"

将名为“My context”的上下文重命名为“Work”。 此命令后,你将能够使用 Select-AzContext Work 以上下文为目标

参数

-Confirm

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

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

-DefaultProfile

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

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

-Force

重命名上下文(即使目标上下文已存在)

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

-InputObject

上下文对象,通常通过管道传递。

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

-PassThru

返回重命名的上下文。

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

-Scope

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

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

-SourceName

上下文的名称

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

-TargetName

上下文的新名称

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

-WhatIf

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

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

输入

PSAzureContext

输出

PSAzureContext