Rename-AzContext

Referenz

Modul:: Az.Accounts

Benennen Sie einen Azure-Kontext um. Standardmäßig werden Kontexte nach Benutzerkonto und Abonnement benannt.

Syntax

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

Beschreibung

Benennen Sie einen Azure-Kontext um. Standardmäßig werden Kontexte nach Benutzerkonto und Abonnement benannt.

Beispiele

Beispiel 1: Umbenennen eines Kontexts mit benannten Parametern

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

Benennen Sie den Kontext für "user1@contoso.org" mit abonnement "12345-6789-2345-3567890" in "Arbeit" um. Nach diesem Befehl können Sie den Kontext mithilfe von "Select-AzContext Work" als Ziel festlegen. Beachten Sie, dass Sie die Werte für "SourceName" mit Tabstoppabschluss durchlaufen können.

Beispiel 2: Umbenennen eines Kontexts mithilfe von Positionsparametern

Rename-AzContext "My context" "Work"

Benennen Sie den Kontext "Mein Kontext" in "Arbeit" um. Nach diesem Befehl können Sie den Kontext mithilfe von Select-AzContext Work als Ziel festlegen.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Anmeldeinformationen, Mandant und Abonnement, die für die Kommunikation mit Azure verwendet werden

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Force

Benennen Sie den Kontext auch dann um, wenn der Zielkontext bereits vorhanden ist

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Ein Kontextobjekt, das normalerweise durch die Pipeline übergeben wird.

Typ:	PSAzureContext
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-PassThru

Gibt den umbenannten Kontext zurück.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Scope

Bestimmt den Umfang von Kontextänderungen, z. B. ob Änderungen nur für den aktuellen Prozess gelten, oder für alle sitzungen, die von diesem Benutzer gestartet wurden.

Typ:	ContextModificationScope
Zulässige Werte:	Process, CurrentUser
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SourceName

Der Name des Kontexts

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-TargetName

Der neue Name des Kontexts

Typ:	String
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

PSAzureContext

Ausgaben