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

  • Makale

Önemli

Azure AD Powershell'in 30 Mart 2024'te kullanımdan kaldırılması planlanmaktadır. Kullanımdan kaldırma planları hakkında daha fazla ayrıntı için bkz. kullanımdan kaldırma güncelleştirmesi. Azure AD etkileşime geçmek için önerilen modül olan Microsoft Graph PowerShell'e geçiş yapmaya devam etmenizi öneririz. Buna ek olarak, Microsoft Graph PowerShell tüm Microsoft Graph API'lerine erişmenizi sağlar ve PowerShell 7'de kullanılabilir. Sık sık yapılan geçiş sorgularının yanıtları için bkz . Geçiş hakkında SSS.

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ü. Üretim senaryoları için Genel Önizleme sürümünün kullanılması önerilmez.

modüllerini PowerShell Galerisi indirin ve 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: graph için azure active directory powershell: sürüm sürüm 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 öğe 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 ayrıca .NET Framework 4.5 veya üzerini gerektirir. .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ızda 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 yeni.

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. Ardından 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 farklı adlandırma kurallarına sahip cmdlet'lerden oluşur. -AzureAD Cmdlet'ler -AzureAD Microsoft Graph uç noktasına https://graph.windows.net çağrı yaparken -AzureADMS 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 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