Az Azure Active Directory PowerShell for Graph telepítése

  • Cikk

Fontos

Azure AD PowerShell elavulása 2024. március 30-án várható. Az elavulási tervekkel kapcsolatos további részletekért lásd az elavulással kapcsolatos frissítést. Javasoljuk, hogy folytassa a Microsoft Graph PowerShellre való migrálást, amely a Azure AD használatához ajánlott modul. Emellett a Microsoft Graph PowerShell lehetővé teszi az összes Microsoft Graph API elérését, és elérhető a PowerShell 7-ben. A gyakori migrálási lekérdezésekre adott válaszokért tekintse meg a migrálással kapcsolatos gyakori kérdéseket.

A Graph Azure Active Directory PowerShell-modulverzióját használhatja Azure AD felügyeleti feladatokhoz, például a felhasználókezeléshez, a tartománykezeléshez és az egyszeri bejelentkezés konfigurálásához. Az itt felsorolt parancsmagok eltérnek az Azure Active Directory PowerShell 1.0-s verziójának részét képező MSOnline-parancsmagoktól.

A Azure AD PowerShell for Graph modul két verzióval rendelkezik: egy nyilvános előzetes verzióval és egy általános rendelkezésre állási (GA) verzióval. Éles forgatókönyvekhez nem ajánlott a nyilvános előzetes verziót használni.

Töltse le a modulokat a PowerShell-galéria használja az alábbiakat;

Az Azure Active Directory PowerShell for Graph kiadási verzióelőzményei

A Azure AD modul és a Azure AD Előzetes verziójú modul kiadási előzményei itt találhatók:azure Active Directory PowerShell for Graph: verziókiadási előzmények.

Az Azure AD-modul telepítése

Előfeltételek

A Azure AD modul a következő Windows operációs rendszereken támogatott a Microsoft .NET-keretrendszer és Windows PowerShell alapértelmezett verziójával:

  • Windows 8.1
  • Windows 8
  • Windows 7
  • Windows Server 2012 R2,
  • Windows Server 2012
  • Windows Server 2008 R2.

Megjegyzés

A Azure AD PowerShell-modul nem kompatibilis a PowerShell 7-zel. Csak a PowerShell 5.1-ben támogatott.

A modul Általánosan elérhető verziójának telepítéséhez futtassa a következőt:

Install-Module AzureAD

A nyilvános előzetes kiadás telepítéséhez futtassa a következőt:

Install-module AzureADPreview

Az előzetes verzió és az általánosan elérhető verzió nem telepíthető ugyanarra a számítógépre egyszerre.

A Azure AD modul a PowerShell-galéria használatával van elosztva. Az elemek katalógusból való telepítéséhez a PowerShellGet modul legújabb verziójára van szükség, amely Windows 10, Windows Management Framework (WMF) 5.0 vagy MSI-alapú telepítőben (PowerShell 3 és 4 esetén) érhető el.

A legújabb PowerShellGet-modullal a következőket teheti:

A galériával használható PowerShellGet-parancsokkal kapcsolatos további információkért tekintse meg az Első lépések oldalt. Az Update-Help -Module PowerShellGet parancs futtatásával egy helyi súgót is telepíthet a parancsokhoz.

Támogatott operációs rendszerek

A PowerShellGet modulhoz a PowerShell 3.0-s vagy újabb verziójára van szükség.

Ebből kifolyólag a PowerShellGet-modulhoz az alábbi operációs rendszerek egyikére van szükség:

  • Windows 10
  • Windows 8.1 Pro
  • Windows 8.1 Enterprise
  • Windows 7 SP1
  • Windows Server 2016 TP5
  • Windows Server 2012 R2
  • Windows Server 2008 R2 SP1

A PowerShellGet használatához .NET-keretrendszer 4.5-ös vagy újabb verzió szükséges. A .NET-keretrendszer 4.5-ös vagy újabb verziója innen telepíthető.

Az Azure AD-modul frissítése

A számítógépen telepített modul verziójának ellenőrzéséhez futtassa a következő parancsot:

Get-Module AzureADPreview

ModuleType Version Name                ExportedCommands
---------- ------- ----                ----------------
Binary     2.0.0.7 azureadpreview     {Add-AzureADAdmini...

A Azure AD PowerShell-modul verziójának frissítéséhez futtassa újra az Install-Module parancsmagot:

Install-Module AzureADPreview

Ez a parancs ellenőrzi a PowerShell-katalógusban, hogy elérhető-e újabb verzió. Ha igen, az újabb, mint a számítógépre telepített.

Csatlakozás az Azure AD szolgáltatáshoz

Ahhoz, hogy futtathassa a jelen cikkben ismertetett parancsmagokat, először csatlakoznia kell az online szolgáltatáshoz. Ehhez futtassa a Connect-AzureAD parancsmagot a Windows PowerShell-parancssorában. Ezután a rendszer kérni fogja a hitelesítő adatait. Ha szeretné, a hitelesítő adatokat előre is megadhatja. Például:

$AzureAdCred = Get-Credential
Connect-AzureAD -Credential $AzureAdCred

Az első parancs felkéri a hitelesítő adatok megadására, és az $AzureAdCred paraméterben tárolja azokat. A következő parancs az $$azureadcred paraméter formájában használja fel ezeket a hitelesítő adatokat a szolgáltatáshoz való csatlakozáshoz.

Megjegyzés

A Azure AD és Azure AD Előzetes verziójú modulok különböző elnevezési konvenciókkal rendelkező parancsmagokból állnak, -AzureAD például és -AzureADMS. A -AzureAD parancsmagok a Azure AD Graph-végponthoz https://graph.windows.net csatlakoznak, míg a -AzureADMS parancsmagok hívásokat kezdeményeznek a Microsoft Graph-végpont graph.microsoft.comfelé. A rendszer csendesen kezeli a hitelesítést, amikor a hívásokat egyik végpontról a másikra módosítja, és a rendszer nem kéri újra a hitelesítő adatokat.

Ha az Azure Active Directory egy bizonyos környezetéhez szeretne csatlakozni, használja az AzureEnvironment paramétert az alábbi módon:

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

Ez a példa a német AzureAD-környezethez csatlakoztatja a PowerShell-munkamenetet. További információk: Connect-AzureAD.

Következő lépések