A Connect AzureAD használata a PowerShellben

Az Azure AD PowerShell-modul lehetővé teszi az Azure Active Directory kezelését a PowerShell segítségével. A modul használatának első lépése a Connect-AzureAD parancsmag használata. A csatlakozás után szerezhet be, frissíthet, hozhat létre vagy távolíthat el objektumokat az Azure AD-környezetben.

Jó előre tudni, hogy az AzureAD modul a tervek szerint 2024. március 30-án elavulttá válik. A rendszer az új Microsoft Graph modulra cseréli. Jelenleg az MgGraph modulok még nincsenek teljesen dokumentálva, ezért az Azure AD-modult továbbra is gyakran használják.

Ebben a cikkben megvizsgáljuk, hogyan csatlakozhat az AzureAD-hez a PowerShellből.

Követelmények

Mielőtt megvizsgálnánk, hogyan csatlakozhat az Azure AD-hez, először meg kell győződnünk arról, hogy a megfelelő modul van telepítve a PowerShellben. Annak ellenőrzésére, hogy a modul már telepítve van-e, használhatjuk a Get-Module parancsmagot.

Ez visszaadja az összes modult, amely megfelel a megadott névnek. Ha a modul nincs telepítve, akkor a $null értéket adja vissza. A telepítéshez használhatjuk az Install-Module parancsmagot:

if ($null -eq (Get-Module -ListAvailable -Name AzureAD)) {
    Write-Host "Installing Azure AD module" -ForegroundColor Cyan
    Install-Module AzureAD -Repository PSGallery -AllowClobber -Force
}

Csatlakoztassa az AzureAD-t

Az AzureAD-hez való csatlakozás meglehetősen egyszerű. Csak a Connect-AzureAD parancsot kell futtatnia, amely ezután felkéri, hogy jelentkezzen be Microsoft 365-fiókjával. Automatikusan az interaktív módszert fogja használni, így kiválaszthatja fiókját, és az MFA segítségével bejelentkezhet:

Connect-AzureAD

A sikeres csatlakozás ellenőrzéséhez használja a Get-AzureADTenantDetail parancsmagot. Ez megmutatja a bérlő adatait, amelyhez kapcsolódik.

Csatlakozás egy másik bérlőhöz

Az AzureAD-modult más általunk kezelt bérlők kezelésére is használhatjuk. Ehhez a -tenantid paramétert kell használnunk. Itt megadhatja a bérlő azonosítóját vagy a bérlő domain nevét:

Connect-AzureAD -Tenant lazydev.onmicrosoft.com

Connect-AzureAD használata RunBookban

Az AzureAD modult Azure Runbookban is használhatja. Csak jó megjegyezni, hogy a modult már nem karbantartják, így például a Managed Identities nem működik közvetlenül. Az Azuread runbookhoz való csatlakoztatásához először az AzModule-t kell használnunk.

Az AzureAZ modul lehetővé teszi az Azure-környezet kezelését. Ezzel a modullal létrehozhatunk egy hozzáférési jogkivonatot, amelyet aztán az Azure AD-hez való csatlakozáshoz használhatunk.

Jegyzet
Ha még nem használt felügyelt identitást, feltétlenül olvassa el ezt a cikket a beállításáról és használatáról.

Először csatlakozzon az Azure-hoz a RunBook felügyelt identitásával:

# Connect to Azure
$az = Connect-AzAccount -Identity
$az = Set-AzContext -SubscriptionName $az.context.Subscription -DefaultProfile $az.context

A kezdeményezett kapcsolat után előállíthatjuk a szükséges tokeneket, és csatlakozhatunk az AzureAD-hez:

# Generate the token
$graphToken = Get-AzAccessToken -ResourceUrl "https://graph.microsoft.com/"
$aadToken = Get-AzAccessToken -ResourceUrl "https://graph.windows.net"

Connect-AzureAD -AccountId $az.account.id -TenantId $az.tenant.id -AadAccessToken $aadToken.token -MsAccessToken $graphToken.token

Becsomagolás

Ne feledje, hogy a tervek szerint a PowerShell AzureAD modul 2024 márciusában elavulttá válik. Azt javaslom, hogy először próbálja meg létrehozni a szkriptet az új Microsoft Graph modullal.