Bagikan melalui

Select-AzureSubscription

  • Referensi
Modul:
Azure

Mengubah langganan Azure saat ini dan default.

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

Select-AzureSubscription
      -SubscriptionName <String>
      [-Account <String>]
      [-Current]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      -SubscriptionName <String>
      [-Account <String>]
      [-Default]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      -SubscriptionId <String>
      [-Account <String>]
      [-Current]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      -SubscriptionId <String>
      [-Account <String>]
      [-Default]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      [-Account <String>]
      [-NoCurrent]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      [-Account <String>]
      [-NoDefault]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Deskripsi

Cmdlet Select-AzureSubscription menetapkan dan menghapus langganan Azure saat ini dan default.

"Langganan saat ini" adalah langganan yang digunakan secara default dalam sesi Windows PowerShell saat ini. "Langganan default" digunakan secara default di semua sesi Windows PowerShell. Label "langganan saat ini" memungkinkan Anda menentukan langganan lain yang akan digunakan secara default untuk sesi saat ini tanpa mengubah "langganan default" untuk semua sesi lainnya.

Penetapan langganan "default" disimpan dalam file data langganan Anda. Penetapan "saat ini" khusus sesi tidak disimpan.

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: Atur langganan saat ini

C:\PS> Select-AzureSubscription -Current -SubscriptionName ContosoEngineering

Perintah ini menjadikan "ContosoEngineering" sebagai langganan saat ini.

Contoh 2: Mengatur langganan default

C:\PS> Select-AzureSubscription -Default -SubscriptionName ContosoFinance -SubscriptionDataFile "C:\subs\MySubscriptions.xml"

Perintah ini mengubah langganan default menjadi "ContosoFinance." Ini menyimpan pengaturan dalam file data langganan Subscriptions.xml, bukan file data langganan default.

Parameter

-Account

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

-Current

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

-Default

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

-NoCurrent

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

-NoDefault

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

-PassThru

Mengembalikan $True jika perintah berhasil dan $False jika gagal. Secara default, cmdlet ini tidak mengembalikan output apa pun.

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:True
Terima input alur:True
Terima karakter wildcard:False

-SubscriptionName

Jenis:String
Alias:Name
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

Input

None

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

Output

None or System.Boolean

Jika Anda menggunakan parameter PassThru , cmdlet ini mengembalikan nilai Boolean. Secara default, ini tidak menghasilkan output apa pun.