Microsoft Entra PowerShell'i yükleme

Microsoft Entra PowerShell modülü, BT uzmanlarının Microsoft Entra kaynaklarını verimli bir şekilde yönetmesine olanak sağlayarak çeşitli platformlarda sorunsuz tümleştirme ve işlevsellik sağlar. Bu modül, yönetim görevlerini otomatikleştirme ve kolaylaştırma becerinizi geliştirir.

Bu makalede, farklı işletim sistemlerinde Microsoft Entra PowerShell modülünü yüklemeyi, doğrulamayı, güncelleştirmeyi ve sorunlarını gidermeyi öğreneceksiniz.

Microsoft Entra PowerShell modülü, her biri ayrı olarak yüklenebilen alt modüllere sahip iki modüle ayrılır. İki ana modül şunlardır:

  • Microsoft. Entra - Microsoft Entra PowerShell'in genel kullanılabilirliği veya v1.0 sürümü. Microsoft Graph v1.0 ve Microsoft Graph PowerShell SDK v1.0 kaynaklarına işaret eder.
  • Microsoft. Entra.Beta - Beta Microsoft Entra PowerShell'in veya önizleme sürümü. Microsoft Graph Beta ve Microsoft Graph PowerShell SDK Beta kaynaklarına işaret eder.

PowerShell sürüm 7 veya üzeri, Windows, Linux ve macOS gibi tüm platformlarda Microsoft Entra PowerShell modülüyle kullanılması önerilir.

Windows Microsoft Entra PowerShell modülünü yükleme

Modül için önerilen yükleme yöntemi ve PowerShell sürümü:

Windows önkoşulları

  • PowerShell sürümünüzü belirlemek için PowerShell'den aşağıdaki komutu çalıştırın:

    $PSVersionTable.PSVersion

  • Modülün yüklü olup olmadığını belirleyin:

    Get-Module -Name Microsoft.Entra -ListAvailable

  • PowerShell yürütme ilkesini uzaktan imzalı veya daha az kısıtlayıcı olarak ayarlama

    • PowerShell yürütme ilkesini denetleyin:

      Get-ExecutionPolicy -List

    • PowerShell yürütme ilkesini uzaktan imzalı olarak ayarlayın:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    Yürütme ilkeleri hakkında daha fazla bilgi için bkz. about_Execution_Policies.

Yükleme

Modülü yüklerken modülün tamamını veya belirli bir alt modülü yüklemeyi seçebilirsiniz. Aşağıdaki örnekler, hem v1.0 hem de Beta için modülün tamamının nasıl kurulacağını gösterir.

Modülü yüklemek için Install-Module cmdlet'ini kullanın.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

İsteğe bağlı olarak, Scope parametresini kullanarak yüklemenin kapsamını değiştirebilirsiniz. Bu işlem için yönetici izinleri gerekir.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Belirli alt modülleri yükleme

Belirli modüllerin yüklenmesi, Azure İşlevleri ve Azure Otomasyonu kullanma gibi otomasyon senaryoları için idealdir.

PowerShell Galerisi tüm Microsoft.Entra GA/v1.0 modüllerini listelemek için aşağıdaki komutu çalıştırın:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Bu komut, PowerShell Galerisi'deki tüm Microsoft Entra PowerShell GA/v1.0 modüllerini listeler.

Örneğin, Users modülünü yüklemek için aşağıdaki komutu çalıştırın:

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Linux'ta Microsoft Entra PowerShell'i yükleme

Linux'ta önkoşullar

Linux'ta yükleme

Modülü yüklerken modülün tamamını veya belirli bir alt modülü yüklemeyi seçebilirsiniz. Aşağıdaki örnekte modülün tamamının nasıl yükleneceği gösterilmektedir.

Terminal veya başka bir kabuk ana bilgisayar uygulamasını açın ve PowerShell'i başlatmak için pwsh komutunu çalıştırın.

Modülü yüklemek için Install-Module cmdlet'ini kullanın:

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

İsteğe bağlı olarak, Scope parametresini kullanarak yüklemenin kapsamını değiştirebilirsiniz. Bu işlem için yönetici izinleri gerekir.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Linux'a belirli alt modülleri yükleme

Belirli modüllerin yüklenmesi, Azure İşlevleri ve Azure Otomasyonu kullanma gibi otomasyon senaryoları için idealdir.

PowerShell Galerisi tüm Microsoft.Entra GA/v1.0 modüllerini listelemek için aşağıdaki komutu çalıştırın:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Bu komut, PowerShell Galerisi'deki tüm Microsoft Entra PowerShell GA/v1.0 modüllerini listeler.

Örneğin, Users modülünü yüklemek için aşağıdaki komutu çalıştırın:

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Microsoft Entra PowerShell'i macOS'a yükleme

Bu makalede, macOS'ta PowerShell Galerisi modülün nasıl yükleneceği açıklanmaktadır.

macOS'ta önkoşullar

macOS'ta yükleme

Modülü yüklerken modülün tamamını veya belirli bir alt modülü yüklemeyi seçebilirsiniz. Aşağıdaki örnekte modülün tamamının nasıl yükleneceği gösterilmektedir.

Terminal veya başka bir kabuk ana bilgisayar uygulamasını açın ve PowerShell'i başlatmak için pwsh komutunu çalıştırın.

Microsoft Entra PowerShell modülünü yüklemek için Install-Module cmdlet'ini kullanın:

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

İsteğe bağlı olarak, Scope parametresini kullanarak yüklemenin kapsamını değiştirebilirsiniz. Bu işlem için yönetici izinleri gerekir.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

macOS'a belirli alt modülleri yükleme

Belirli modüllerin yüklenmesi, Azure İşlevleri ve Azure Otomasyonu kullanma gibi otomasyon senaryoları için idealdir.

PowerShell Galerisi tüm Microsoft.Entra GA/v1.0 modüllerini listelemek için aşağıdaki komutu çalıştırın:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Bu komut, PowerShell Galerisi’deki tüm Microsoft Entra PowerShell GA/v1.0 modüllerini listeler.

Örneğin, Users modülünü yüklemek için aşağıdaki komutu çalıştırın:

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Yüklü modülün sürümünü ve konumunu doğrulama

Yükleme tamamlandıktan sonra, aşağıdaki komutla yüklü alt modülleri, bunların sürümlerini ve konumlarını doğrulayabilirsiniz.

Get-InstalledModule -Name Microsoft.Entra* |
Where-Object { $_.Name -notmatch "Beta" } | Format-Table Name, Version, InstalledLocation -AutoSize

Bu komut, yüklü Microsoft Entra PowerShell modülünü, sürümünü ve yükleme konumunu gösterir. Çıkış sürümü, PowerShell Galerisi en son sürümle eşleşmelidir. Artık modülü kullanmaya hazırsınız.

Name                                Version InstalledLocation
----                                ------- -----------------
Microsoft.Entra                     1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra\1.0.1
Microsoft.Entra.Applications        1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Applications\1.0.1
Microsoft.Entra.Authentication      1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Authentication\1.0.1
Microsoft.Entra.DirectoryManagement 1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.DirectoryManagement\1.0.1
Microsoft.Entra.Governance          1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Governance\1.0.1
Microsoft.Entra.Groups              1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Groups\1.0.1
Microsoft.Entra.Reports             1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Reports\1.0.1
Microsoft.Entra.SignIns             1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.SignIns\1.0.1
Microsoft.Entra.Users               1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Users\1.0.1

Örneğin Users belirli bir alt modülün yüklenip yüklenmediğini doğrulamak için şunu çalıştırın:

Get-InstalledModule -Name Microsoft.Entra.Users

Çıkış sürümü, PowerShell Galerisi en son sürümle eşleşmelidir.

Version              Name                                Repository           Description
-------              ----                                ----------           -----------
1.0.1                Microsoft.Entra.Users               PSGallery            Microsoft Entra PowerShell

Yükleme sorunlarını giderme

Error Cause Geçici çözüm
Yükleme Modülü: AllowPrerelease parametre adıyla eşleşen bir parametre bulunamıyor. Install-Module'ün eski bir sürümünü kullanıyorsunuz. Yükseltmek için bu kılavuzu izleyin. Sorun yalnızca Windows platform için geçerlidir.
'module-name' bağımlı modülü bu bilgisayarda yüklü değil. Geçerli 'Microsoft.Entra' modülünü kullanmak için, bağımlı modül olan 'module-name'in yüklü olduğundan emin olun. Microsoft Entra PowerShell bağımlılıkları yüklü değil Yüklemek için bu betiği kullanın
Cmdlet'ler sistemde zaten var Parametre ekle -AllowClobber : Install-Module -Name Microsoft.Entra -Repository PSGallery -Force -AllowClobber
Şu komutlar bu sistemde zaten kullanılabilir: 'Enable-EntraAzureADAlias,Get-EntraUnsupportedCommand,Test-EntraScript' Beta veya v1.0 zaten yüklüyse bir çakışma oluşur Sorunu çözmek için sorunlu modül sürümünü kaldırın .

Diğer yaygın yükleme ve diğer genel sorunların çözümleri için bkz. Modül yükleme sorunlarını giderme.

Giriş Yap

Microsoft Entra PowerShell modülüyle Microsoft Entra kaynaklarınızı yönetmeye başlamak için bir PowerShell oturumu başlatın ve Connect-Entra'yı çalıştırarak Microsoft Entra ID oturum açın:

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUser -Filter "userPrincipalName eq 'SawyerM@contoso.com'"

Açılan oturum açma penceresinde oturum açmak için Microsoft Entra kimlik bilgilerinizi kullanın.

Başlattığınız her yeni PowerShell oturumu için bu adımı tekrarlamanız gerekir.

Diğer kimlik doğrulama senaryoları hakkında daha fazla bilgi için daha fazla kimlik doğrulama senaryosuna bakın.

Modülü güncelleştirme

Modül yüklüyse, güncelleştirmek için bu adımları izleyin.

İlk olarak, bu makalenin Yüklemeyi doğrulama bölümündeki yönergeleri kullanarak modül sürümünü ve konumunu doğrulayın.

En son sürüme güncelleştirme

Microsoft Entra PowerShell modülünün en son sürümüne güncelleştirmek için Update-Module kullanın.

Update-Module -Name Microsoft.Entra -Force

gibi Usersbelirli bir alt modülü güncelleştirmek için şunu çalıştırın:

Update-Module -Name Microsoft.Entra.Users -Force

kullanarak Update-Module Microsoft Entra PowerShell modülünün güncelleştirilmesi, modülün eski sürümlerini sisteminizden kaldırmaz.

Modülü kaldırma

Modülü kaldırmak için komutunu çalıştırın:

Uninstall-Module -Name Microsoft.Entra -AllVersions -Force

gibi Usersbelirli bir alt modülü kaldırmak için şunu çalıştırın:

Uninstall-Module -Name Microsoft.Entra.Users -AllVersions -Force

Tüm alt modülleri kaldırmak için şunu çalıştırın:

$InstalledSubModules = Get-InstalledModule -Name Microsoft.Entra.* |
Where-Object { $_.Name -notmatch "Beta" }
foreach ($module in $InstalledSubModules) {
    Write-Host "Checking for submodule: $($module.Name)" -ForegroundColor Yellow -BackgroundColor DarkBlue
    Uninstall-Module -Name $module.Name -Force -ErrorAction Stop
    Write-Host "Successfully uninstalled submodule: $($module.Name)" -ForegroundColor Green
}

Sonraki Adımlar

  • Last updated on