Graph için Azure Active Directory PowerShell'i yükleme

Kullanıcı yönetimi, etki alanı yönetimi ve çoklu oturum açmayı yapılandırma gibi Azure AD yönetim görevleri için Graph için Azure Active Directory PowerShell modülü sürümünü kullanabilirsiniz. Burada listelenen cmdlet'ler, Azure Active Directory PowerShell sürüm 1.0'ın parçası olan MSOnline cmdlet'lerinden farklıdır.

Graph için PowerShell modülünün Azure AD iki sürümü vardır: Genel Önizleme sürümü ve Genel Kullanılabilirlik (GA) sürümü. Genel Önizleme sürümünün üretim senaryolarında kullanılması önerilmez.

modülleri PowerShell Galerisi indirmek için aşağıdakileri kullanın;

Graph için Azure Active Directory PowerShell sürüm geçmişi

Azure AD modülünün ve Azure AD Önizleme modülünün yayın geçmişi şu şekildedir: graf için azure active directory powershell: sürüm yayın geçmişi.

Azure AD Modülünü yükleme

Önkoşullar

Azure AD modülü, microsoft .NET Framework ve Windows PowerShell varsayılan sürümüyle aşağıdaki Windows işletim sistemlerinde desteklenir:

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

Not

Azure AD PowerShell modülü PowerShell 7 ile uyumlu değildir. Yalnızca PowerShell 5.1'de desteklenir.

Modülün Genel Kullanılabilirlik sürümünü yüklemek için şunu çalıştırın:

Install-Module AzureAD

Genel önizleme sürümünü yüklemek için şunu çalıştırın:

Install-module AzureADPreview

Hem önizleme sürümünü hem de GA sürümünü aynı bilgisayara aynı anda yükleyemezsiniz.

Azure AD modülü PowerShell Galerisi kullanılarak dağıtılır. Galeriden öğeleri yüklemek için Windows 10, Windows Management Framework (WMF) 5.0 veya MSI tabanlı yükleyicide (PowerShell 3 ve 4 için) kullanılabilen PowerShellGet modülünün en son sürümü gerekir.

En son PowerShellGet modülüyle şunları yapabilirsiniz:

Galeri ile PowerShellGet komutlarını kullanma hakkında daha fazla bilgi için Başlarken sayfasına bakın. Ayrıca Update-Help -Module PowerShellGet komutunu çalıştırarak bu komutlara ilişkin yerel yardımı yükleyebilirsiniz.

Desteklenen İşletim Sistemleri

PowerShellGet modülü PowerShell 3.0 veya daha yeni bir sürümü gerektirir.

Bu nedenle, PowerShellGet aşağıdaki işletim sistemlerinden birini gerektirir:

  • 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 için .NET Framework 4.5 veya üzeri de gerekir. .NET Framework 4.5 veya üzeri sürümü buradan yükleyebilirsiniz.

Azure AD Modülünü güncelleştirme

Bilgisayarınızda yüklü modülün sürümünü denetlemek için şu komutu çalıştırın:

Get-Module AzureADPreview

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

Bilgisayarınızdaki Azure AD PowerShell modülünün sürümünü güncelleştirmek için Install-Module cmdlet’ini yeniden çalıştırın:

Install-Module AzureADPreview

Bu komut, daha yeni bir sürümün kullanılabilir olup olmadığını görmek için PowerShell galerisini denetler. Evet ise, bilgisayarınızda yüklü olandan daha yenidir.

Azure AD'ye Bağlanma

Bu makalede ele alınan cmdlet’lerin herhangi birini çalıştırabilmeniz için öncelikle çevrimiçi hizmetinize bağlanmanız gerekir. Bunu yapmak için Windows PowerShell komut isteminde Connect-AzureAD cmdlet'ini çalıştırın. Bundan sonra kimlik bilgileriniz istenir. İsterseniz, kimlik bilgilerinizi önceden belirtebilirsiniz, örneğin:

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

İlk komut kimlik bilgilerini ister ve $AzureAdCred olarak depolar. Sonraki komut, hizmete bağlanmak için bu kimlik bilgilerini $azureadcred olarak kullanır.

Not

Azure AD ve Azure AD Önizleme modülleri, ve -AzureADMSgibi -AzureAD farklı adlandırma kurallarına sahip cmdlet'lerden oluşur. Cmdlet'ler -AzureAD Microsoft Graph uç noktasına https://graph.windows.net-AzureADMS çağrı yaparken cmdlet'ler Azure AD Graph uç noktasına graph.microsoft.combağlanır. Kimlik doğrulaması, çağrıları bir uç noktadan diğerine değiştirdiğinizde sessizce işlenir ve sizden kimlik bilgileri yeniden istenmez.

Azure Active Directory'nin belirli bir ortamına bağlanmak için AzureEnvironment parametresini aşağıdaki gibi kullanın:

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

Bu örnek PowerShell oturumunuzu Alman AzureAD ortamına bağlar. Daha fazla bilgi için bkz. Connect-AzureAD.

Sonraki adımlar