Azure Active Directory PowerShell voor Graph

  • Artikel

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, zijn anders dan de MSOL-cmdlets die deel uitmaken van de MSOnline PowerShell-module.

De Azure AD PowerShell voor Graph-module heeft twee versies: een openbare preview en een versie voor algemene beschikbaarheid. Het wordt afgeraden om de openbare preview-versie te gebruiken voor productiescenario's.

De preview-module Azure AD PowerShell voor Graph kan worden gedownload van de PowerShell Gallery op de pagina AzureADPreview.

De module Azure AD PowerShell voor Algemene beschikbaarheid van Graph kan worden gedownload van de PowerShell Gallery op de AzureAD-pagina.

De Azure AD-module installeren

De Azure AD PowerShell voor Graph 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 of Windows Server 2008 R2.

Als uw computer voldoet aan alle vereisten om hierop de versie voor algemene beschikbaarheid van de module te installeren, kunt u de volgende opdracht uitvoeren:

Install-Module AzureAD

Als u de openbare preview-versie wilt installeren, voert u deze opdracht uit:

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.

De Azure AD-module wordt samen met de PowerShell Gallery gedistribueerd. Als u items uit deze galerie wilt installeren, is de nieuwste versie van de PowerShellGet-module vereist. Deze is beschikbaar in Windows 10, in Windows Management Framework (WMF) 5.0 en in het installatieprogramma op basis van MSI (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

U kunt controleren welke versie van de module er op uw computer is geïnstalleerd, door deze opdracht uit te voeren:

PS C:\WINDOWS\system32> 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:

PS C:\WINDOWS\system32> Install-Module AzureADPreview

Met deze opdracht wordt er in de PowerShell Gallery nagegaan of er een nieuwere versie beschikbaar is. Als dit het geval is, wordt deze op uw computer geïnstalleerd ter vervanging van de versie die daar momenteel op staat.

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.

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.

Suggesties?

Als u suggesties hebt voor het verbeteren van Azure Active Directory PowerShell, laat het ons dan weten .

Meer informatie over Windows PowerShell

Windows PowerShell is een op taken gebaseerde opdrachtregelshell en scripttaal die is ontworpen voor systeembeheer. In tegenstelling tot de meeste andere beheershells, die tekst accepteren en retourneren, is Windows PowerShell gebaseerd op het .NET Framework, en worden er .NET Framework-objecten geaccepteerd en geretourneerd.

Windows PowerShell introduceert het concept van een cmdlet (spreek uit 'command-let'). Een cmdlet is een eenvoudig opdrachtregelprogramma met één functie dat is ingebouwd in de shell. Voor cmdlets wordt de volgende naamconventie gebruikt: een werkwoord en een zelfstandig naamwoord, gescheiden door een streepje (-). Enkele voorbeelden zijn Get-Help, Get-Process en Start-Service. Windows PowerShell bevat meer dan honderd basis-cmdlets.

Voor meer informatie over de beschikbare cmdlets en de syntaxis hiervan gebruikt u de opdracht Get-Help <cmdlet name>. Hierbij staat <cmdlet name> voor de naam van de cmdlet waarover u meer wilt weten. Voer voor uitgebreidere informatie een van de volgende opdrachten uit:

  • Get-Help <cmdlet name> -Detailed
  • Get-Help <cmdlet name> -Examples
  • Get-Help <cmdlet name> -Full

Zie Aan de slag met Windows PowerShell voor meer informatie over Windows PowerShell.