Get-AzureSubscription

Referência

Módulo:: Azure

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 .