Az Azure Active Directory PowerShell for Graph telepítése
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 PowerShell-galéria ismertetése
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:
- Keresést végezhet a galéria elemei között a Find-Module és Find-Script parancsok használatával
- Elemek mentése a rendszerbe a katalógusból a Save-Module és a Save-Script paranccsal
- Elemeket telepíthet a galériából az Install-Module és Install-Script parancsok használatával
- Elemeket tölthet fel a galériába a Publish-Module és Publish-Script parancsok használatával
- Hozzáadhatja saját egyéni tárházát a Register-PSRepository parancs használatával
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.com
felé. 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
- Tekintse meg az Új funkciók és fejlesztések című témakört.