Add-AzureAccount

  • Referensi
Modul:
Azure

Menambahkan akun Azure ke 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

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-AzurePublish Pengaturan File, yang menggunakan sertifikat manajemen. Untuk panduan tentang metode mana yang akan digunakan, lihat Cara: Koneksi 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

Type:PSCredential
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
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

-ServicePrincipal

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

-Tenant

Type:String
Aliases:TenantId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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-AzurePublish Pengaturan (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.