Rename-AzContext

Modul:
Az.Accounts Module

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

Syntax

RenameByInputObject (Standard) 

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

RenameByName 

Rename-AzContext
    [-SourceName] <String>
    [-TargetName] <String>
    [-Force]
    [-PassThru]
    [-Scope <ContextModificationScope>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<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 Arbeit" 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 mit Select-AzContext Arbeit als Ziel festlegen.

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InputObject

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

Parametereigenschaften

Typ:PSAzureContext
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

RenameByInputObject
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PassThru

Gibt den umbenannten Kontext zurück.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:ContextModificationScope
Standardwert:None
Zulässige Werte:Process, CurrentUser
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SourceName

Der Name des Kontexts

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

RenameByName
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TargetName

Der neue Name des Kontexts

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSAzureContext

Ausgaben

PSAzureContext