Instalace Microsoft Entra PowerShellu

Modul Microsoft Entra PowerShellu umožňuje IT odborníkům efektivně spravovat Microsoft Entra prostředky a zajistit bezproblémovou integraci a funkčnost napříč různými platformami. Tento modul vylepšuje schopnost automatizovat a zjednodušit úlohy správy.

V tomto článku se dozvíte, jak nainstalovat, ověřit, aktualizovat a řešit potíže s modulem Microsoft Entra PowerShellu v různých operačních systémech.

Modul Microsoft Entra PowerShellu je rozdělený do dvou modulů, z nichž každý má dílčí moduly, které je možné nainstalovat samostatně. Mezi dva hlavní moduly patří:

  • Microsoft. Entra – obecná dostupnost nebo v1.0 verze Microsoft Entra PowerShellu. Odkazuje na prostředky Microsoft Graph v1.0 a Sada Microsoft Graph PowerShell SDK v1.0.
  • Microsoft.Entra.Beta - Beta nebo verze pro předběžný náhled prostředí Microsoft Entra PowerShell. Odkazuje na prostředky Microsoft Graph Beta a Sada Microsoft Graph PowerShell SDK Beta.

PowerShell verze 7 nebo vyšší se doporučuje pro použití s modulem Microsoft Entra PowerShellu na všech platformách, včetně Windows, Linuxu a macOS.

Instalace modulu powershellu Microsoft Entra na Windows

Doporučená metoda instalace a verze PowerShellu pro modul:

Požadavky na Windows

  • Spuštěním následujícího příkazu z PowerShellu určete verzi PowerShellu:

    $PSVersionTable.PSVersion

  • Zjistěte, jestli máte nainstalovaný modul:

    Get-Module -Name Microsoft.Entra -ListAvailable

  • Nastavte zásady spouštění PowerShellu na dálkově podepsané nebo méně omezující

    • Zkontrolujte zásady spouštění PowerShellu:

      Get-ExecutionPolicy -List

    • Nastavte zásady spouštění PowerShellu na vzdáleně podepsané:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    Další informace o zásadách provádění najdete v tématu about_Execution_Policies.

Instalace

Při instalaci modulu se můžete rozhodnout nainstalovat celý modul nebo konkrétní dílčí modul. Následující příklady ukazují, jak nainstalovat celý modul pro oba v1.0 i Beta.

K instalaci modulu použijte rutinu Install-Module .

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

Volitelně můžete změnit rozsah instalace pomocí parametru Scope . Tato operace vyžaduje oprávnění správce.

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

Instalace konkrétních dílčích modulů

Instalace konkrétních modulů je ideální pro scénáře automatizace, jako je použití Azure Functions a Azure Automation.

Spuštěním následujícího příkazu vypište všechny Microsoft.Entra moduly GA/v1.0 v Galerie prostředí PowerShell:

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

Tento příkaz zobrazí všechny moduly Microsoft Entra PowerShell GA/v1.0 v Galerie prostředí PowerShell.

Pokud chcete například nainstalovat Users modul, spusťte následující příkaz:

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

Instalace Microsoft Entra PowerShellu v Linuxu

Požadavky v Linuxu

Instalace v Linuxu

Při instalaci modulu se můžete rozhodnout nainstalovat celý modul nebo konkrétní dílčí modul. Následující příklad ukazuje, jak nainstalovat celý modul.

Otevřete terminál nebo jinou hostitelskou aplikaci shellu a spusťte pwsh, abyste spustili PowerShell.

K instalaci modulu použijte rutinu Install-Module :

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

Volitelně můžete změnit rozsah instalace pomocí parametru Scope . Tato operace vyžaduje oprávnění správce.

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

Instalace konkrétních dílčích modulů v Linuxu

Instalace konkrétních modulů je ideální pro scénáře automatizace, jako je použití Azure Functions a Azure Automation.

Spuštěním následujícího příkazu vypište všechny Microsoft.Entra moduly GA/v1.0 v Galerie prostředí PowerShell:

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

Tento příkaz vypíše všechny moduly PowerShellu GA/v1.0 Microsoft Entra v Galerie prostředí PowerShell.

Pokud chcete například nainstalovat Users modul, spusťte následující příkaz:

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

Instalace Microsoft Entra PowerShellu v systému macOS

Tento článek vysvětluje, jak nainstalovat modul z Galerie prostředí PowerShell v systému macOS.

Požadavky na macOS

Instalace v systému macOS

Při instalaci modulu se můžete rozhodnout nainstalovat celý modul nebo konkrétní dílčí modul. Následující příklad ukazuje, jak nainstalovat celý modul.

Otevřete terminál nebo jinou hostitelskou aplikaci shellu a spusťte pwsh, abyste spustili PowerShell.

Pomocí rutiny Install-Module nainstalujte modul Microsoft Entra PowerShellu:

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

Volitelně můžete změnit rozsah instalace pomocí parametru Scope . Tato operace vyžaduje oprávnění správce.

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

Instalace konkrétních dílčích modulů v systému macOS

Instalace konkrétních modulů je ideální pro scénáře automatizace, jako je použití Azure Functions a Azure Automation.

Spuštěním následujícího příkazu vypište všechny Microsoft.Entra moduly GA/v1.0 v Galerie prostředí PowerShell:

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

Tento příkaz vypíše všechny moduly PowerShellu GA/v1.0 Microsoft Entra v Galerie prostředí PowerShell.

Pokud chcete například nainstalovat Users modul, spusťte následující příkaz:

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

Ověření nainstalované verze modulu a umístění

Po dokončení instalace můžete pomocí následujícího příkazu ověřit nainstalované dílčímoduly, jejich verzi a umístění.

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

Tento příkaz zobrazí nainstalovaný Microsoft Entra modul PowerShellu, jeho verzi a umístění instalace. Výstupní verze by měla odpovídat nejnovější verzi v Galerie prostředí PowerShell. Teď jste připraveni modul použít.

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

Pokud chcete ověřit, jestli je například nainstalovaný konkrétní dílčí modul, Users spusťte:

Get-InstalledModule -Name Microsoft.Entra.Users

Výstupní verze by měla odpovídat nejnovější verzi v Galerie prostředí PowerShell.

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

Řešení problémů s instalací

Error Příčina Workaround
Install-Module: Nelze najít parametr, který odpovídá názvu parametru AllowPrerelease. Používáte starší verzi modulu Install-Module. Pokud chcete upgradovat, postupujte podle tohoto průvodce. Tento problém se týká jenom platformy Windows.
Závislý modul "název modulu" není v tomto počítači nainstalovaný. Chcete-li použít aktuální modul 'Microsoft.Entra,' ujistěte se, že je nainstalován jeho závislý modul 'module-name'. Moduly PowerShellu pro Microsoft Entra nejsou nainstalovány K instalaci použijte tento skript.
Cmdlety již v systému existují. Přidat parametr -AllowClobber: Install-Module -Name Microsoft.Entra -Repository PSGallery -Force -AllowClobber
V tomto systému jsou již k dispozici následující příkazy: Enable-EntraAzureADAlias, Get-EntraUnsupportedCommand, Test-EntraScript Ke konfliktu dojde, pokud je již nainstalováno buď Beta, nebo v1.0. Chcete-li tento problém vyřešit, odinstalujte problematickou verzi modulu.

Řešení jiných běžných problémů s instalací a dalšími obecnými problémy najdete v tématu Řešení potíží s instalací modulů.

Přihlásit se

Pokud chcete začít spravovat prostředky Microsoft Entra pomocí modulu Microsoft Entra PowerShellu, spusťte relaci PowerShellu a spusťte Connect-Entra, abyste se přihlásili k Microsoft Entra ID:

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

Pomocí přihlašovacích údajů Microsoft Entra se přihlaste k přihlašovacímu okně, které se otevře.

Tento krok musíte zopakovat pro každou novou relaci PowerShellu, kterou spustíte.

Další informace o jiných scénářích ověřování najdete v dalších scénářích ověřování.

Aktualizace modulu

Pokud je modul nainstalovaný, aktualizujte ho podle těchto kroků.

Nejprve pomocí pokynů v části ověření instalace tohoto článku ověřte verzi modulu a umístění.

Aktualizace na nejnovější verzi

Pomocí modulu Update-Module aktualizujte na nejnovější verzi modulu Microsoft Entra PowerShellu.

Update-Module -Name Microsoft.Entra -Force

Pokud chcete aktualizovat konkrétní dílčí modul, například Usersspusťte:

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

Aktualizace modulu Microsoft Entra PowerShell pomocí Update-Module ze systému neodebere staré verze modulu.

Odinstalace modulu

Pokud chcete modul odebrat, spusťte příkaz:

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

Pokud chcete odinstalovat konkrétní dílčí modul, například Users, spusťte:

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

Pokud chcete odinstalovat všechny dílčímoduly, spusťte:

$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
}

Další kroky

  • Další informace o procházení modulu Microsoft Entra PowerShellu najdete v článku o procházení modulu.
  • Last updated on