Azure Active Directory PowerShell voor Graph installeren

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 hier vermelde cmdlets 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 algemene beschikbaarheidsversie . Wij raden u niet aan de openbare preview-versie te gebruiken voor productiescenario’s.

Als u de modules wilt downloaden van de PowerShell Gallery gebruikt u het volgende;

• AzureADPreview
• AzureAD

Versiegeschiedenis van versiegeschiedenis van Azure Active Directory PowerShell voor Graph

De releasegeschiedenis voor de Azure AD-module en de Azure AD Preview-module is hier:azure Active Directory PowerShell voor 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.

Als u de versie algemene beschikbaarheid van de module wilt installeren, voert u het volgende uit:

Install-Module AzureAD

Voer de volgende opdracht uit om de openbare preview-versie te installeren:

Install-module AzureADPreview

Houd er rekening mee dat de preview-versie en de versie voor algemene beschikbaarheid niet tegelijkertijd op dezelfde computer mogen zijn geïnstalleerd.

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).

• Windows 10 downloaden,
• WMF 5.0 downloaden of
• MSI-installatieprogramma downloaden

Met de nieuwste PowerShellGet-module kunt u het volgende doen:

• De items in de galerie doorzoeken met Find-Module en Find-Script
• Items opslaan in 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 deze 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 nogmaals uit:

Install-Module AzureADPreview

Met deze opdracht wordt de PowerShell-galerie gecontroleerd om te zien of er een nieuwere versie beschikbaar is. Zo ja, de nieuwer dan degene 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, bijvoorbeeld -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. Verificatie wordt op de achtergrond verwerkt wanneer u de aanroepen van het ene eindpunt naar het andere wijzigt en u niet opnieuw wordt gevraagd om de referenties.

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

• Zie de nieuwe functies en verbeteringen.