Bagikan melalui

Get-AzureSubscription

  • Referensi
Modul:
Azure

Mendapatkan langganan Azure di akun Azure.

Catatan

Cmdlet yang dirujuk dalam dokumentasi ini adalah untuk mengelola sumber daya Azure warisan yang menggunakan API Manajemen Layanan. Lihat modul Az PowerShell untuk cmdlet guna mengelola sumber daya Azure Resource Manager.

Sintaks

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

Deskripsi

Cmdlet Get-AzureSubscription mendapatkan langganan di akun Azure Anda. Anda dapat menggunakan cmdlet ini untuk mendapatkan informasi tentang langganan dan untuk menyalurkan langganan ke cmdlet lain.

Get-AzureSubscription memerlukan akses ke akun Azure Anda. Sebelum menjalankan Get-AzureSubscription, Anda harus menjalankan cmdlet Add-AzureAccount atau cmdlet yang mengunduh dan menginstal file pengaturan penerbitan (Get-AzurePublishSettingsFile, Import-AzurePublishSettingsFile.

Topik ini menjelaskan cmdlet dalam modul Microsoft Azure PowerShell versi 0.8.10. Untuk mendapatkan versi modul yang Anda gunakan, di konsol Azure PowerShell, ketik (Get-Module -Name Azure).Version.

Contoh

Contoh 1: Mendapatkan semua langganan

C:\PS>Get-AzureSubscription

Perintah ini mendapatkan semua langganan di akun.

Contoh 2: Mendapatkan langganan berdasarkan nama

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

Perintah ini hanya mendapatkan langganan "MyProdSubsciption".

Contoh 3: Dapatkan langganan default

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

Perintah ini hanya mendapatkan nama langganan default. Perintah pertama-tama mendapatkan langganan lalu menggunakan metode titik untuk mendapatkan properti SubscriptionName langganan.

Contoh 4: Mendapatkan properti langganan yang dipilih

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

Perintah ini mengembalikan daftar dengan nama dan sertifikat langganan saat ini. Ini menggunakan perintah Get-AzureSubscription untuk mendapatkan langganan saat ini. Kemudian menyalurkan langganan ke perintah Format-Daftar yang menampilkan properti yang dipilih dalam daftar.

Contoh 5: Menggunakan file data langganan alternatif

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

Perintah ini mendapatkan langganan dari file data langganan C:\Temp\MySubscriptions.xml. Gunakan parameter SubscriptionDataFile jika Anda menentukan file data langganan alternatif saat Anda menjalankan cmdlet Add-AzureAccount atau Import-PublishSettingsFile.

Parameter

-Current

Hanya mendapatkan langganan saat ini, yaitu, langganan yang ditetapkan sebagai "saat ini." Secara default, Get-AzureSubscription mendapatkan semua langganan di akun Azure Anda. Untuk menunjuk langganan sebagai "saat ini", gunakan parameter saat ini dari cmdlet Select-AzureSubscription .

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

-Default

Hanya mendapatkan langganan default, yaitu, langganan yang ditetapkan sebagai "default." Secara default, Get-AzureSubscription mendapatkan semua langganan di akun Azure Anda. Untuk menunjuk langganan sebagai "default", gunakan parameter Default cmdlet Select-AzureSubscription .

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

-ExtendedDetails

Mengembalikan informasi kuota untuk langganan, selain pengaturan standar.

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

-Profile

Menentukan profil Azure tempat cmdlet ini dibaca. Jika Anda tidak menentukan profil, cmdlet ini akan membaca dari profil default lokal.

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

-SubscriptionId

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

-SubscriptionName

Hanya mendapatkan langganan yang ditentukan. Masukkan nama langganan. Nilai ini peka huruf besar/kecil. Karakter kartubebas tidak didukung. Secara default, Get-AzureSubscription mendapatkan semua langganan di akun Azure Anda.

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

Input

None

Anda dapat menyalurkan input ke properti SubscriptionName berdasarkan nama, tetapi tidak berdasarkan nilai.

Output

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureSubscription

Catatan

  • Get-AzureSubscription mendapatkan data dari file data langganan yang dibuat cmdlet Add-AzureAccount dan Import-PublishSettingsFile .