Microsoft Graph API, Microsoft’un çeşitli hizmetleri arasında sorunsuz bir etkileşim sağlayarak, kullanıcılar ve yöneticiler için birçok işlemi kolaylaştırır. Geleneksel olarak, PowerShell üzerinden Microsoft hizmetleriyle etkileşim kurmak için birden fazla modül yüklemek ve farklı bağlantı protokolleri kullanmak gerekiyordu.
Bu yaklaşım, geliştiricilerin ve sistem yöneticilerinin iş yükünü artırırken, süreçleri karmaşık hale getiriyordu. Ancak, Microsoft Graph PowerShell SDK‘sı (Software Development Kit) ile bu durum önemli ölçüde değişmiş oldu.
İçindekiler
Microsoft Graph API
Microsoft Graph PowerShell SDK, Microsoft’un sunduğu çeşitlilikteki hizmetlerle etkileşimde bulunmak için kapsamlı bir araç seti sunmaktadır. Invoke-WebRequest gibi düşük seviyeli HTTP isteklerini kullanarak Graph API‘leriyle etkileşim kurma zorunluluğunu ortadan kaldırır. Bu SDK, Microsoft Graph API‘nin sağladığı zengin özellik setine PowerShell cmdlet’leri aracılığıyla kolayca erişilmesini sağlar, böylece kullanıcıların ve yöneticilerin iş akışlarını önemli ölçüde basitleştirir.
Microsoft Graph PowerShell SDK, PowerShell 7 ve üzeri sürümlerle uyumludur, bu da onu özellikle çapraz platform senaryolarında kullanışlı hale getirir. Bu, Azure AD Modülünün sınırlamalarını aşarak geliştiricilere ve sistem yöneticilerine daha geniş bir erişim ve uyumluluk sunar.
MSGraph, Microsoft'un tüm API'lerine erişim sunmaktadır.
Örnek: User.Read.Allpermission ile tüm kullanıcıları görüntüleyebilirsiniz.
Graph API Modülünü Powershelle Yükleme
MSGraph modülüne web üzerinden erişebildiğiniz gibi Powershell üzerinden de bağlanabilir ve ihtiyaçlarınızın tamamını karşılayabilirsiniz.
SDK'nın ana modülleri olan Microsoft.Graph ve Microsoft.Graph.Beta'nın yüklenmesi, her modül için 38 alt modülün tümünü yükler. Alt modülleri tek tek kurmayı seçtiğinizde varsayılan olarak yüklenenler de dahil olmak üzere yalnızca gerekli modülleri kurmayı düşünün.
PowerShell GET Modülünün Yüklenmesi
Windows üzerinden Powershell veya Terminal açıyorsunuz. Aşağıdaki komutu çalıştırdıktan sonra “Y” ile onaylamanız yeterli olacaktır.
Install-Module PowershellGet

Powershell GET modülünün başarılı yüklenmesinden sonra, MSGraph API modülünü yükleyebiliriz.
Install-Module Microsoft.Graph -Force

Microsoft Graph Module yükleme işlemi tamamlandıktan sonra, Graph API Beta modülüne de aynı şekilde yüklememiz gerekmektedir.
(Microsoft GRAPH API ve GPAPH API Module Beta modüllerinin ikisinide yüklenmesini önermektedir.)
Install-Module Microsoft.Graph.Beta

MSGraph ve MSGraph API Beta modüllerini başarılı bir şekilde yükledik, şimdi ise modüllerin doğrulamasını gerçekleştirebiliriz.
MSGraph API Modül Doğrulama Adımları
Microsoft Graph API modülünün yüklü olduğunu kontrol etmek için get-installedmodule komutunu kullanabilirsiniz.
Get-InstalledModule Microsoft.Graph

Microsoft Graph API’ye PowerShell ile Bağlanma
Graph API’ye bağlanırken kapsamları iyi anlamanız gerekmektedir, örneğin ben aşağıda ki kapsamla graph api bağlantısı sağlayacağım.
Connect-MgGraph -Scopes "User.Read.All","Group.ReadWrite.All"
Admin kullanıcınızla giriş işlemi yapmanız gerekmektedir.

Giriş işlemini sağladıktan sonra bazı kapsamlar için aşağıda ki gibi izin vermeniz gerekiyor.

Bağlantı sağladıktan sonra işlemleri yapmaya başlayabilrisniz, ben kullanıcılarımın listesini almak için aşağıdaki komutu kullanıyorum.
Get-MgUser

Microsoft Graph API Güncelleştirme Adımları
Microsoft Graph API modulü Microsoft tarafından sürekli yenilenmekte ve güncellemeleri yayınlanmaktadır. Bu yüzden dönem dönem Graph API modülünün sürüm kontrolünü sağlamakta ve güncellemelerini yapmamız gerekmektedir.
Graph API Versiyon Kontrol Etme Adımları
Microsoft Graph API mevcut sürümü kontrol etmek için PowerShell üzerinden aşağıda ki komutu çalıştırabilirsiniz.
Get-Module -ListAvailable Microsoft.Graph

Daha sonra kullanılabilir sürümleri listelememiz gerekmektedir, bu işlemi de PowerShell üzerinden gerçekleştirebiliriz.
Şuan mevcut sürümüm güncel durumda ve yeni bir sürüm bulunmamaktadır.
Find-Module Microsoft.Graph

Microsoft Graph API Modülü Güncelleme Adımları
Mevcut Graph API modül versiyonumuzu ve kullanılabilir sürümleri kontrol ettikten sonra, eğer yeni bir sürüm bulunuyorsa modülü PowerShell kullanarak güncelleyebiliriz.
Bunun için Update-Module komutunu kullanmamız yeterli olacaktır.
Update-Module Microsoft.Graph
Microsoft Graph API beta modülünü güncellemek için kullanılması gereken komut ise aşağıdaki gibidir;
Update-Module Microsoft.Graph.Beta -Force
Bu yazı ile beraber Microsoft Graph API’ye göz attık, kurulum ve bağlantı aşamalarından bahsettik. Umarım faydalı olmuştur, bir başka yazı da görüşmek üzere.
Hocam detaylı anlatımlar için teşekkürler. Graph API ile ilgili daha fazla makale veya video üretmeyi düşünüyor musunuz?