Maken verbinding met Microsoft 365 met PowerShell

• 07/17/2020
• 6 minuten om te lezen
• • J
  • D
  • m
  • d

Dit artikel is van toepassing op zowel Microsoft 365 Enterprise als Office 365 Enterprise.

PowerShell voor Microsoft 365 stelt u in staat uw Microsoft 365-instellingen vanaf de opdrachtregel te beheren. Om verbinding te maken met PowerShell, installeert u gewoon de vereiste software en maakt u vervolgens verbinding met uw Microsoft 365-organisatie.

Er zijn twee versies van de PowerShell-module die u kunt gebruiken om verbinding te maken met Microsoft 365 en gebruikersaccounts, groepen en licenties te beheren:

• Azure Active Directory PowerShell for Graph, waarvan de cmdlets AzureAD in hun naam bevatten
• Microsoft Azure Active Directory Module for Windows PowerShell, waarvan de cmdlets Msol in hun naam bevatten

De Azure Active Directory PowerShell for Graph-module vervangt momenteel niet volledig de functionaliteit van de Microsoft Azure Active Directory Module for Windows PowerShell-module voor het beheer van gebruikers, groepen en licenties. In sommige gevallen moet u beide versies gebruiken. U kunt beide versies veilig op dezelfde computer installeren.

Wat moet u weten voordat u begint?

Besturingssysteem

U moet een 64-bits versie van Windows gebruiken. De ondersteuning voor de 32-bits versie van de Microsoft Azure Active Directory-module voor Windows PowerShell is in 2014 beëindigd.

U kunt de volgende versies van Windows gebruiken:

• Windows 10, Windows 8.1, Windows 8 of Windows 7 Service Pack 1 (SP1)

• Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012 of Windows Server 2008 R2 SP1

PowerShell

• Voor de module Azure Active Directory PowerShell for Graph moet u PowerShell versie 5.1 of later gebruiken.

• Voor de module Azure Active Directory PowerShell for Graph moet u PowerShell versie 5.1 of later gebruiken.1 of later.

• Voor de Microsoft Azure Active Directory-module voor Windows PowerShell-module moet u PowerShell versie 5.1 of later gebruiken, tot PowerShell versie 6. U kunt PowerShell-versie 7 niet gebruiken.

Koppelen met de Azure Active Directory PowerShell for Graph-module

Commando’s in de Azure Active Directory PowerShell for Graph-module hebben AzureAD in hun cmdletnaam. U kunt de Azure Active Directory PowerShell for Graph-module of Azure PowerShell installeren.

Voor procedures waarvoor de nieuwe cmdlets in de Azure Active Directory PowerShell for Graph-module zijn vereist, volgt u deze stappen om de module te installeren en verbinding te maken met uw Microsoft 365-abonnement.

Stap 1: Installeer de vereiste software

Deze stappen zijn slechts één keer nodig op uw computer. Maar u zult de software waarschijnlijk regelmatig moeten bijwerken.

1. Open een hoog Windows PowerShell-opdrachtpromptvenster (voer Windows PowerShell uit als beheerder).

2. Uitvoeren van deze opdracht:

   Install-Module -Name AzureAD

   Als u wordt gevraagd een module uit een niet-vertrouwde opslagplaats te installeren, typt u J en drukt u op Enter.

Stap 2: verbinding maken met Azure AD voor uw Microsoft 365-abonnement

Om verbinding te maken met Azure Active Directory (Azure AD) voor uw Microsoft 365-abonnement met een accountnaam en wachtwoord of met multifactorauthenticatie, voert u een van deze opdrachten uit vanaf een Windows PowerShell-opdrachtprompt. (Het hoeft niet verheven te zijn.)

In het dialoogvenster Aanmelden bij uw account typt u de gebruikersnaam en het wachtwoord van uw Microsoft 365-werk- of schoolaccount en vervolgens selecteert u OK.

Als u multifactorauthenticatie gebruikt, volgt u de instructies om aanvullende verificatiegegevens op te geven, zoals een verificatiecode.

Nadat u verbinding hebt gemaakt, kunt u de cmdlets voor de Azure Active Directory PowerShell for Graph-module gebruiken.

Verbinden met de Microsoft Azure Active Directory Module voor Windows PowerShell

PowerShell versie 7 en later bieden geen ondersteuning voor de Microsoft Azure Active Directory Module voor Windows PowerShell module en cmdlets met Msol in hun naam. Voor PowerShell versie 7 en later moet u de module Azure Active Directory PowerShell for Graph of Azure PowerShell gebruiken.

PowerShell Core biedt geen ondersteuning voor de module Microsoft Azure Active Directory for Windows PowerShell en cmdlets met Msol in hun naam. Voer deze cmdlets uit vanuit Windows PowerShell.

Stap 1: Installeer de benodigde software

Deze stappen zijn slechts één keer nodig op uw computer. Maar u zult de software waarschijnlijk regelmatig moeten bijwerken.

1. Als u Windows 10 niet gebruikt, installeert u de 64-bits versie van de Microsoft Online Services Sign-in Assistant: Microsoft Online Services Sign-in Assistant for IT Professionals RTW.

2. Volg deze stappen om de Microsoft Azure Active Directory-module voor Windows PowerShell te installeren:

   1. Open een verhoogde Windows PowerShell-opdrachtprompt (voer Windows PowerShell uit als beheerder).
   2. Uitvoeren van de Install-Module MSOnline commando.
   3. Als u wordt gevraagd om de NuGet provider te installeren, type Y en druk op Enter.
   4. Als u wordt gevraagd om de module van PSGallery te installeren, type Y en druk op Enter.

Stap 2: maak verbinding met Azure AD voor uw Microsoft 365-abonnement

Om verbinding te maken met Azure AD voor uw Microsoft 365-abonnement met een accountnaam en wachtwoord of met multifactorauthenticatie, voert u een van deze opdrachten uit vanaf een Windows PowerShell-opdrachtprompt. (Het hoeft niet verheven te zijn.)

In het dialoogvenster Aanmelden bij uw account typt u de gebruikersnaam en het wachtwoord van uw Microsoft 365-werk- of schoolaccount en vervolgens selecteert u OK.

Als u multifactorauthenticatie gebruikt, volgt u de instructies om aanvullende verificatiegegevens op te geven, zoals een verificatiecode.

Hoe weet u of het is gelukt?

Als u geen foutmelding krijgt, hebt u met succes verbinding gemaakt. Voer voor een snelle test een Microsoft 365 cmdlet uit, zoals Get-MsolUser, en bekijk de resultaten.

Krijgt u wel een foutmelding, controleer dan de volgende zaken:

• Een veelvoorkomend probleem is een onjuist wachtwoord. Voer stap 2 opnieuw uit en let goed op de gebruikersnaam en het wachtwoord die u invoert.

• De Microsoft Azure Active Directory-module voor Windows PowerShell vereist dat Microsoft .NET Framework 3.5.x is ingeschakeld op uw computer. Waarschijnlijk is op uw computer een nieuwere versie geïnstalleerd (bijvoorbeeld 4 of 4.5.x). Maar achterwaartse compatibiliteit met oudere versies van het .NET Framework kan worden in- of uitgeschakeld. Raadpleeg de volgende artikelen voor meer informatie:

  • Voor Windows Server 2012 of Windows Server 2012 R2, zie .NET Framework 3.5 inschakelen met behulp van de wizard Rollen en functies toevoegen.

  • Voor Windows 7 of Windows Server 2008 R2, zie U kunt de Azure Active Directory-module niet openen voor Windows PowerShell.

  • Voor Windows 10, Windows 8.1 en Windows 8, zie Het .NET Framework 3.5 installeren op Windows 10, Windows 8.1 en Windows 8.

• Mogelijk is uw versie van de Microsoft Azure Active Directory-module voor Windows PowerShell verouderd. Voer ter controle de volgende opdracht uit in PowerShell voor Microsoft 365 of de Microsoft Azure Active Directory Module voor Windows PowerShell:

  (Get-Item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion

  Als het geretourneerde versienummer lager is dan 1.0.8070.2, verwijdert u de Microsoft Azure Active Directory Module voor Windows PowerShell en installeert u vanaf stap 1 hierboven.

• Als u een verbindingsfoutmelding krijgt, raadpleegt u de foutmelding “Connect-MsolService: Exception of type was thrown” foutmelding.

• Als u een “Get-Item: Kan pad niet vinden” foutmelding, voer deze opdracht uit:

   (dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name

Zie ook

• Microsoft 365 beheren met PowerShell
• Aan de slag met PowerShell voor Microsoft 365
• Maak verbinding met alle Microsoft 365-services in één Windows PowerShell-venster