Udostępnij za pośrednictwem


Rename-AzContext

Zmień nazwę kontekstu platformy Azure. Domyślnie konteksty są nazwane przez konto użytkownika i subskrypcję.

Składnia

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

Opis

Zmień nazwę kontekstu platformy Azure. Domyślnie konteksty są nazwane przez konto użytkownika i subskrypcję.

Przykłady

Przykład 1. Zmiana nazwy kontekstu przy użyciu nazwanych parametrów

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

Zmień nazwę kontekstu "" nauser1@contoso.org "" z subskrypcją "12345-6789-2345-3567890" na "Praca". Po wykonaniu tego polecenia będzie można kierować kontekst przy użyciu polecenia "Select-AzContext Work". Należy pamiętać, że za pomocą wartości "SourceName" można użyć tabulacji.

Przykład 2. Zmiana nazwy kontekstu przy użyciu parametrów pozycyjnych

Rename-AzContext "My context" "Work"

Zmień nazwę kontekstu o nazwie "Mój kontekst" na "Praca". Po wykonaniu tego polecenia będzie można kierować kontekst przy użyciu polecenia Select-AzContext Work

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Zmień nazwę kontekstu, nawet jeśli kontekst docelowy już istnieje

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

Obiekt kontekstu, zwykle przekazywany przez potok.

Typ:PSAzureContext
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PassThru

Zwróć kontekst o zmienionej nazwie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Scope

Określa zakres zmian kontekstu, na przykład czy zmiany mają zastosowanie tylko do bieżącego procesu, czy do wszystkich sesji uruchomionych przez tego użytkownika

Typ:ContextModificationScope
Dopuszczalne wartości:Process, CurrentUser
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SourceName

Nazwa kontekstu

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetName

Nowa nazwa kontekstu

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSAzureContext

Dane wyjściowe

PSAzureContext