Microsoft Graph PowerShell modülünü yükleyin

Microsoft Graph PowerShell, Azure AD PowerShell ve MSOnline modüllerinin yerini alır. Bu nedenle Azure AD’ye bağlanmak için MS Graph PowerShell SDK’sını kullanmanızı öneririz. Bu yazımızda Microsoft Graph PowerShell modülünün nasıl kurulacağını öğreneceksiniz.

Önkoşullar Microsoft Graph PowerShell

Microsoft Graph PowerShell modülünü kurmadan önce sistemi kurmanız gerekmektedir. Microsoft Graph PowerShell SDK'sını Windows PowerShell ile kullanmak için aşağıdaki ön koşullar gereklidir:

PowerShell 5,1 veya sonraki bir sürüme yükseltme
.NET Framework 4.7.2 veya üstünü yükleyin

Ancak Windows'a PowerShell 7 yüklerseniz Microsoft Graph PowerShell SDK'sını kullanmak için herhangi bir ek önkoşul yoktur. Bu nedenle tüm platformlarda Microsoft Graph PowerShell SDK ile PowerShell 7 veya üzerinin kullanılması önerilir.

Microsoft Graph PowerShell SDK'yı yükleyin

Microsoft Graph PowerShell SDK'sı iki modülden oluşur. PowerShell üzerinde Microsoft Graph modülünü ve Microsoft Graph Beta modülünü kurmak için aşağıdaki adımları sırasıyla takip ediniz.

1. Windows PowerShell yürütme ilkesini ayarlayın

Varsayılan olarak komut dosyalarını yükleyemiyoruz. İnternetten indirdiğiniz tüm PowerShell scriptlerinin güvenilir bir yayıncı tarafından imzalanmasını zorunlu kılmak için aşağıdaki adımları uygulamanız gerekmektedir.

PowerShell'i yönetici olarak çalıştırın ve aşağıdaki cmdlet'i çalıştırın.

Set-ExecutionPolicy RemoteSigned

Y'ye basın ve Enter'la devam edin.

PS C:\> Set-ExecutionPolicy RemoteSigned

Execution Policy Change
The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose
you to the security risks described in the about_Execution_Policies help topic at
http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): Y

Önemli: Değişiklikleri uygulamak için Windows PowerShell penceresini kapatıp yeniden açın.

2. PowerShellGet modülünü yükleyin

PowerShell'i yönetici olarak çalıştırın ve aşağıdaki cmdlet'i çalıştırın.

Install-Module PowershellGet -Force

NuGet sağlayıcısını yüklemeniz istendiğinde Y ve Enter tuşlarına basın.

PS C:\> Install-Module PowershellGet -Force

NuGet provider is required to continue
PowerShellGet requires NuGet provider version '2.8.5.201' or newer to interact with NuGet-based repositories. The NuGet provider must be available in 'C:\Program Files\PackageManagement\ProviderAssemblies' or
'C:\Users\administrator.m365info\AppData\Local\PackageManagement\ProviderAssemblies'. You can also install the NuGet provider by running 'Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force'. Do you want PowerShellGet to install
and import the NuGet provider now?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y

3. Microsoft Graph modülünü yükleyin

Microsoft Graph modülünü kurmak için aşağıdaki komutu çalıştırın. Y ve Enter'a basın.

Install-Module Microsoft.Graph -Force

Microsoft Graph modülünün indirilip kurulması birkaç dakika sürebilir.

Not: Bir sonraki adımda Microsoft Graph Beta modülünü de yüklemenizi öneririz. Bunun nedeni bazı cmdlet'lerin v2.x finalinde mevcut olmadığından çalışmamasıdır.

4. Microsoft Graph Beta modülünü yükleyin

Microsoft Graph Beta modülünü yükleyin. Diğer modül sürümlerinden yükseltme yaparken çakışmaları önlemek için -AllowClobber ve -Force parametrelerini ekleyin. V1.x'ten v2.x'e yükseltme yaparken durum böyle olabilir.

Microsoft Graph Beta modülünü kurmak için aşağıdaki komutu çalıştırın. Y ve Enter'a basın.

Install-Module Microsoft.Graph.Beta -AllowClobber -Force

Microsoft Graph Beta modülünün indirilip kurulması birkaç dakika sürebilir.

Microsoft Graph PowerShell modülü sürümünü kontrol edin

Microsoft Graph modülünü yüklediğinizi doğrulayın.

Aşağıdaki PowerShell cmdlet'ini kullanın.

Get-InstalledModule Microsoft.Graph | ft -AutoSize

Çıktı, hangi MS Graph sürümünün çalıştığını gösterir.

PS C:\> Get-InstalledModule Microsoft.Graph | ft -AutoSize

Version Name            Repository Description 
------- ----            ---------- ----------- 
2.7.0   Microsoft.Graph PSGallery  Microsoft Graph PowerShell module

Ardından Microsoft Graph Beta modülünü yüklediğinizi de kontrol edin.

Aşağıdaki Powershell cmdlet'ini çalıştırın.

Get-InstalledModule Microsoft.Graph.Beta | ft -AutoSize

PowerShell çıkışı hangi MS Graph Beta sürümünün çalıştığını gösterir.

PS C:\> Get-InstalledModule Microsoft.Graph.Beta | ft -AutoSize

Version Name                 Repository Description                      
------- ----                 ---------- -----------                      
2.7.0   Microsoft.Graph.Beta PSGallery  Microsoft Graph PowerShell module

Microsoft Graph PowerShell'e bağlanın

Microsoft Graph PowerShell'e MFA ile veya MFA olmadan bağlanabilirsiniz. Bu örnekte size etkileşimli modla nasıl bağlanacağınızı göstereceğiz.

PowerShell cmdlet'ini aşağıdaki kapsamlarla çalıştırın.

Connect-MgGraph -Scopes 'User.Read.All'

Oturum açma penceresi açılır.

Yönetici hesabınızı ve şifrenizi girin
Oturum aç'ı tıklayın

MFA'yı etkinleştirdiyseniz kısa mesaj olarak veya telefonunuzdaki Kimlik Doğrulama uygulamanıza gönderilen bir doğrulama kodu alacaksınız. MFA'nız devre dışıysa burada hiçbir şey yapmayacaksınız.

Microsoft Graph'ın kullanmasına izin verdiğiniz izinleri gösterir.

Kuruluşunuz adına izin verin'i seçin
Kabul Et'i tıklayın

Doğrulamanın ardından PowerShell pencerenize geri dönebilirsiniz.

Kimlik doğrulaması olmadan Microsoft Graph PowerShell'e bağlanmanın kendinden imzalı sertifika veya istemci sırrı gibi başka yöntemleri de vardır.

Kullanıcılar Tümünü Oku izinleriyle bağlandığınızı doğrulamak için Get-MgUser cmdlet'ini kullanın.

Get-MgUser -All

Microsoft Graph Beta'yı kullanmak için aşağıdaki cmdlet'i çalıştırın.

Get-MgBetaUser -All

Microsoft Graph PowerShell'in bağlantısını kesin

Eski oturumların süresinin dolmasını beklemekten kaçınmak için, işiniz bittiğinde her zaman uzak PowerShell oturumunun bağlantısını kesin.

Aşağıdaki cmdlet'i tamamladıktan sonra uzak PowerShell oturumunun bağlantısını kesin.

Disconnect-MgGraph

Yukarıdaki cmdlet'i tekrar çalıştırırsanız bağlantının doğru şekilde kesilip kesilmediğini kontrol edebilirsiniz.

Aşağıdaki çıktı, Microsoft Graph'ın bağlantısını zaten kesmiş olduğunuz için oturumu kapatabileceğiniz bir uygulama olmadığını gösterir.

PS C:\> Disconnect-MgGraph

Disconnect-MgGraph : No application to sign out from.
At line:1 char:1
+ Disconnect-MgGraph
+ ~~~~~~~~~~~~~~~~
 + CategoryInfo          : CloseError: (:) [Disconnect-MgGraph], ArgumentException
 + FullyQualifiedErrorId : Microsoft.Graph.PowerShell.Authentication.Cmdlets.DisconnectMgGrap

Microsoft Graph PowerShell modülünü güncelleyin

Her zaman Microsoft Graph PowerShell modülünün en son sürümüne güncellemenizi öneririz.

Aşağıdaki PowerShell komutunu çalıştırın.

Update-Module Microsoft.Graph -Force
Update-Module Microsoft.Graph.Beta -Force

Microsoft Graph ve Microsoft Graph Beta modüllerini mevcut en son sürüme güncelleyecektir.

Microsoft Graph PowerShell modülünü kaldırın

Beta sürümü de dahil olmak üzere tüm Microsoft Graph PowerShell modüllerini kaldırmak için aşağıdaki komutları çalıştırın.

Önemli: Microsoft Graph'ı sistemden tamamen kaldırmak için aşağıdaki 4 komutun tümünü çalıştırmanız gerekir.

Uninstall-Module Microsoft.Graph -AllowPrerelease -AllVersions
Uninstall-Module Microsoft.Graph.Beta -AllowPrerelease -AllVersions # Assuming you have beta modules installed.
Get-InstalledModule Microsoft.Graph.* | %{ if($_.Name -ne "Microsoft.Graph.Authentication"){ Uninstall-Module $_.Name -AllowPrerelease -AllVersions } }
Uninstall-Module Microsoft.Graph.Authentication -AllowPrerelease -AllVersions

Not: Kaldırma işleminin tamamlanması yaklaşık 15 dakika sürebilir. Bekleyin ve PowerShell oturumunu kapatmayın.

Şu hatayı alabilirsiniz: Eşleşme bulunamadı. Hata aşağıda gösterilen örneğe benziyor ancak bir sorun değil. Bu, belirtilen Microsoft Graph modülünün zaten kaldırıldığı anlamına gelir. Diğer komutlara devam edin.

PackageManagement\Uninstall-Package : No match was found for the specified search criteria and module names 'Microsoft.Graph'.
At C:\Program Files\WindowsPowerShell\Modules\PowerShellGet\2.2.5\PSModule.psm1:12733 char:21
+ ...        $null = PackageManagement\Uninstall-Package @PSBoundParameters
+                    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : ObjectNotFound: (Microsoft.Power...ninstallPackage:UninstallPackage) [Uninstall-Package], Exception
    + FullyQualifiedErrorId : NoMatchFound,Microsoft.PowerShell.PackageManagement.Cmdlets.UninstallPackage

Bu kadar!

Sık Sorulan Sorular (SSS)

class="schema-faq-question">Microsoft Graph PowerShell'i yönetici olarak nasıl çalıştırırım?

Başlat'ı tıklayın ve PowerShell uygulamasını arayın. Sağ tarafta Yönetici olarak çalıştır'ı tıklayın. Veya PowerShell simgesine sağ tıklayıp Yönetici olarak çalıştır'ı seçebilirsiniz. Bu şekilde PowerShell komutlarını kısıtlama olmadan çalıştırabilirsiniz.

class="schema-faq-question">Neden Microsoft Graph PowerShell'i yüklemem gerekiyor?

Microsoft Graph PowerShell'in yüklenmesi, Azure AD ve MSOnline modüllerine erişim sağlar. Azure Active Directory Graph kullanımdan kaldırıldığı için Microsoft Graph PowerShell'in yüklenmesi gerekir. Microsoft Graph ayrıca Azure AD Graph'tan daha güvenli ve dayanıklıdır.

class="schema-faq-question">Microsoft Graph PowerShell'e bağlandığımda çok faktörlü kimlik doğrulamasına (MFA) ihtiyacım var mı?

Microsoft Graph PowerShell'e bağlanmak için MFA'nın etkin olmasına gerek yoktur. Connect-MgGraph cmdlet'i, MFA'lı veya MFA'sız hesaplarda çalışır. Ancak kuruluşunuzu korumak ve güçlü bir güvenliğe sahip olmak için MFA'yı etkinleştirmenizi öneririz.

Devamını okuyun: Microsoft Graph modülüne bağlanın »

class="schema-faq-question">Hangi Microsoft Graph PowerShell modülünü yüklemem gerekiyor?

Varsayılan olarak yüklenen Microsoft.Graph.Authentication dahil gerekli modülleri yüklemek en iyisidir. Daha eski bir MS Graph modülü kullanıyorsanız Update-Module Microsoft.Graph -Force ve Update-Module Microsoft.Graph.Beta -Force cmdlet'ini kullanarak bunu en son modüle güncellemelisiniz. .

class="schema-faq-question">Microsoft Graph Beta modülünü yüklemem gerekiyor mu?

Henüz Microsoft Graph modülü v2.x'te bulunmayan komutları kullanmak için Microsoft.Graph.Beta modülünü kurmanızı öneririz. Aksi halde bu komutları çalıştıramazsınız ve şu hatayı alırsınız: Eşleşme bulunamadı.

Devamını oku: Exchange Online PowerShell'e bağlanın »

Çözüm

Microsoft Graph PowerShell modülünün nasıl kurulacağını ve son sürüme nasıl güncelleneceğini öğrendiniz. Henüz son sürüm v2'de bulunmayan cmdlet'leri kullanmak için Microsoft Graph Beta modülünün kurulması önerilir. Yeni cmdlet'leri kullanmak için MFA ile veya MFA olmadan Microsoft Graph Powershell'e bağlanın. Bitirdiğinizde bağlantıyı kesmeyi her zaman unutmayın.

Bu makaleyi beğendiniz mi? Ayrıca Exchange Online PowerShell modülünü yüklemeyi de beğenebilirsiniz. Bizi takip etmeyi ve bu yazımızı paylaşmayı unutmayın.