Get-AzSubscription

Uzyskaj subskrypcje, do których może uzyskiwać dostęp bieżące konto.

Składnia

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

Opis

Polecenie cmdlet Get-AzSubscription pobiera identyfikator subskrypcji, nazwę subskrypcji i dzierżawę główną dla subskrypcji, do których może uzyskać dostęp bieżące konto.

Przykłady

Przykład 1. Pobieranie wszystkich subskrypcji we wszystkich dzierżawach

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

To polecenie pobiera wszystkie subskrypcje we wszystkich dzierżawach, które są autoryzowane dla bieżącego konta.

Przykład 2. Pobieranie wszystkich subskrypcji dla określonej dzierżawy

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

Wyświetl listę wszystkich subskrypcji w danej dzierżawie, które są autoryzowane dla bieżącego konta.

Przykład 3. Pobieranie wszystkich subskrypcji w bieżącej dzierżawie

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

To polecenie pobiera wszystkie subskrypcje w bieżącej dzierżawie, które są autoryzowane dla bieżącego użytkownika.

Przykład 4. Zmiana bieżącego kontekstu na użycie określonej subskrypcji

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

To polecenie pobiera określoną subskrypcję, a następnie ustawia bieżący kontekst, aby go używać. Wszystkie kolejne polecenia cmdlet w tej sesji domyślnie używają nowej subskrypcji (Contoso Subscription 1).

Parametry

-AsJob

Uruchom polecenie cmdlet w tle i zwróć zadanie, aby śledzić postęp.

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

-DefaultProfile

Poświadczenia, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Określa identyfikator subskrypcji do pobrania.

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

-SubscriptionName

Określa nazwę subskrypcji do pobrania.

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

-TenantId

Określa identyfikator dzierżawy, która zawiera subskrypcje do pobrania.

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

Dane wejściowe

String

Dane wyjściowe

PSAzureSubscription