Select-AzureSubscription
Mengubah langganan Azure saat ini dan default.
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
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
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Current
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Default
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoCurrent
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoDefault
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Mengembalikan $True jika perintah berhasil dan $False jika gagal. Secara default, cmdlet ini tidak mengembalikan output apa pun.
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: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SubscriptionName
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.