Verbinding maken met Microsoft 365 met PowerShell

Dit artikel is van toepassing op Microsoft 365 Enterprise en Office 365 Enterprise.

Met PowerShell voor Microsoft 365 kun je de instellingen van Microsoft 365 beheren vanaf de opdrachtregel. Als je verbinding wilt maken met PowerShell, installeer je gewoon de vereiste software en maak je verbinding met je Microsoft 365-organisatie.

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

  • Azure Active Directory PowerShell voor Graph, waarvan de cmdlets AzureAD in de naam hebben
  • Microsoft Azure Active Directory-module voor Windows PowerShell, waarvan cmdlets MSol in de naam hebben

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

Notitie

U kunt ook verbinding maken met Azure Cloud Shell vanuit het Microsoft 365-beheercentrum.

Wat moet u weten voordat u begint?

Besturingssysteem

Gebruik een 64-bits versie van Windows. 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

Notitie

Voor Windows 8,1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012 en Windows Server 2008 R2 SP1 kunt u het Windows Management Framework 5.1downloaden en installeren.

PowerShell

  • Voor de module Azure Active Directory PowerShell voor Graph moet je PowerShell versie 5.1 of hoger gebruiken.

  • Voor de Microsoft Azure Active Directory-module voor Windows PowerShell moet u PowerShell versie 5.1 of hoger gebruiken, tot PowerShell versie 6. PowerShell versie 7 kan niet meer worden gebruikt.

Notitie

Deze procedures zijn bedoeld voor gebruikers die lid zijn van een Microsoft 365-beheerdersrol. Raadpleeg Over beheerdersrollen voor meer informatie.

Maak verbinding met de Windows PowerShell voor Graph-module van Microsoft Azure Active Directory.

Opdrachten in de module Azure Active Directory PowerShell voor Graph hebben AzureAD in de naam van de cmdlet. U kunt de module Azure Active Directory PowerShell voor Graph of Azure PowerShell installeren.

Voer de volgende stappen uit om de module te installeren en verbinding te maken met je Microsoft 365-abonnement voor procedures waarvoor de nieuwe cmdlets in de module Azure Active Directory PowerShell voor Graph zijn vereist.

Notitie

Zie Module Azure Active Directory PowerShell voor Graph voor informatie over de ondersteuning voor verschillende versies van Microsoft Windows.

Stap 1:Installeer de vereiste software

Deze stappen hoef je maar één keer uit te voeren op je computer. Maar waarschijnlijk moet je de software regelmatig bijwerken.

  1. Open een Windows PowerShell-opdrachtprompt met verhoogde bevoegdheid (voer Windows PowerShell uit als beheerder).

  2. Voer de volgende opdracht uit:

    Install-Module -Name AzureAD
    

PowerShell Gallery (PSGallery) is niet geconfigureerd als vertrouwde opslagplaats voor PowerShellGet. De eerste keer dat u PSGallery gebruikt, ziet u het volgende bericht:

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the `Set-PSRepository` cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

Antwoord Ja of Ja op alles om door te gaan met de installatie.

Stap 2: Maak verbinding met Azure AD voor jouw Microsoft 365-abonnement

Als u verbinding wilt maken met Azure Active Directory (Azure AD) voor uw Microsoft 365-abonnement met een accountnaam en wachtwoord of met meervoudige verificatie, voert u een van de volgende opdrachten uit vanaf een Windows PowerShell-opdrachtprompt (de opdracht hoeft geen verhoogde bevoegdheden te bevatten).

Office 365-cloud Opdracht
Office 365 wereldwijd (+ GCC) Connect-AzureAD
Office 365 beheerd door 21 Vianet Connect-AzureAD -AzureEnvironmentName AzureChinaCloud
Office 365 Germany Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud
Office 365 U.S. Government DoD en Office 365 U.S. Government GCC High Connect-AzureAD -AzureEnvironmentName AzureUSGovernment

Typ de gebruikersnaam en het wachtwoord voor jouw werk- of schoolaccount van Microsoft 365 in het dialoogvenster Aanmelden bij uw account en selecteer vervolgens OK.

Als je meervoudige verificatie gebruikt, volg je de instructies om aanvullende verificatiegegevens op te geven, zoals een verificatiecode.

Nadat je verbinding hebt gemaakt, kun je de cmdlets voor de module Azure Active Directory PowerShell voor Graph gebruiken.

Maak verbinding met de Microsoft Azure Active Directory-module voor Windows PowerShell

Notitie

Cmdlets in de Microsoft Azure Active Directory-module voor Windows PowerShell hebben MSol in de naam.

PowerShell versie 7 biedt geen ondersteuning voor de Microsoft Azure Active Directory-module voor Windows PowerShell en cmdlets met Msol in de naam. Voor PowerShell versie 7 en hoger moet je de module Azure Active Directory PowerShell voor Graph gebruiken.

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

Stap 1:Installeer de vereiste software

Deze stappen hoef je maar één keer uit te voeren op je computer. Maar waarschijnlijk moet je de software regelmatig bijwerken.

  1. Als je geen Windows 10 gebruikt, installeer je de 64-bits versie van de Microsoft Online Services-aanmeldhulp: Microsoft Online Services-aanmeldhulp voor IT-professionals RTW.

  2. Installeer de Microsoft Azure Active Directory-module voor Windows PowerShell met deze stappen:

    1. Open een verhoogde Windows PowerShell-opdrachtprompt (Voer Windows PowerShell uit als beheerder).
    2. Voer de installatie-module MSOnline uit.
    3. Als je wordt gevraagd om de NuGet-provider te installeren, typ je Y en druk je op Enter.
    4. Als je wordt gevraagd om de module van PSGallery te installeren, typ je Y en druk je op Enter.

Stap 2: Maak verbinding met Azure AD voor jouw Microsoft 365-abonnement

Als u verbinding wilt maken met Azure AD voor uw Microsoft 365-abonnement met een accountnaam en wachtwoord of met meervoudige verificatie, voert u een van de volgende opdrachten uit vanaf een Windows PowerShell-opdrachtprompt (deze hoeft geen verhoogde bevoegdheden te bevatten).

Office 365-cloud Opdracht
Office 365 wereldwijd (+ GCC) Connect-MsolService
Office 365 beheerd door 21 Vianet Connect-MsolService -AzureEnvironment AzureChinaCloud
Office 365 Germany Connect-MsolService -AzureEnvironment AzureGermanyCloud
Office 365 U.S. Government DoD en Office 365 U.S. Government GCC High Connect-MsolService -AzureEnvironment USGovernment

Typ de gebruikersnaam en het wachtwoord voor jouw werk- of schoolaccount van Microsoft 365 in het dialoogvenster Aanmelden bij uw account en selecteer vervolgens OK.

Als je meervoudige verificatie gebruikt, volg je de instructies om aanvullende verificatiegegevens op te geven, zoals een verificatiecode.

Hoe weet ik dat het werkt?

Als je geen foutmelding krijgt, ben je verbonden. Een snelle test is het uitvoeren van een Microsoft 365-cmdlet, bijvoorbeeld Get-MsolUser, en bekijk de resultaten.

Als er een foutbericht wordt weergegeven, controleer je de volgende problemen:

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

  • De Microsoft Azure Active Directory-module voor Windows PowerShell vereist dat Microsoft .NET Framework 3.5. x is ingeschakeld op de computer**. Op je computer is waarschijnlijk een nieuwere versie geïnstalleerd (bijvoorbeeld 4 of 4.5.* x*). Maar compatibiliteit met eerdere versies van .NET Framework kan worden ingeschakeld of uitgeschakeld. Zie de volgende artikelen voor meer informatie:

  • Uw versie van de module Microsoft Azure Active Directory voor Windows PowerShell is wellicht verouderd. Als u dit wilt controleren, voert u 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 de waarde 1.0.8070.2, verwijder je de Microsoft Azure Active Directory-module voor Windows PowerShell en installeer je deze vanuit Stap 1 hierboven.

  • Als je een verbindingsfoutbericht krijgt, raadpleeg je Foutbericht 'Connect-MsolService: Exception of type was thrown'.

  • Als je de foutmelding 'Get-Item: Cannot find path' krijgt, voer je de volgende opdracht uit:

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

Verbinding maken met Azure Cloud Shell

Als u verbinding wilt maken met Azure Cloud Shell vanuit het Microsoft 365-beheercentrum en dit wilt gebruiken, selecteert u in de rechterbovenhoek van de taakbalk het PowerShell-vensterpictogram. Selecteer in het deelvenster Welkom bij Azure Cloud Shell de optie PowerShell.

Voor uw organisatie hebt u een actief Azure-abonnement nodig dat is gekoppeld aan uw Microsoft 365-abonnement. Als u nog geen account hebt, kunt u er een maken. Zodra u een Azure-abonnement hebt, wordt er een PowerShell-venster geopend waarin u PowerShell-opdrachten en -scripts kunt uitvoeren.

Zie Azure Cloud Shell voor meer informatie.

Zie ook