共用方式為


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>]

Description

重新命名 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