Microsoft Graph PowerShell Modülü Nasıl Kurulur

Microsoft Graph PowerShell modülü, Microsoft bulut hizmetlerinizi komut satırı aracılığıyla yönetmek için tercih edilen yöntemdir. İzinleriniz üzerinde ayrıntılı kontrol sağlamanıza olanak tanırken güçlü, çok yönlü ve özellik erişimli bir deneyim sunar.

Yazıda neden geleneksel PowerShell modülleri yerine MS Graph PowerShell modülünü kullanmanız gerektiğini açıklayacağım ve ayrıca MS Graph PowerShell'i nasıl kuracağınızı göstereceğim.

Microsoft Graph'ı neden mevcut AzureAD ve MSOnline PowerShell modülleri yerine kullanmalısınız?

Mevcut Azure AD ve MSOnline modüllerinin amortismanı planlanıyor ve bunun gerçekleşmesi için somut bir zaman olmasa da 2023 ortası olması muhtemel. Bu birkaç anlama geliyor…

Öncelikle Microsoft Graph'ta beceri kazanmalısınız. Temel kavramlar aynı olmasına rağmen aşina olmadığınız birçok farklı komut vardır.

İkinci olarak, çalıştırdığınız mevcut komut dosyalarının Microsoft Graph'a dönüştürülmesi gerekecektir.

Mevcut PowerShell betiklerini Microsoft Graph'a dönüştürme

Şu anda mevcut PowerShell betiklerinizi Microsoft Graph biçimine dönüştürmenin otomatik bir yolu yoktur. Ancak çoğu durumda komutlar yeniden adlandırıldığından, fazla çalışma gerektirmeden tüm komut dosyaları kolayca yeni formata güncellenebilir.

Örneğin, Azure AD PowerShell'de çalışıyorsanız ve Azure AD'deki tüm uygulamaların bir listesini almak için Get-AzureADApplication'ı çalıştırdıysanız, Microsoft Graph'ta Get-MgApplication'ı çalıştırırsınız. Çoğunlukla bu kural çoğu cmdlet'e uygulanabilir.

Microsoft'un mevcut cmdlet'leri Microsoft Graph ile eşlemeye ayrılmış bir sayfası vardır: cmdlet haritası.

'Connect-mggraph' terimi tanınmıyor nasıl düzeltilir?

Bazı durumlarda Microsoft Graph'a PowerShell aracılığıyla bağlanmaya çalışıyor ve connect cmdlet'ini çalıştırmaya çalışırken aşağıdaki hatayı alıyor olabilirsiniz:

connect-mggraph : 'connect-mggraph' terimi bir cmdlet'in, işlevin, komut dosyasının veya
çalıştırılabilir program. Adın yazılışını kontrol edin veya bir yol eklenmişse yolun doğru olduğunu doğrulayın ve tekrar deneyin.

Bu hatayı alıyorsanız büyük olasılıkla Microsoft Graph yüklü değildir veya sisteminizde PowerShell'in yanlış sürümünü kullanıyorsunuzdur. Ayrıca, daha önce yalnızca geçerli kullanıcı bağlamı için yüklemiş olabilirsiniz ve şimdi farklı bir hesapla oturum açmış olabilirsiniz. Nasıl çözüleceğini öğrenmek için sonraki bölüme bakın.

Önkoşullar

Kurulumdan önce ulaşmanız gereken bazı gerekli önkoşullar vardır; bunlar arasında şunlar yer alır:

• PowerShell 5.1 veya sonraki bir sürümünün yüklü olması gerekir
• .NET Framework 4.7.2 veya sonraki sürümünün yüklü olması gerekir
• PowerShellGet'in en son sürümü yüklü olmalıdır.

PowerShell komut dosyası yürütme işlemi ayrıca uzaktan imzalı veya daha az kısıtlayıcıdır.

PowerShell sürümünüzü kontrol edin ve yükseltin

Hangi PowerShell sürümünü yüklediğinizi kontrol etmek için iş istasyonunuzda PowerShell'i açın ve şu komutu yazın: $PSVersionTable.PSVersion

Ekran görüntüsünden görebileceğiniz gibi 5.1 sürümünü çalıştırıyorum. PowerShell 7 veya üzeri önerildiği için en son sürüme güncelleme yapacağım. Bu adımı tamamlamak için iş istasyonunuzda yerel yönetici olmanız gerekecektir.

PowerShell 7'nin en son sürümünü resmi GitHub deposundan indirip yüklemek için aşağıdaki komutu çalıştırın.

iex “& { $ (irm https://aka.ms/install-powershell.ps1) } -UseMSI”

Yükleme sihirbazı başlatıldığında İleri seçeneğini tıklayın.

Kurulum klasörünü seçin (varsayılanı bırakmanızı öneririm) ve İleri.

İsteğe Bağlı İşlemler sayfasını varsayılan olarak bırakın ve İleri'yi tıklayın. açıklık>

Güncelleme seçeneklerini varsayılan olarak bırakmanızı ve ardından İleri seçeneğini tıklamanızı öneririm. .

Son olarak Yükle seçeneğini tıklayın.

Yükleme tamamlandıktan sonra mevcut PowerShell pencerenizi kapatın ve PowerShell 7 başlat menünüzde.

Yüklemenin başarılı olduğunu doğrulamak için PowerShell 7'yi açın.

Microsoft Graph PowerShell'i yükleyin

Microsoft Graph'ı yüklemek için, geçerli kullanıcı bağlamı için veya -Scope parametresini kullanarak tüm kullanıcılar için Install-Module Microsoft.Graph'ı çalıştırabilirsiniz. Bunu yaparak Microsoft Graph PowerShell modülünün genel olarak kullanılabilen en son (kararlı) sürümünü yükleyeceksiniz.

Geçerli kullanıcı kapsamına yönelik modülü kurmak için:

Install-Module Microsoft.Graph -Scope CurrentUser

Veya sisteminizdeki tüm kullanıcılar için kurulum yapmak istiyorsanız: (sisteminizde yerel yönetici haklarına sahip olmanız gerekir):

Install-Module Microsoft.Graph -Scope AllUsers

Yukarıdakiler tercihinize bağlı olarak PowerShell Core'da veya Windows PowerShell'de çalıştırılabilir, ancak birini yüklemek diğerine yüklenmez.

Önizleme modundaki sürümleri yüklemek için -allowprelease parametresini de kullanabilirsiniz. Önizleme sürümü, modülün en son kararlı sürümünde bulunmayan işlevler ve komutlar içeriyorsa bu kullanışlıdır.

Modülün en son yayın öncesi sürümünü yüklemek için aşağıdaki komut kullanılabilir:

Install-Module Microsoft.Graph -Scope AllUsers -allowprerelease

Aşağıdaki komutla hangi sürümün kurulu olduğunu doğrulayabilirsiniz:

Get-InstalledModule | Where-Object {$_.Name -match "microsoft.graph"}

Sonuçlarınız aşağıdaki gibi görünmelidir:

PowerShell ile Microsoft Graph'a bağlanın

Artık gerekli modülü yüklediniz, ortamınıza PowerShell içinden bağlanmak için Connect-MgGraph cmdlet'ini kullanabilirsiniz.

Ancak Microsoft Graph'a yalnızca Connect-MgGraph ile ve hiçbir ek parametre olmadan bağlanırken, PowerShell oturumunda yalnızca kendi kullanıcı hesabımıza erişebileceğiz. Bu nedenle ortamınıza bağlanırken gerekli izin kapsamlarını sağlamanız gerekir. Örneğin:

Kiracınızdaki tüm kullanıcı hesaplarına 'okuma' ve 'yazma' erişimi istiyorsanız:

Connect-MgGraph -Scopes "User.Read.All","User.ReadWrite.All"

Veya gruplara 'okuma' ve 'yazma' erişimi istiyorsanız:

Connect-MgGraph -Scopes "Group.ReadWrite.All"

Microsoft Graph'e bağlanırken belirtebileceğiniz tüm mevcut izinlerin tam bir dökümü için Microsoft'un izinler referans sayfasına göz atın: https://learn.microsoft.com/en-us/graph/permissions-reference