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 Azure Service Manager (ASM). Modul PowerShell warisan ini tidak disarankan saat membuat sumber daya baru karena ASM dijadwalkan untuk dihentikan. Untuk informasi selengkapnya, lihat Penghentian Azure Service Manager.

Modul Az PowerShell adalah modul PowerShell yang direkomendasikan untuk mengelola sumber daya Azure Resource Manager (ARM) dengan PowerShell.

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 .

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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 .

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ExtendedDetails

Mengembalikan informasi kuota untuk langganan, selain pengaturan standar.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Profile

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

Jenis:AzureSMProfile
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SubscriptionId

Jenis:String
Alias:Id
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard: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.

Jenis:String
Alias:Name
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard: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 .