Add-AzureAccount
Menambahkan akun Azure ke 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
Add-AzureAccount
[-Environment <String>]
[-Credential <PSCredential>]
[-Tenant <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Add-AzureAccount
[-Environment <String>]
-Credential <PSCredential>
[-ServicePrincipal]
-Tenant <String>
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Deskripsi
Cmdlet Add-AzureAccount membuat akun Azure Anda dan langganannya tersedia di Windows PowerShell. Ini seperti masuk ke akun Azure Anda di Windows PowerShell. Untuk keluar dari akun, gunakan cmdlet Remove-AzureAccount .
Add-AzureAccount mengunduh informasi tentang akun Azure Anda dan menyimpannya dalam file data langganan di profil pengguna roaming Anda. Ini juga mendapatkan token akses yang memungkinkan Windows PowerShell mengakses akun Azure Anda atas nama Anda. Saat perintah selesai, Anda dapat mengelola akun Azure di Windows PowerShell.
Ada dua cara berbeda untuk membuat akun Azure Anda tersedia untuk Windows PowerShell. Anda dapat menggunakan cmdlet Add-AzureAccount , yang menggunakan token akses autentikasi Microsoft Entra, atau Import-AzurePublishSettingsFile, yang menggunakan sertifikat manajemen. Untuk panduan tentang metode mana yang akan digunakan, lihat Cara: Menyambungkan ke langganan Anda (https://azure.microsoft.com/documentation/articles/install-configure-powershell/#Connect).
Saat Anda menjalankan Add-AzureAccount, itu menampilkan jendela interaktif yang meminta Anda untuk masuk ke akun Azure Anda. Rincian masuk ini berlaku hingga token akses kedaluwarsa. Saat kedaluwarsa, cmdlet yang memerlukan akses ke akun Anda meminta Anda untuk menjalankan Add-AzureAccount lagi.
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: Menambahkan akun
PS C:\> Add-AzureAccount
Perintah ini menambahkan akun Azure ke Windows PowerShell. Saat Anda menjalankan perintah, jendela muncul untuk meminta nama pengguna dan kata sandi akun.
Contoh 2: Menggunakan file data langganan alternatif
PS C:\> Add-AzureAccount -SubscriptionDataFile C:\Testing\SDF.xml
Perintah ini menggunakan parameter SubscriptionDataFile untuk mengarahkan Add-AzureAccount untuk menyimpan data akun dalam file C:\Testing\SDF.xml, bukan file default.
Parameter
-Credential
Jenis: | PSCredential |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Environment
Menentukan lingkungan Azure.
Lingkungan Azure merupakan penyebaran independen Microsoft Azure, seperti AzureCloud untuk Azure global dan AzureChinaCloud untuk Azure yang dioperasikan oleh 21Vianet di Tiongkok. Anda juga dapat membuat lingkungan Azure lokal dengan menggunakan Azure Pack dan cmdlet WAPack. Untuk informasi selengkapnya, lihat Azure Pack.
Jenis: | String |
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 |
-ServicePrincipal
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Tenant
Jenis: | String |
Alias: | TenantId |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
Input
None
Anda tidak dapat menyalurkan input ke cmdlet ini
Output
None
Cmdlet ini tidak mengembalikan output apa pun.
Catatan
- Add-AzureAccount (dan metode autentikasi Microsoft Entra) lebih diutamakan daripada Import-AzurePublishSettings (dan metode sertifikat manajemen). Jika Anda menggunakan Add-AzureAccount bahkan sekali di akun Anda, metode autentikasi Microsoft Entra digunakan dan sertifikat manajemen diabaikan. Untuk menghapus token Microsoft Entra dan memulihkan metode sertifikat manajemen, gunakan cmdlet Remove-AzureAccount . Untuk informasi selengkapnya, ketik: Get-Help Remove-AzureAccount.
- Kesalahan, "Kredensial Anda telah kedaluwarsa. Silakan gunakan Add-AzureAccount untuk masuk lagi." menunjukkan bahwa token akses Anda kedaluwarsa dan Windows PowerShell tidak dapat mengakses akun Azure Anda. Untuk memulihkan akses ke akun Anda, jalankan Add-AzureAccount lagi.
- Akun Azure PowerShell dan cmdlet langganan mendapatkan data mereka dari file data langganan, bukan dari akun Azure langsung. Jika Anda mengubah akun atau langganan di luar Windows PowerShell, seperti dengan menggunakan Portal Manajemen Azure, jalankan Add-AzureAccount lagi untuk merefresh file data langganan.