Select-AzureSubscription
Altera as assinaturas atuais e padrão do Azure.
Observação
Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.
O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Sintaxe
SelectSubscriptionByNameParameterSet (Padrã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 assinatura "padrão" é salva no arquivo de dados da assinatura. 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 do Microsoft Azure PowerShell.
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 assinatura atual
C:\PS> Select-AzureSubscription -Current -SubscriptionName ContosoEngineering
Esse comando torna "ContosoEngineering" a assinatura atual.
Exemplo 2: Definir a assinatura padrão
C:\PS> Select-AzureSubscription -Default -SubscriptionName ContosoFinance -SubscriptionDataFile "C:\subs\MySubscriptions.xml"
Esse 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 assinatura "padrão" é salva no arquivo de dados da assinatura. 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 do Microsoft Azure PowerShell.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | 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 assinatura "padrão" é salva no arquivo de dados da assinatura. 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 do Microsoft Azure PowerShell.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
SelectSubscriptionByNameParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SelectSubscriptionByIdParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 assinatura "padrão" é salva no arquivo de dados da assinatura. 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 do Microsoft Azure PowerShell.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
SelectDefaultSubscriptionByNameParameterSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SelectDefaultSubscriptionByIdParameterSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 assinatura "padrão" é salva no arquivo de dados da assinatura. 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 do Microsoft Azure PowerShell.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
NoCurrentSubscriptionParameterSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 assinatura "padrão" é salva no arquivo de dados da assinatura. 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 do Microsoft Azure PowerShell.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
NoDefaultSubscriptionParameterSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Profile
Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o perfil padrão local.
Propriedades do parâmetro
| Tipo: | AzureSMProfile |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 assinatura "padrão" é salva no arquivo de dados da assinatura. 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 do Microsoft Azure PowerShell.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | ID |
Conjuntos de parâmetros
SelectSubscriptionByIdParameterSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
SelectDefaultSubscriptionByIdParameterSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | 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 assinatura "padrão" é salva no arquivo de dados da assinatura. 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 do Microsoft Azure PowerShell.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Nome |
Conjuntos de parâmetros
SelectSubscriptionByNameParameterSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
SelectDefaultSubscriptionByNameParameterSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | 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 por nome de propriedade, mas não por valor.
Saídas
None or System.Boolean
Se você usar o parâmetro PassThru , esse cmdlet retornará um valor booliano. Por padrão, ele não gera nenhuma saída.