Microsoft Graph PowerShell Modülü Nasıl Kurulur

Microsoft Graph modülü, Microsoft 365 ve Azure Active Directory kaynaklarını PowerShell aracılığıyla yönetmek için cmdlet'ler sağlayan bir PowerShell modülüdür.

Microsoft Graph API, kullanıcılar, gruplar, takvimler ve dosyalar gibi Microsoft 365 verilerine ve hizmetlerine erişim sağlar.

Bu yazımızda Microsoft Graph PowerShell modülünün nasıl kurulacağını ele alacağız.

Önkoşullar

Microsoft Graph PowerShell SDK'sı aşağıdaki önkoşulları gerektirir:

  • PowerShell 5,1 veya sonraki bir sürüme yükseltme
  • .NET Framework 4.7.2 veya üstünü yükleyin
  • Install-Module PowerShell'i kullanarak PowerShellGet'i en son sürüme güncelleyin
  • PowerShell betiği yürütme ilkesi uzaktan imzalı veya daha az kısıtlayıcı olarak ayarlanmalıdır. Yürütme ilkesini ayarlamak için aşağıdaki komutu çalıştırın
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Microsoft Graph Modülünü PowerShell'e Yükleme

Microsoft Graph v1.0 modülünü PowerShell Core veya Windows PowerShell'e yüklemek için aşağıdaki adımları çalıştırın.

1. PowerShell Terminalini açın

Yönetici ayrıcalıklarıyla PowerShell veya PowerShell Core'u başlatın. Bunu yapmak için PowerShell simgesine sağ tıklayın ve “Yönetici olarak çalıştır”ı seçin.

2. Microsoft Graph PowerShell SDK'sını yükleyin

Graph modülünü yüklemek için PowerShell'de aşağıdaki komutu çalıştırın.

Install-Module Microsoft.Graph -Scope CurrentUser

Bu komut, modülü PowerShell Galerisinden alır ve sisteminize yükler.

3. Güvenilmeyen Depoyu Kabul Edin

Modülü güvenilmeyen bir depodan yüklemek için Y yazın ve kurulumun tamamlanmasını bekleyin.

PowerShell'de Yüklü Microsoft Graph Modülü Nasıl Doğrulanır

PowerShell'deki Microsoft Graph modülünün başarıyla yüklendiğini doğrulamak için aşağıdaki komutu çalıştırın.

Get-InstalledModule Microsoft.Graph

Bu komut, sisteminizde yüklüyse Microsoft Graph modülünün yüklü sürümünü, adını ve açıklamasını döndürür.

PowerShell'de Microsoft Graph Modülü Nasıl İçe Aktarılır

Microsoft Graph modülünü içe aktarmak için. Aşağıdaki komutu çalıştırın.

Import-Module Microsoft.Graph

Bu komut, Microsoft Graph modülü cmdlet'lerini PowerShell oturumunuzda kullanılabilir hale getirir.

PowerShell'de MgGraph'a Nasıl Bağlanılır

PowerShell'deki kapsamlarla MgGraph'a bağlanmak için aşağıdaki komutu çalıştırın.

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

Bu komut, kullanıcının kimliğini doğrulamak için oturum açma iletişim kutusuyla birlikte istemde bulunacaktır.

MFA etkinse hesabınız için bir doğrulama kodu oluşturulacaktır. İş veya okul hesabınızla yapılandırdığınız orijinal uygulamayı kullanarak bunu doğrulamanız gerekecektir.

Hesabınız için MFA'yı etkinleştirmediyseniz kullanıcının kimliğini bir kullanıcı adı ve şifreyle doğrulayabilirsiniz.

Devam etmek için İleri düğmesini veya Oturum açın'ı tıklayın. Microsoft Graph PowerShell'e bağlanmak için kuruluşunuz adına sizden izin ve onay isteyecektir.

"Kuruluşunuz adına izin verin" onay kutusunu etkinleştirin ve Kabul Et düğmesini tıklayın.

Başarılı doğrulamanın ardından PowerShell terminaline geri dönecek ve aşağıdaki gibi karşılama mesajını görüntüleyecektir.

PS C:\> Connect-MgGraph -Scopes "User.Read.All","Group.ReadWrite.All"                                                   Welcome to Microsoft Graph!

Connected via delegated access using 14d82eec-204b-4c2f-b7e8-296a70dab67e
Readme: https://aka.ms/graph/sdk/powershell
SDK Docs: https://aka.ms/graph/sdk/powershell/docs
API Docs: https://aka.ms/graph/docs

NOTE: You can use the -NoWelcome parameter to suppress this message.

Artık kullanıcılar, gruplar vb. gibi Microsoft 365 verilerini ve hizmetlerini yönetmek için Microsoft Graph API'yi kullanabilirsiniz.

Kullanıcıların Microsoft 365'te kullanılabilir olmasını sağlamak için Microsoft Graph modülündeki Get-MgUser cmdlet'ini kullanabilirsiniz.

 Get-MgUser -All

Bu komut tüm kullanıcıların bir listesini alır.

Microsoft Graph PowerShell Modülü Nasıl Güncellenir

En son özellikleri almak üzere PowerShell'deki Microsoft Graph modülünü güncellemek için aşağıdaki komutu çalıştırın.

Update-Module Microsoft.Graph

Bu komut Microsoft Graph SDK'yı ve tüm bağımlılıklarını güncelleyecektir.

Microsoft Graph PowerShell Modülü Nasıl Kaldırılır

PowerShell'de Microsoft Graph modülünü kaldırmak için aşağıdaki komutu çalıştırarak ana modülü kaldırın.

Uninstall-Module Microsoft.Graph -AllVersions

Bu komut ana modülü kaldıracaktır.

Daha sonra aşağıdaki komutları çalıştırarak tüm bağımlılık modüllerini kaldırın.

Get-InstalledModule Microsoft.Graph.* | ? Name -ne "Microsoft.Graph.Authentication" | Uninstall-Module
Uninstall-Module Microsoft.Graph.Authentication

Çözüm

Microsoft Graph PowerShell modülünün nasıl kurulacağına ilişkin yukarıdaki makalenin size yardımcı olacağını umuyorum.

PowerShell Active Directory komutları ve PowerShell temelleri hakkında daha fazla konuyu ShellGeek ana sayfasında bulabilirsiniz.

İlgili makaleler