Azure Active Directory PowerShell voor Graph installeren

  • Artikel

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