Menginstal Azure Active Directory PowerShell untuk Graph

  • Artikel

Penting

Azure AD Powershell direncanakan untuk dihentikan pada 30 Maret 2024. Untuk detail selengkapnya tentang rencana penghentian, lihat pembaruan penghentian. Kami mendorong Anda untuk terus bermigrasi ke Microsoft Graph PowerShell, yang merupakan modul yang direkomendasikan untuk berinteraksi dengan Azure AD. Selain itu, Microsoft Graph PowerShell memungkinkan Anda mengakses semua MICROSOFT Graph API dan tersedia di PowerShell 7. Untuk jawaban atas kueri migrasi yang sering, lihat Tanya Jawab Umum Migrasi.

Anda dapat menggunakan versi modul Azure Active Directory PowerShell untuk Graph untuk tugas administratif Azure AD seperti manajemen pengguna, manajemen domain, dan untuk mengonfigurasi akses menyeluruh. Cmdlet yang tercantum di sini berbeda dari cmdlet MSOnline yang merupakan bagian dari Azure Active Directory PowerShell versi 1.0.

Modul Azure AD PowerShell for Graph memiliki dua versi: versi Pratinjau Umum dan versi Ketersediaan Umum (GA). Tidak disarankan untuk menggunakan versi Pratinjau Publik untuk skenario produksi.

Unduh modul dari Galeri PowerShell menggunakan yang berikut ini;

Riwayat versi rilis Azure Active Directory PowerShell for Graph

Riwayat rilis untuk modul Azure AD dan modul Pratinjau Azure AD ada di sini:azure active directory powershell untuk grafik: riwayat rilis versi.

Menginstal Modul Azure AD

Prasyarat

Modul Azure AD didukung pada sistem operasi Windows berikut dengan versi default Microsoft .NET Framework dan Windows PowerShell:

  • Windows 8.1
  • Windows 8
  • Windows 7
  • Windows Server 2012 R2,
  • Windows Server 2012
  • Windows Server 2008 R2.

Catatan

Modul Azure AD PowerShell tidak kompatibel dengan PowerShell 7. Ini hanya didukung di PowerShell 5.1.

Untuk menginstal versi Ketersediaan Umum modul, jalankan:

Install-Module AzureAD

Untuk menginstal rilis pratinjau publik, jalankan:

Install-module AzureADPreview

Anda tidak dapat menginstal versi pratinjau dan versi GA pada komputer yang sama secara bersamaan.

Modul Azure AD didistribusikan menggunakan Galeri PowerShell. Menginstal item dari galeri memerlukan versi terbaru modul PowerShellGet, yang tersedia di Windows 10, di Windows Management Framework (WMF) 5.0, atau di penginstal berbasis MSI (untuk PowerShell 3 dan 4).

Dengan modul PowerShellGet terbaru, Anda dapat:

Lihat halaman Memulai untuk informasi selengkapnya tentang cara menggunakan perintah PowerShellGet dengan Galeri. Anda juga dapat menjalankan Update-Help -Module PowerShellGet untuk menginstal bantuan lokal untuk perintah ini.

Sistem Operasi yang Didukung

Modul PowerShellGet memerlukan PowerShell 3.0 atau yang lebih baru.

Oleh karena itu, PowerShellGet memerlukan salah satu sistem operasi berikut:

  • Windows 10
  • Windows 8.1 Pro
  • Windows 8.1 Enterprise
  • Windows 7 SP1
  • Windows Server 2016 TP5
  • Windows Server 2012 R2
  • Windows Server 2008 R2 SP1

PowerShellGet juga memerlukan .NET Framework 4.5 atau lebih tinggi. Anda dapat menginstal .NET Framework 4.5 atau lebih tinggi dari sini.

Memperbarui Modul Azure AD

Untuk memeriksa versi modul yang diinstal pada komputer Anda, jalankan perintah ini:

Get-Module AzureADPreview

ModuleType Version Name                ExportedCommands
---------- ------- ----                ----------------
Binary     2.0.0.7 azureadpreview     {Add-AzureADAdmini...

Untuk memperbarui versi modul Azure AD PowerShell di komputer Anda, jalankan ulang cmdlet Install-Module:

Install-Module AzureADPreview

Perintah ini memeriksa galeri PowerShell untuk melihat apakah versi yang lebih baru tersedia. Jika ya, yang lebih baru dari yang terinstal di komputer Anda.

Menyambungkan ke Microsoft Azure Active Directory

Sebelum Anda dapat menjalankan salah satu cmdlet yang dibahas dalam artikel ini, Anda harus terlebih dahulu terhubung ke layanan online Anda. Untuk melakukannya, jalankan cmdlet Connect-AzureAD di prompt perintah Windows PowerShell. Anda kemudian akan dimintai kredensial Anda. Jika mau, Anda dapat memberikan kredensial terlebih dahulu, misalnya:

$AzureAdCred = Get-Credential
Connect-AzureAD -Credential $AzureAdCred

Perintah pertama meminta kredensial dan menyimpannya sebagai $AzureAdCred. Perintah berikutnya menggunakan kredensial tersebut sebagai $azureadcred untuk menyambungkan ke layanan.

Catatan

Modul Pratinjau Azure AD dan Azure AD terdiri dari cmdlet dengan konvensi penamaan yang berbeda yaitu -AzureAD dan -AzureADMS. -AzureAD Cmdlet tersambung ke titik https://graph.windows.net akhir Azure AD Graph saat -AzureADMS cmdlet melakukan panggilan ke titik graph.microsoft.comakhir Microsoft Graph . Autentikasi ditangani secara diam-diam saat Anda mengubah panggilan dari satu titik akhir ke titik akhir lainnya dan Anda tidak dimintai kredensial lagi.

Untuk menyambungkan ke lingkungan tertentu dari Azure Active Directory, gunakan parameter AzureEnvironment , sebagai berikut:

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

Contoh ini menyambungkan sesi PowerShell Anda ke lingkungan AzureAD Jerman. Lihat Connect-AzureAD untuk informasi selengkapnya.

Langkah berikutnya