Condividi tramite


Rename-AzContext

Rinominare un contesto di Azure. Per impostazione predefinita, i contesti sono denominati dall'account utente e dalla sottoscrizione.

Sintassi

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

Descrizione

Rinominare un contesto di Azure. Per impostazione predefinita, i contesti sono denominati dall'account utente e dalla sottoscrizione.

Esempio

Esempio 1: Rinominare un contesto usando parametri denominati

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

Rinominare il contesto per 'user1@contoso.org' con sottoscrizione '12345-6789-2345-3567890' in 'Work'. Dopo questo comando, sarà possibile specificare come destinazione il contesto usando 'Select-AzContext Work'. Si noti che è possibile scorrere i valori per 'SourceName' usando il completamento della scheda.

Esempio 2: Rinominare un contesto usando i parametri posizionali

Rename-AzContext "My context" "Work"

Rinominare il contesto denominato "My context" in "Work". Dopo questo comando, sarà possibile specificare come destinazione il contesto usando Select-AzContext Work

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, tenant e sottoscrizione usate per la comunicazione con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Rinominare il contesto anche se il contesto di destinazione esiste già

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Oggetto di contesto, in genere passato attraverso la pipeline.

Tipo:PSAzureContext
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Restituisce il contesto rinominato.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Scope

Determina l'ambito delle modifiche al contesto, ad esempio se le modifiche si applicano solo al processo corrente o a tutte le sessioni avviate dall'utente

Tipo:ContextModificationScope
Valori accettati:Process, CurrentUser
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SourceName

Nome del contesto

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TargetName

Nuovo nome del contesto

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSAzureContext

Output

PSAzureContext