İçindekiler

1. Microsoft Graph API
2. Graph API Modülünü Powershelle Yükleme
   1. PowerShell GET Modülünün Yüklenmesi
   2. MSGraph API Modül Doğrulama Adımları
3. Microsoft Graph API’ye PowerShell ile Bağlanma
4. Microsoft Graph API Güncelleştirme Adımları
   1. Graph API Versiyon Kontrol Etme Adımları
   2. Microsoft Graph API Modülü Güncelleme Adımları

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 Microsofthizmetleriyle 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.

• Microsoft Graph API
• Graph API Modülünü Powershelle Yükleme
  • PowerShell GET Modülünün Yüklenmesi
  • MSGraph API Modül Doğrulama Adımları
• Microsoft Graph API’ye PowerShell ile Bağlanma
• Microsoft Graph API Güncelleştirme Adımları
  • Graph API Versiyon Kontrol Etme Adımları
  • Microsoft Graph API Modülü Güncelleme Adımları

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 PowerShellcmdlet’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

MSGraphmodü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ü Microsofttarafı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.