Partilhar via

Select-AzureSubscription

Módulo:
Azure Module

Altera as assinaturas atuais e padrão do Azure.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

SelectSubscriptionByNameParameterSet (Predefinição) 

Select-AzureSubscription
    -SubscriptionName <String>
    [-Account <String>]
    [-Current]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

SelectDefaultSubscriptionByNameParameterSet 

Select-AzureSubscription
    -SubscriptionName <String>
    [-Account <String>]
    [-Default]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

SelectSubscriptionByIdParameterSet 

Select-AzureSubscription
    -SubscriptionId <String>
    [-Account <String>]
    [-Current]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

SelectDefaultSubscriptionByIdParameterSet 

Select-AzureSubscription
    -SubscriptionId <String>
    [-Account <String>]
    [-Default]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

NoCurrentSubscriptionParameterSet 

Select-AzureSubscription
    [-Account <String>]
    [-NoCurrent]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

NoDefaultSubscriptionParameterSet 

Select-AzureSubscription
    [-Account <String>]
    [-NoDefault]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

Description

O cmdlet Select-AzureSubscription define e limpa as assinaturas atuais e padrão do Azure.

A "assinatura atual" é a assinatura usada por padrão na sessão atual do Windows PowerShell. A "assinatura padrão" é usada por padrão em todas as sessões do Windows PowerShell. O rótulo "assinatura atual" permite especificar uma assinatura diferente a ser usada por padrão para a sessão atual sem alterar a "assinatura padrão" para todas as outras sessões.

A designação de subscrição "predefinida" é guardada no ficheiro de dados da subscrição. A designação "atual" específica da sessão não é salva.

Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure. Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

Exemplos

Exemplo 1: Definir a subscrição atual

C:\PS> Select-AzureSubscription -Current -SubscriptionName ContosoEngineering

Este comando torna "ContosoEngineering" a assinatura atual.

Exemplo 2: Definir a subscrição predefinida

C:\PS> Select-AzureSubscription -Default -SubscriptionName ContosoFinance -SubscriptionDataFile "C:\subs\MySubscriptions.xml"

Este comando altera a assinatura padrão para "ContosoFinance". Ele salva a configuração no arquivo de dados de assinatura Subscriptions.xml, em vez do arquivo de dados de assinatura padrão.

Parâmetros

-Account

O cmdlet Select-AzureSubscription define e limpa as assinaturas atuais e padrão do Azure.

A "assinatura atual" é a assinatura usada por padrão na sessão atual do Windows PowerShell. A "assinatura padrão" é usada por padrão em todas as sessões do Windows PowerShell. O rótulo "assinatura atual" permite especificar uma assinatura diferente a ser usada por padrão para a sessão atual sem alterar a "assinatura padrão" para todas as outras sessões.

A designação de subscrição "predefinida" é guardada no ficheiro de dados da subscrição. A designação "atual" específica da sessão não é salva.

Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure. Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Current

O cmdlet Select-AzureSubscription define e limpa as assinaturas atuais e padrão do Azure.

A "assinatura atual" é a assinatura usada por padrão na sessão atual do Windows PowerShell. A "assinatura padrão" é usada por padrão em todas as sessões do Windows PowerShell. O rótulo "assinatura atual" permite especificar uma assinatura diferente a ser usada por padrão para a sessão atual sem alterar a "assinatura padrão" para todas as outras sessões.

A designação de subscrição "predefinida" é guardada no ficheiro de dados da subscrição. A designação "atual" específica da sessão não é salva.

Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure. Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SelectSubscriptionByNameParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
SelectSubscriptionByIdParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Default

O cmdlet Select-AzureSubscription define e limpa as assinaturas atuais e padrão do Azure.

A "assinatura atual" é a assinatura usada por padrão na sessão atual do Windows PowerShell. A "assinatura padrão" é usada por padrão em todas as sessões do Windows PowerShell. O rótulo "assinatura atual" permite especificar uma assinatura diferente a ser usada por padrão para a sessão atual sem alterar a "assinatura padrão" para todas as outras sessões.

A designação de subscrição "predefinida" é guardada no ficheiro de dados da subscrição. A designação "atual" específica da sessão não é salva.

Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure. Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SelectDefaultSubscriptionByNameParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
SelectDefaultSubscriptionByIdParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-NoCurrent

O cmdlet Select-AzureSubscription define e limpa as assinaturas atuais e padrão do Azure.

A "assinatura atual" é a assinatura usada por padrão na sessão atual do Windows PowerShell. A "assinatura padrão" é usada por padrão em todas as sessões do Windows PowerShell. O rótulo "assinatura atual" permite especificar uma assinatura diferente a ser usada por padrão para a sessão atual sem alterar a "assinatura padrão" para todas as outras sessões.

A designação de subscrição "predefinida" é guardada no ficheiro de dados da subscrição. A designação "atual" específica da sessão não é salva.

Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure. Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

NoCurrentSubscriptionParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-NoDefault

O cmdlet Select-AzureSubscription define e limpa as assinaturas atuais e padrão do Azure.

A "assinatura atual" é a assinatura usada por padrão na sessão atual do Windows PowerShell. A "assinatura padrão" é usada por padrão em todas as sessões do Windows PowerShell. O rótulo "assinatura atual" permite especificar uma assinatura diferente a ser usada por padrão para a sessão atual sem alterar a "assinatura padrão" para todas as outras sessões.

A designação de subscrição "predefinida" é guardada no ficheiro de dados da subscrição. A designação "atual" específica da sessão não é salva.

Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure. Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

NoDefaultSubscriptionParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PassThru

Retorna $True se o comando for bem-sucedido e $False se falhar. Por padrão, esse cmdlet não retorna nenhuma saída.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Propriedades dos parâmetros

Tipo:AzureSMProfile
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SubscriptionId

O cmdlet Select-AzureSubscription define e limpa as assinaturas atuais e padrão do Azure.

A "assinatura atual" é a assinatura usada por padrão na sessão atual do Windows PowerShell. A "assinatura padrão" é usada por padrão em todas as sessões do Windows PowerShell. O rótulo "assinatura atual" permite especificar uma assinatura diferente a ser usada por padrão para a sessão atual sem alterar a "assinatura padrão" para todas as outras sessões.

A designação de subscrição "predefinida" é guardada no ficheiro de dados da subscrição. A designação "atual" específica da sessão não é salva.

Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure. Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Id

Conjuntos de parâmetros

SelectSubscriptionByIdParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
SelectDefaultSubscriptionByIdParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-SubscriptionName

O cmdlet Select-AzureSubscription define e limpa as assinaturas atuais e padrão do Azure.

A "assinatura atual" é a assinatura usada por padrão na sessão atual do Windows PowerShell. A "assinatura padrão" é usada por padrão em todas as sessões do Windows PowerShell. O rótulo "assinatura atual" permite especificar uma assinatura diferente a ser usada por padrão para a sessão atual sem alterar a "assinatura padrão" para todas as outras sessões.

A designação de subscrição "predefinida" é guardada no ficheiro de dados da subscrição. A designação "atual" específica da sessão não é salva.

Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure. Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Nome

Conjuntos de parâmetros

SelectSubscriptionByNameParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
SelectDefaultSubscriptionByNameParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Você pode canalizar a entrada para esse cmdlet pelo nome da propriedade, mas não pelo valor.

Saídas

None or System.Boolean

Se você usar o parâmetro PassThru , esse cmdlet retornará um valor booleano. Por padrão, ele não gera nenhuma saída.