Sdílet prostřednictvím


Rename-AzureRmContext

Přejmenujte kontext Azure. Ve výchozím nastavení jsou kontexty pojmenované podle uživatelského účtu a předplatného.

Upozorňující

Modul AzureRM PowerShell je od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntaxe

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

Description

Přejmenujte kontext Azure. Ve výchozím nastavení jsou kontexty pojmenované podle uživatelského účtu a předplatného.

Příklady

Přejmenování kontextu pomocí pojmenovaných parametrů

PS C:\> Rename-AzureRmContext -SourceName "[user1@contoso.org; 12345-6789-2345-3567890]" -TargetName "Work"

Přejmenujte kontext pro 'user1@contoso.org' s předplatným '12345-6789-2345-3567890' na 'Work'. Po tomto příkazu budete moct cílit na kontext pomocí příkazu Select-AzureRmContext Work. Všimněte si, že pomocí dokončování tabulátoru můžete procházet hodnoty sourceName.

Přejmenování kontextu pomocí pozičních parametrů

PS C:\> Rename-AzureRmContext "My context" "Work"

Přejmenujte kontext s názvem "Můj kontext" na "Práce". Po tomto příkazu budete moct cílit na kontext pomocí funkce Select-AzureRmContext Work.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Přejmenujte kontext i v případě, že cílový kontext již existuje.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Kontextový objekt, který se obvykle předává kanálem.

Typ:PSAzureContext
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PassThru

Vrátí přejmenovaný kontext.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Scope

Určuje rozsah změn kontextu, například zda se změny vztahují pouze na aktuální proces, nebo na všechny relace spuštěné tímto uživatelem.

Typ:ContextModificationScope
Přípustné hodnoty:Process, CurrentUser
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SourceName

Název kontextu

Typ:String
Přípustné hodnoty:Default
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TargetName

Nový název kontextu

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSAzureContext

Parametry: InputObject (ByValue)

Výstupy

PSAzureContext