Share via

Remove-AzureAccount

  • Referensi
Modul:
Azure

Menghapus akun Azure dari Windows PowerShell.

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

Remove-AzureAccount
      -Name <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Cmdlet Remove-AzureAccount menghapus akun Azure dan langganannya dari file data langganan di profil pengguna roaming Anda. Ini tidak menghapus akun dari Microsoft Azure, atau mengubah akun aktual dengan cara apa pun.

Menggunakan cmdlet ini sangat mirip dengan keluar dari akun Azure Anda. Dan, jika Anda ingin masuk ke akun lagi, gunakan Add-AzureAccount atau Import-AzurePublishSettingsFile untuk menambahkan akun ke Windows PowerShell lagi.

Anda juga dapat menggunakan cmdlet Remove-AzureAccount untuk mengubah cara cmdlet Azure PowerShell masuk ke akun Azure Anda. Jika akun Anda memiliki sertifikat manajemen dari Import-AzurePublishSettingsFile dan token akses dari Add-AzureAccount, cmdlet Azure PowerShell hanya menggunakan token akses; mereka mengabaikan sertifikat manajemen. Untuk menggunakan sertifikat manajemen, jalankan Remove-AzureAccount. Saat Remove-AzureAccount menemukan sertifikat manajemen dan token akses, itu hanya menghapus token akses, alih-alih menghapus akun. Sertifikat manajemen masih ada, sehingga akun masih tersedia untuk Windows PowerShell.

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 akun

PS C:\> Remove-AzureAccount -Name admin@contoso.com

Perintah ini menghapus admin@contoso.com dari file data langganan Anda. Ketika perintah selesai, akun tidak lagi tersedia untuk Windows PowerShell.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-Force

Menekan prompt konfirmasi. Secara default, Remove-AzureAccount meminta Anda sebelum menghapus akun dari Windows PowerShell.

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

-Name

Menentukan nama akun yang akan dihapus. Nilai parameter peka huruf besar/kecil. Karakter kartubebas tidak didukung.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
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. Jika tidak, itu tidak mengembalikan output apa pun.