Delen via


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.

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:

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.

Volgende stappen