Condividi tramite

Get-AzureSubscription

  • Riferimento
Modulo:
Azure

Ottiene le sottoscrizioni di Azure nell'account Azure.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di gestione dei servizi. Vedere il modulo Az PowerShell per i cmdlet per gestire le risorse di Azure Resource Manager.

Sintassi

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>]

Descrizione

Il cmdlet Get-AzureSubscription ottiene le sottoscrizioni nell'account Azure. È possibile usare questo cmdlet per ottenere informazioni sulla sottoscrizione e inviare tramite pipe la sottoscrizione ad altri cmdlet.

Get-AzureSubscription richiede l'accesso agli account Azure. Prima di eseguire Get-AzureSubscription, è necessario eseguire il cmdlet Add-AzureAccount o i cmdlet che scaricano e installano un file di impostazioni di pubblicazione (Get-AzurePublishSettingsFile, Import-AzurePublishSettingsFile.

Questo argomento descrive il cmdlet nella versione 0.8.10 del modulo Microsoft Azure PowerShell. Per ottenere la versione del modulo in uso, nella console di Azure PowerShell digitare (Get-Module -Name Azure).Version.

Esempio

Esempio 1: Ottenere tutte le sottoscrizioni

C:\PS>Get-AzureSubscription

Questo comando ottiene tutte le sottoscrizioni nell'account.

Esempio 2: Ottenere una sottoscrizione in base al nome

C:\PS>Get-AzureSubscription -SubscriptionName "MyProdSubscription"

Questo comando ottiene solo la sottoscrizione "MyProdSubsciption".

Esempio 3: Ottenere la sottoscrizione predefinita

C:\PS>(Get-AzureSubscription -Default).SubscriptionName

Questo comando ottiene solo il nome della sottoscrizione predefinita. Il comando ottiene prima la sottoscrizione e quindi usa il metodo dot per ottenere la proprietà SubscriptionName della sottoscrizione.

Esempio 4: Ottenere le proprietà di sottoscrizione selezionate

C:\PS>Get-AzureSubscription -Current | Format-List -Property SubscriptionName, Certificate

Questo comando restituisce un elenco con il nome e il certificato della sottoscrizione corrente. Usa un comando Get-AzureSubscription per ottenere la sottoscrizione corrente. Invia quindi tramite pipe la sottoscrizione a un comando Format-List che visualizza le proprietà selezionate in un elenco.

Esempio 5: Usare un file di dati di sottoscrizione alternativo

C:\PS>Get-AzureSubscription -SubscriptionDataFile "C:\Temp\MySubscriptions.xml"

Questo comando ottiene le sottoscrizioni dal file di dati della sottoscrizione C:\Temp\MySubscriptions.xml. Usare il parametro SubscriptionDataFile se è stato specificato un file di dati di sottoscrizione alternativo quando sono stati eseguiti i cmdlet Add-AzureAccount o Import-PublishSettingsFile .

Parametri

-Current

Ottiene solo la sottoscrizione corrente, ovvero la sottoscrizione designata come "corrente". Per impostazione predefinita, Get-AzureSubscription ottiene tutte le sottoscrizioni negli account Azure. Per designare una sottoscrizione come "corrente", usare il parametro Current del cmdlet Select-AzureSubscription .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Default

Ottiene solo la sottoscrizione predefinita, ovvero la sottoscrizione designata come "predefinita". Per impostazione predefinita, Get-AzureSubscription ottiene tutte le sottoscrizioni negli account Azure. Per designare una sottoscrizione come "predefinita", usare il parametro Default del cmdlet Select-AzureSubscription .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExtendedDetails

Restituisce informazioni sulla quota per la sottoscrizione, oltre alle impostazioni standard.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

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

Ottiene solo la sottoscrizione specificata. Immettere il nome della sottoscrizione. Il valore fa distinzione tra maiuscole e minuscole. I caratteri jolly non sono supportati. Per impostazione predefinita, Get-AzureSubscription ottiene tutte le sottoscrizioni negli account Azure.

Type:String
Aliases:Name
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Input

None

È possibile inviare tramite pipe l'input alla proprietà SubscriptionName in base al nome, ma non in base al valore.

Output

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureSubscription

Note

  • Get-AzureSubscription ottiene i dati dal file di dati della sottoscrizione creato dai cmdlet Add-AzureAccount e Import-PublishSettingsFile .