Compartilhar via


Select-AzContext

Selecionar uma assinatura e uma conta para direcionar nos cmdlets do Azure PowerShell

Sintaxe

Select-AzContext
      -InputObject <PSAzureContext>
      [-Scope <ContextModificationScope>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Select-AzContext
      [-Scope <ContextModificationScope>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [-Name] <String>
      [<CommonParameters>]

Description

Selecione uma assinatura para destino (ou conta ou locatário) nos cmdlets do Azure PowerShell. Após esse cmdlet, os cmdlets futuros serão direcionados ao contexto selecionado.

Exemplos

Exemplo 1: Direcionar um contexto nomeado

Select-AzContext "Work"

Name    Account             SubscriptionName    Environment         TenantId
----    -------             ----------------    -----------         --------
Work    test@outlook.com    Subscription1       AzureCloud          xxxxxxxx-x...

Direcione futuros cmdlets do Azure PowerShell para a conta, o locatário e a assinatura no contexto 'Trabalho'.

Exemplo 2

Selecione uma assinatura e uma conta para direcionar nos cmdlets do Azure PowerShell nesta sessão do PowerShell. (gerado automaticamente)

Select-AzContext -Name TestEnvironment -Scope Process

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Um objeto de contexto, normalmente passado pelo pipeline.

Tipo:PSAzureContext
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

O nome do contexto

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 aceitos:Process, CurrentUser
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSAzureContext

Saídas

PSAzureContext