Condividi tramite


Get-AzSubscription

Ottenere le sottoscrizioni a cui l'account corrente può accedere.

Sintassi

ListByIdInTenant (Impostazione predefinita)

Get-AzSubscription
    [-SubscriptionId <String>]
    [-TenantId <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ListByNameInTenant

Get-AzSubscription
    [-SubscriptionName <String>]
    [-TenantId <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Descrizione

Il cmdlet Get-AzSubscription ottiene l'ID sottoscrizione, il nome della sottoscrizione e il tenant principale per le sottoscrizioni a cui l'account corrente può accedere.

Esempio

Esempio 1: Ottenere tutte le sottoscrizioni in tutti i tenant

Get-AzSubscription
Name                               Id                      TenantId                        State
----                               --                      --------                        -----
Subscription1                      yyyy-yyyy-yyyy-yyyy     aaaa-aaaa-aaaa-aaaa             Enabled
Subscription2                      xxxx-xxxx-xxxx-xxxx     aaaa-aaaa-aaaa-aaaa             Enabled
Subscription3                      zzzz-zzzz-zzzz-zzzz     bbbb-bbbb-bbbb-bbbb             Enabled

Questo comando ottiene tutte le sottoscrizioni in tutti i tenant autorizzati per l'account corrente.

Esempio 2: Ottenere tutte le sottoscrizioni per un tenant specifico

Get-AzSubscription -TenantId "aaaa-aaaa-aaaa-aaaa"
Name                               Id                      TenantId                        State
----                               --                      --------                        -----
Subscription1                      yyyy-yyyy-yyyy-yyyy     aaaa-aaaa-aaaa-aaaa             Enabled
Subscription2                      xxxx-xxxx-xxxx-xxxx     aaaa-aaaa-aaaa-aaaa             Enabled

Elencare tutte le sottoscrizioni nel tenant specificato autorizzate per l'account corrente.

Esempio 3: Ottenere tutte le sottoscrizioni nel tenant corrente

Get-AzSubscription -TenantId (Get-AzContext).Tenant
Name                               Id                      TenantId                        State
----                               --                      --------                        -----
Subscription1                      yyyy-yyyy-yyyy-yyyy     aaaa-aaaa-aaaa-aaaa             Enabled
Subscription2                      xxxx-xxxx-xxxx-xxxx     aaaa-aaaa-aaaa-aaaa             Enabled

Questo comando ottiene tutte le sottoscrizioni nel tenant corrente autorizzate per l'utente corrente.

Esempio 4: Modificare il contesto corrente per usare una sottoscrizione specifica

Get-AzSubscription -SubscriptionId "xxxx-xxxx-xxxx-xxxx" -TenantId "yyyy-yyyy-yyyy-yyyy" | Set-AzContext
Name                                     Account             SubscriptionName    Environment         TenantId
----                                     -------             ----------------    -----------         --------
Subscription1 (xxxx-xxxx-xxxx-xxxx)      azureuser@micros... Subscription1       AzureCloud          yyyy-yyyy-yyyy-yyyy

Questo comando ottiene la sottoscrizione specificata e quindi imposta il contesto corrente per usarlo. Per impostazione predefinita, tutti i cmdlet successivi in questa sessione usano la nuova sottoscrizione (Sottoscrizione Contoso 1).

Parametri

-AsJob

Eseguire il cmdlet in background e restituire un processo per tenere traccia dello stato di avanzamento.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

Credenziali, tenant e sottoscrizione usate per la comunicazione con Azure

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SubscriptionId

Specifica l'ID della sottoscrizione da ottenere.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ListByIdInTenant
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-SubscriptionName

Specifica il nome della sottoscrizione da ottenere.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ListByNameInTenant
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-TenantId

Specifica l'ID del tenant che contiene le sottoscrizioni da ottenere.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

Output

PSAzureSubscription