Get-AzureSubscription
Obtém assinaturas do Azure na conta do Azure.
Observação
Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.
Syntax
Get-AzureSubscription
[-SubscriptionName <String>]
[-ExtendedDetails]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Get-AzureSubscription
[-SubscriptionId <String>]
[-ExtendedDetails]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Get-AzureSubscription
[-Default]
[-ExtendedDetails]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Get-AzureSubscription
[-Current]
[-ExtendedDetails]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
O cmdlet Get-AzureSubscription obtém as assinaturas em sua conta do Azure. Você pode usar esse cmdlet para obter informações sobre a assinatura e canalizar a assinatura para outros cmdlets.
Get-AzureSubscription requer acesso às suas contas do Azure. Antes de executar Get-AzureSubscription, você deve executar o cmdlet Add-AzureAccount ou os cmdlets que baixam e instalam um arquivo de configurações de publicação (Get-AzurePublishSettingsFile, Import-AzurePublishSettingsFile.
Este tópico descreve o cmdlet na versão 0.8.10 do módulo do 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: Obter todas as assinaturas
C:\PS>Get-AzureSubscription
Esse comando obtém todas as assinaturas na conta.
Exemplo 2: Obter uma assinatura pelo nome
C:\PS>Get-AzureSubscription -SubscriptionName "MyProdSubscription"
Este comando obtém apenas a assinatura "MyProdSubsciption".
Exemplo 3: Obter a assinatura padrão
C:\PS>(Get-AzureSubscription -Default).SubscriptionName
Esse comando obtém apenas o nome da assinatura padrão. O comando primeiro obtém a assinatura e, em seguida, usa o método dot para obter a propriedade SubscriptionName da assinatura.
Exemplo 4: Obter propriedades de assinatura selecionadas
C:\PS>Get-AzureSubscription -Current | Format-List -Property SubscriptionName, Certificate
Esse comando retorna uma lista com o nome e o certificado da assinatura atual. Ele usa um comando Get-AzureSubscription para obter a assinatura atual. Em seguida, canaliza a assinatura para um comando Format-List que exibe as propriedades selecionadas em uma lista.
Exemplo 5: Usar um arquivo de dados de assinatura alternativo
C:\PS>Get-AzureSubscription -SubscriptionDataFile "C:\Temp\MySubscriptions.xml"
Esse comando obtém assinaturas do arquivo de dados de assinatura C:\Temp\MySubscriptions.xml . Use o parâmetro SubscriptionDataFile se você especificou um arquivo de dados de assinatura alternativo ao executar os cmdlets Add-AzureAccount ou Import-PublishSettingsFile.
Parâmetros
-Current
Obtém apenas a assinatura atual, ou seja, a assinatura designada como "atual". Por padrão, Get-AzureSubscription obtém todas as assinaturas em suas contas do Azure. Para designar uma assinatura como "atual", use o parâmetro Current do cmdlet Select-AzureSubscription .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Default
Obtém apenas a assinatura padrão, ou seja, a assinatura designada como "padrão". Por padrão, Get-AzureSubscription obtém todas as assinaturas em suas contas do Azure. Para designar uma assinatura como "padrão", use o parâmetro Default do cmdlet Select-AzureSubscription .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtendedDetails
Retorna informações de cota para a assinatura, além das configurações padrão.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionId
Type: | String |
Aliases: | Id |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SubscriptionName
Obtém apenas a assinatura especificada. Insira o nome da assinatura. O valor diferencia maiúsculas de minúsculas. Não há suporte para caracteres curinga. Por padrão, Get-AzureSubscription obtém todas as assinaturas em suas contas do Azure.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entradas
None
Você pode canalizar a entrada para a propriedade SubscriptionName por nome, mas não por valor.
Saídas
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureSubscription
Observações
- Get-AzureSubscription obtém dados do arquivo de dados de assinatura criados pelos cmdlets Add-AzureAccount e Import-PublishSettingsFile .