Rename-AzContext

參考

模組:: Az.Accounts

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

輸出