Rename-AzureRmContext

Referência

Módulo:: AzureRM.Profile

Renomeie um contexto do Azure. Por padrão, os contextos são nomeados por conta de usuário e assinatura.

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

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

Renomeie um contexto do Azure. Por padrão, os contextos são nomeados por conta de usuário e assinatura.

Exemplos

Renomear um contexto usando parâmetros nomeados

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

Renomeie o contexto para 'user1@contoso.org' com a assinatura '12345-6789-2345-3567890' para 'Trabalho'. Após esse comando, você poderá direcionar o contexto usando 'Select-AzureRmContext Work'. Observe que você pode percorrer os valores para 'SourceName' usando o preenchimento da guia.

Renomear um contexto usando parâmetros posicionais

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

Renomeie o contexto chamado "Meu contexto" para "Trabalho". Após esse comando, você poderá direcionar o contexto usando Select-AzureRmContext Work

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DefaultProfile

As credenciais, o locatário e a assinatura usados para comunicação com o azure

Tipo:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Force

Renomeie o contexto mesmo que o contexto de destino já exista

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-InputObject

Um objeto de contexto, normalmente passado pelo pipeline.

Tipo:	PSAzureContext
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-PassThru

Retorne o contexto renomeado.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Scope

Determina o escopo das alterações de contexto, por exemplo, se as alterações se aplicam apenas ao processo atual ou a todas as sessões iniciadas por esse usuário

Tipo:	ContextModificationScope
Valores aceites:	Process, CurrentUser
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-SourceName

O nome do contexto

Tipo:	String
Valores aceites:	Default
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-TargetName

O novo nome do contexto

Tipo:	String
Position:	1
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

PSAzureContext

Parâmetros: InputObject (ByValue)

Saídas