Microsoft Entra PowerShell telepítése

A Microsoft Entra PowerShell-modul lehetővé teszi, hogy az informatikai szakemberek hatékonyan kezeljék Microsoft Entra erőforrásokat, biztosítva a zökkenőmentes integrációt és funkcionalitást a különböző platformokon. Ez a modul javítja a felügyeleti feladatok automatizálásának és gördülékenyebbé tételének képességét.

Ebből a cikkből megtudhatja, hogyan telepítheti, ellenőrizheti, frissítheti és háríthatja el a Microsoft Entra PowerShell-modult a különböző operációs rendszereken.

A Microsoft Entra PowerShell-modul két modulra van felosztva, amelyek mindegyike külön telepíthető almodulokkal. A két fő modul a következő:

  • Microsoft. Entra – az Microsoft Entra PowerShell általános elérhetősége vagy v1.0 verziója. Az Microsoft Graph 1.0-s és Microsoft Graph PowerShell SDK 1.0-s verziós erőforrásokra mutat.
  • Microsoft. Entra.Béta – az Beta Microsoft Entra PowerShell előzetes verziója. A Microsoft Graph Beta és a Microsoft Graph PowerShell SDK Beta erőforrásokra mutat.

A PowerShell 7-es vagy újabb verziója ajánlott a Microsoft Entra PowerShell-modul használatához minden platformon, beleértve a Windows, a Linuxot és a macOS-t is.

A Microsoft Entra PowerShell-modul telepítése Windows

A modulhoz ajánlott telepítési módszer és PowerShell-verzió:

  • Telepítés innen: PowerShell-galéria
  • Használja Windows PowerShell 5.1+ vagy PowerShell 7+ használatával.

Előfeltételek Windows rendszeren

  • Futtassa az alábbi parancsot a PowerShellből a PowerShell-verzió meghatározásához:

    $PSVersionTable.PSVersion

  • Állapítsa meg, hogy telepítve van-e a modul:

    Get-Module -Name Microsoft.Entra -ListAvailable

  • A PowerShell végrehajtási szabályzatának beállítása távoli aláírásúra vagy kevésbé korlátozóra

    • Ellenőrizze a PowerShell végrehajtási szabályzatát:

      Get-ExecutionPolicy -List

    • A PowerShell végrehajtási házirendjének beállítása távoli aláírásra:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    További információ a végrehajtási szabályzatokról: about_Execution_Policies.

Telepítés

A modul telepítésekor dönthet úgy, hogy a teljes modult vagy egy adott almodult telepíti. Az alábbi példák bemutatják, hogyan telepítheti a teljes modult mind a v1.0, mind a Beta esetében.

A modul telepítéséhez használja az Install-Module parancsmagot.

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

Igény szerint módosíthatja a telepítés hatókörét a Hatókör paraméterrel. Ehhez a művelethez rendszergazdai engedélyek szükségesek.

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

Adott almodulok telepítése

Bizonyos modulok telepítése ideális automatizálási forgatókönyvekhez, például Azure Functions és Azure Automation.

Futtassa a következő parancsot az PowerShell-galéria összes Microsoft.Entra GA/v1.0-moduljának listázásához:

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

Ez a parancs felsorolja a PowerShell-galéria Microsoft Entra PowerShell-modulokatGA/v1.0.

Például a(z) Users modul telepítéséhez futtassa a következő parancsot:

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

Microsoft Entra PowerShell telepítése Linux rendszeren

Előfeltételek Linuxon

Telepítés Linuxon

A modul telepítésekor dönthet úgy, hogy a teljes modult vagy egy adott almodult telepíti. Az alábbi példa bemutatja, hogyan telepítheti a teljes modult.

Nyissa meg a Terminál vagy más rendszerhéjgazdaalkalmazást, és futtassa pwsh a PowerShell elindításához.

A modul telepítéséhez használja az Install-Module parancsmagot:

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

Igény szerint módosíthatja a telepítés hatókörét a Hatókör paraméterrel. Ehhez a művelethez rendszergazdai engedélyek szükségesek.

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

Adott almodulok telepítése Linuxon

Bizonyos modulok telepítése ideális automatizálási forgatókönyvekhez, például Azure Functions és Azure Automation.

Futtassa a következő parancsot az PowerShell-galéria összes Microsoft.Entra GA/v1.0-moduljának listázásához:

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

Ez a parancs felsorolja a PowerShell-galéria Microsoft Entra PowerShell-modulokatGA/v1.0.

Például a Users modul telepítéséhez futtassa a következő parancsot:

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

Microsoft Entra PowerShell telepítése macOS rendszeren

Ez a cikk bemutatja, hogyan telepítheti a modult a PowerShell-galéria macOS rendszeren.

Előfeltételek macOS rendszeren

Telepítés macOS rendszeren

A modul telepítésekor dönthet úgy, hogy a teljes modult vagy egy adott almodult telepíti. Az alábbi példa bemutatja, hogyan telepítheti a teljes modult.

Nyissa meg a Terminál vagy más rendszerhéjgazdaalkalmazást, és futtassa pwsh a PowerShell elindításához.

Az Install-Module parancsmaggal telepítse a Microsoft Entra PowerShell-modult:

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

Igény szerint módosíthatja a telepítés hatókörét a Hatókör paraméterrel. Ehhez a művelethez rendszergazdai engedélyek szükségesek.

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

Adott almodulok telepítése macOS rendszeren

Bizonyos modulok telepítése ideális automatizálási forgatókönyvekhez, például Azure Functions és Azure Automation.

Futtassa a következő parancsot az PowerShell-galéria összes Microsoft.Entra GA/v1.0-moduljának listázásához:

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

Ez a parancs felsorolja a PowerShell-galéria Microsoft Entra PowerShell-modulokatGA/v1.0.

Például a(z) Users modul telepítéséhez futtassa a következő parancsot:

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

A modul telepített verziójának és helyének ellenőrzése

A telepítés befejezése után az alábbi paranccsal ellenőrizheti a telepített almodulokat, azok verzióját és helyét.

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

Ez a parancs megjeleníti a telepített Microsoft Entra PowerShell-modult, annak verzióját és telepítési helyét. A kimeneti verziónak meg kell egyeznie a PowerShell-galéria legújabb verziójával. Most már készen áll a modul használatára.

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

Annak ellenőrzéséhez, hogy telepítve van-e például egy adott almodul, Users futtassa a következőt:

Get-InstalledModule -Name Microsoft.Entra.Users

A kimeneti verziónak meg kell egyeznie a PowerShell-galéria legújabb verziójával.

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

Telepítési problémák elhárítása

Hiba A probléma oka Workaround
Install-Module: Nem található olyan paraméter, amely megfelel az AllowPrerelease paraméternévnek. Az Install-Module régebbi verzióját használja. A frissítéshez kövesse ezt az útmutatót. A probléma csak Windows platformra vonatkozik.
A függő modul "modulnév" nincs telepítve ezen a számítógépen. Az aktuális „Microsoft.Entra” modul használatához győződjön meg arról, hogy a függőségi „module-name” modul telepítve van. Microsoft Entra PowerShell-függőségek nincsenek telepítve A telepítéshez használja ezt a szkriptet
Már léteznek parancsmagok a rendszeren Paraméter hozzáadása -AllowClobber : Install-Module -Name Microsoft.Entra -Repository PSGallery -Force -AllowClobber
A következő parancsok már elérhetők ezen a rendszeren: "Enable-EntraAzureADAlias,Get-EntraUnsupportedCommand,Test-EntraScript" Ütközés lép fel, ha a(z) Beta vagy a(z) v1.0 már telepítve van A probléma megoldásához távolítsa el a szabálysértő modul verzióját.

Az egyéb gyakori telepítési és egyéb általános problémák megoldását a modultelepítési problémák elhárítása című témakörben találja.

Bejelentkezés

Ha a Microsoft Entra-erőforrásokat a Microsoft Entra PowerShell-modullal szeretné kezelni, indítsa el a PowerShell-munkamenetet, és futtassa a Connect-Entrát a Microsoft Entra ID való bejelentkezéshez:

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

A Microsoft Entra hitelesítő adataival jelentkezzen be a megnyíló bejelentkezési ablakba.

Ezt a lépést minden új PowerShell-munkamenethez meg kell ismételnie.

További információ az egyéb hitelesítési forgatókönyvekről: további hitelesítési forgatókönyvek.

A modul frissítése

Ha a modul telepítve van, a frissítéséhez kövesse az alábbi lépéseket.

Először ellenőrizze a modul verzióját és helyét a cikk telepítési ellenőrzésének szakaszában található útmutató segítségével.

Frissítés a legújabb verzióra

Az Update-Module használatával frissítsen a Microsoft Entra PowerShell-modul legújabb verziójára.

Update-Module -Name Microsoft.Entra -Force

Egy adott almodul frissítéséhez, például Usersfuttassa a következőt:

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

A Microsoft Entra PowerShell-modul frissítése Update-Module nem távolítja el a modul régi verzióit a rendszerből.

A modul eltávolítása

A modul eltávolításához futtassa a következő parancsot:

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

Egy adott almodul eltávolításához, például Usersfuttassa a következőt:

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

Az összes almodul eltávolításához futtassa a következőt:

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

Következő lépések

  • Last updated on