다음을 통해 공유


Get-AzSubscription

현재 계정에서 액세스할 수 있는 구독을 가져옵니다.

구문

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

Description

Get-AzSubscription cmdlet은 현재 계정에서 액세스할 수 있는 구독에 대한 구독 ID, 구독 이름 및 홈 테넌트를 가져옵니다.

예제

예제 1: 모든 테넌트에서 모든 구독 가져오기

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

이 명령은 현재 계정에 대해 권한이 부여된 모든 테넌트에서 모든 구독을 가져옵니다.

예제 2: 특정 테넌트에 대한 모든 구독 가져오기

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

현재 계정에 대해 권한이 부여된 지정된 테넌트에 있는 모든 구독을 나열합니다.

예제 3: 현재 테넌트에서 모든 구독 가져오기

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

이 명령은 현재 사용자에 대해 권한이 부여된 현재 테넌트에 있는 모든 구독을 가져옵니다.

예제 4: 특정 구독을 사용하도록 현재 컨텍스트 변경

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

이 명령은 지정된 구독을 가져오고 이를 사용하도록 현재 컨텍스트를 설정합니다. 이 세션의 모든 후속 cmdlet은 기본적으로 새 구독(Contoso 구독 1)을 사용합니다.

매개 변수

-AsJob

백그라운드에서 cmdlet을 실행하고 작업을 반환하여 진행률을 추적합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 테넌트 및 구독

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SubscriptionId

가져올 구독의 ID를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-SubscriptionName

가져올 구독의 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-TenantId

가져올 구독이 포함된 테넌트 ID를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

String

출력

PSAzureSubscription