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 Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

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 .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExtendedDetails

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SubscriptionId

Tipo:String
Alias:Id
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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.

Tipo:String
Alias:Name
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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 .