Azure Active Directory PowerShell voor Graph installeren
Belangrijk
Azure AD PowerShell is gepland voor afschaffing op 30 maart 2024. Zie de afschaffingsupdate voor meer informatie over de afschaffingsplannen. We raden u aan door te gaan met migreren naar Microsoft Graph PowerShell. Dit is de aanbevolen module voor interactie met Azure AD. Microsoft Graph PowerShell biedt u bovendien toegang tot alle Microsoft Graph API's en is beschikbaar in PowerShell 7. Zie veelgestelde vragen over migratie voor antwoorden op veelvoorkomende migratiequery's.
U kunt de Azure Active Directory PowerShell-moduleversie voor Graph gebruiken voor Azure AD beheertaken, zoals gebruikersbeheer, domeinbeheer en voor het configureren van eenmalige aanmelding. De cmdlets die hier worden vermeld, verschillen van de MSOnline-cmdlets die deel uitmaken van Azure Active Directory PowerShell versie 1.0.
De Azure AD PowerShell voor Graph-module heeft twee versies: een openbare preview-versie en een versie van algemene beschikbaarheid (GA). Het wordt niet aanbevolen om de openbare preview-versie te gebruiken voor productiescenario's.
Download de modules van de PowerShell Gallery gebruik het volgende:
Releasegeschiedenis van Azure Active Directory PowerShell voor Graph
De releasegeschiedenis voor de Azure AD-module en de Azure AD Preview-module vindt u hier:azure active directory powershell for graph: versiereleasegeschiedenis.
De Azure AD-module installeren
Vereisten
De Azure AD-module wordt ondersteund op de volgende Windows-besturingssystemen met de standaardversie van Microsoft .NET Framework en Windows PowerShell:
- Windows 8.1
- Windows 8
- Windows 7
- Windows Server 2012 R2,
- Windows Server 2012
- Windows Server 2008 R2.
Notitie
De Azure AD PowerShell-module is niet compatibel met PowerShell 7. Het wordt alleen ondersteund in PowerShell 5.1.
Voer het volgende uit om de algemene beschikbaarheidsversie van de module te installeren:
Install-Module AzureAD
Voer het volgende uit om de openbare preview-versie te installeren:
Install-module AzureADPreview
U kunt de preview-versie en de GA-versie niet tegelijkertijd op dezelfde computer installeren.
Over de PowerShell Gallery
De Azure AD-module wordt gedistribueerd met behulp van de PowerShell Gallery. Voor het installeren van items uit de galerie is de nieuwste versie van de PowerShellGet-module vereist, die beschikbaar is in Windows 10, in Windows Management Framework (WMF) 5.0 of in het MSI-installatieprogramma (voor PowerShell 3 en 4).
Met de nieuwste PowerShellGet-module kunt u het volgende doen:
- De items in de galerie doorzoeken met Find-Module en Find-Script
- Items opslaan op uw systeem vanuit de galerie met Save-Module en Save-Script
- Items uit de galerie installeren met Install-Module en Install-Script
- Items naar de galerie uploaden met Publish-Module en Publish-Script
- Uw eigen aangepaste opslagplaats toevoegen met Register-PSRepository
Raadpleeg de pagina Aan de slag voor meer informatie over het uitvoeren van PowerShellGet-opdrachten in de Gallery. U kunt ook Update-Help -Module PowerShellGet uitvoeren om lokale Help-onderwerpen voor deze opdrachten te installeren.
Ondersteunde besturingssystemen
Voor de PowerShellGet-module is PowerShell 3.0 of hoger vereist.
Daarom vereist PowerShellGet een van de volgende besturingssystemen:
- 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
PowerShellGet vereist ook .NET Framework 4.5 of hoger. U kunt .NET Framework 4.5 of hoger hier installeren.
De Azure AD-module bijwerken
Voer de volgende opdracht uit om de versie van de module te controleren die op uw computer is geïnstalleerd:
Get-Module AzureADPreview
ModuleType Version Name ExportedCommands
---------- ------- ---- ----------------
Binary 2.0.0.7 azureadpreview {Add-AzureADAdmini...
Als u de versie van de Azure AD PowerShell-module op uw computer wilt bijwerken, voert u de cmdlet Install-Module opnieuw uit:
Install-Module AzureADPreview
Met deze opdracht wordt in de PowerShell-galerie gecontroleerd of er een nieuwere versie beschikbaar is. Zo ja, de nieuwer dan de versie die op uw computer is geïnstalleerd.
Verbinding maken met Azure AD
Voordat u de cmdlets die in dit artikel worden besproken, kunt uitvoeren, moet u verbinding maken met uw online service. U doet dit door de cmdlet Connect-AzureAD via de opdrachtprompt van Windows PowerShell uit te voeren. U wordt vervolgens gevraagd om uw referenties. Desgewenst kunt u uw referenties vooraf opgeven. Een voorbeeld hiervan:
$AzureAdCred = Get-Credential
Connect-AzureAD -Credential $AzureAdCred
De eerste opdracht vraagt om de referenties en slaat deze op als $AzureAdCred. De volgende opdracht gebruikt deze referenties als $azureadcred om verbinding te maken met de service.
Notitie
De Azure AD- en Azure AD Preview-modules bestaan uit cmdlets met verschillende naamconventies, zoals -AzureAD en -AzureADMS. De -AzureAD cmdlets maken verbinding met het Azure AD Graph-eindpunt https://graph.windows.net terwijl de -AzureADMS cmdlets het Microsoft Graph-eindpunt graph.microsoft.comaanroepen doen. Verificatie wordt op de achtergrond verwerkt wanneer u de aanroepen van het ene eindpunt naar het andere wijzigt en u niet opnieuw om de referenties wordt gevraagd.
Als u verbinding wilt maken met een specifieke omgeving van Azure Active Directory, gebruikt u de parameter AzureEnvironment op de volgende manier:
Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"
In dit voorbeeld wordt voor uw PowerShell-sessie verbinding gemaakt met de Duitse Azure AD-omgeving. Zie Connect-AzureAD voor meer informatie.