Remove-AzureSubscription
Menghapus langganan Azure dari Windows PowerShell.
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
Remove-AzureSubscription
-SubscriptionName <String>
[-Force]
[-PassThru]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzureSubscription
-SubscriptionId <String>
[-Force]
[-PassThru]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Cmdlet Remove-AzureSubscription menghapus langganan Azure dari file data langganan Anda sehingga Windows PowerShell tidak dapat menemukannya. Cmdlet ini tidak menghapus langganan dari Microsoft Azure, atau mengubah langganan aktual dengan cara apa pun.
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: Menghapus langganan
C:\PS> Remove-AzureSubscription -SubscriptionName Test
Confirm
Are you sure you want to perform this action?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
Perintah ini menghapus langganan "Uji" dari file data langganan default.
Contoh 2: Menghapus dari file data langganan alternatif
C:\PS> Remove-AzureSubscription -SubscriptionName Test -SubscriptionDataFile C:\Subs\MySubscriptions.xml -Force
Perintah ini menghapus langganan Uji dari file data langganan MySubscriptions.xml. Perintah menggunakan parameter Force untuk menekan prompt konfirmasi.
Contoh 3: Menghapus langganan dalam skrip
C:\PS> ...if (Remove-AzureSubscription -SubscriptionName Test -PassThru) {...}
Perintah ini menggunakan perintah Remove-AzureSubscription dalam pernyataan If . Ini menggunakan parameter PassThru , yang mengembalikan nilai Boolean, untuk menentukan apakah blok skrip dalam pernyataan If dijalankan.
Parameter
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
Jenis: | SwitchParameter |
Alias: | cf |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Force
Menekan prompt konfirmasi.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
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 |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Jenis: | SwitchParameter |
Alias: | wi |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
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. Jika tidak, itu tidak mengembalikan output apa pun.