다음을 통해 공유

Get-AzureSubscription

  • 참조
모듈:
Azure

Azure 계정에서 Azure 구독을 가져옵니다.

참고 항목

이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.

Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.

구문

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

Description

Get-AzureSubscription cmdlet은 Azure 계정의 구독을 가져옵니다. 이 cmdlet을 사용하여 구독에 대한 정보를 얻고 구독을 다른 cmdlet으로 파이프할 수 있습니다.

Get-AzureSubscription 을 사용하려면 Azure 계정에 대한 액세스 권한이 필요합니다. Get-AzureSubscription을 실행하기 전에 게시 설정 파일(Get-AzurePublishSettingsFile, Import-AzurePublishSettingsFile)을 다운로드하고 설치하는 Add-AzureAccount cmdlet 또는 cmdlet을 실행해야 합니다.

이 항목에서는 Microsoft Azure PowerShell 모듈의 0.8.10 버전에 있는 cmdlet에 대해 설명합니다. 사용 중인 모듈의 버전을 얻으려면 Azure PowerShell 콘솔에서 다음을 입력합니다 (Get-Module -Name Azure).Version.

예제

예제 1: 모든 구독 가져오기

C:\PS>Get-AzureSubscription

이 명령은 계정의 모든 구독을 가져옵니다.

예제 2: 이름으로 구독 가져오기

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

이 명령은 "MyProdSubsciption" 구독만 가져옵니다.

예제 3: 기본 구독 가져오기

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

이 명령은 기본 구독의 이름만 가져옵니다. 이 명령은 먼저 구독을 가져오고 dot 메서드를 사용하여 구독의 SubscriptionName 속성을 가져옵니다.

예제 4: 선택한 구독 속성 가져오기

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

이 명령은 현재 구독의 이름과 인증서가 있는 목록을 반환합니다. Get-AzureSubscription 명령을 사용하여 현재 구독을 가져옵니다. 그런 다음 목록에서 선택한 속성을 표시하는 Format-List 명령으로 구독을 파이프합니다.

예제 5: 대체 구독 데이터 파일 사용

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

이 명령은 C:\Temp\MySubscriptions.xml 구독 데이터 파일에서 구독을 가져옵니다. Add-AzureAccount 또는 Import-PublishSettingsFile cmdlet을 실행할 때 대체 구독 데이터 파일을 지정한 경우 SubscriptionDataFile 매개 변수를 사용합니다.

매개 변수

-Current

현재 구독, 즉 "현재"로 지정된 구독만 가져옵니다. 기본적으로 Get-AzureSubscription 은 Azure 계정의 모든 구독을 가져옵니다. 구독을 "현재"로 지정하려면 Select-AzureSubscription cmdlet의 현재 매개 변수를 사용합니다.

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

-Default

기본 구독, 즉 "기본값"으로 지정된 구독만 가져옵니다. 기본적으로 Get-AzureSubscription 은 Azure 계정의 모든 구독을 가져옵니다. 구독을 "기본값"으로 지정하려면 Select-AzureSubscription cmdlet의 Default 매개 변수를 사용합니다.

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

-ExtendedDetails

표준 설정 외에도 구독에 대한 할당량 정보를 반환합니다.

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

-Profile

이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.

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

-SubscriptionId

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

-SubscriptionName

지정된 구독만 가져옵니다. 구독 이름을 입력합니다. 이 값은 대/소문자를 구분합니다. 와일드카드 문자는 지원되지 않습니다. 기본적으로 Get-AzureSubscription 은 Azure 계정의 모든 구독을 가져옵니다.

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

입력

None

이름으로는 입력을 SubscriptionName 속성으로 파이프할 수 있지만 값으로는 파이프할 수 없습니다.

출력

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureSubscription

참고

  • Get-AzureSubscription은 Add-AzureAccount 및 Import-PublishSettingsFile cmdlet이 만드는 구독 데이터 파일에서 데이터를 가져옵니다.