Compartir a través de


Rename-AzContext

Cambie el nombre de un contexto de Azure. De forma predeterminada, la cuenta de usuario y la suscripción denominan contextos.

Sintaxis

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

Description

Cambie el nombre de un contexto de Azure. De forma predeterminada, la cuenta de usuario y la suscripción denominan contextos.

Ejemplos

Ejemplo 1: Cambiar el nombre de un contexto mediante parámetros con nombre

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

Cambie el nombre del contexto de "user1@contoso.org" por la suscripción "12345-6789-2345-3567890" a "Work". Después de este comando, podrá dirigirse al contexto mediante "Select-AzContext Work". Tenga en cuenta que puede desplazarse por los valores de "SourceName" mediante la finalización de tabulación.

Ejemplo 2: Cambiar el nombre de un contexto mediante parámetros posicionales

Rename-AzContext "My context" "Work"

Cambie el nombre del contexto denominado "Mi contexto" a "Trabajo". Después de este comando, podrá dirigirse al contexto mediante Select-AzContext Work.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Cambiar el nombre del contexto incluso si el contexto de destino ya existe

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Un objeto de contexto, que normalmente se pasa a través de la canalización.

Tipo:PSAzureContext
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PassThru

Devuelve el contexto cuyo nombre ha cambiado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Scope

Determina el ámbito de los cambios de contexto, por ejemplo, si los cambios solo se aplican al proceso actual o a todas las sesiones iniciadas por este usuario.

Tipo:ContextModificationScope
Valores aceptados:Process, CurrentUser
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SourceName

Nombre del contexto

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TargetName

Nuevo nombre del contexto

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

PSAzureContext

Salidas

PSAzureContext