Verbinding maken met Microsoft 365 met Microsoft Graph PowerShell
Dit artikel is van toepassing op Microsoft 365 Enterprise en Office 365 Enterprise.
Met Microsoft Graph PowerShell kunt u uw Microsoft 365-instellingen beheren vanaf de opdrachtregel. In dit artikel wordt beschreven hoe u de vereiste software installeert en vervolgens verbinding maakt met uw Microsoft 365-organisatie met behulp van de Microsoft Graph PowerShell SDK.
De azure Active Directory PowerShell voor Graph-module vervangt momenteel niet volledig de functionaliteit van de Microsoft Azure Active Directory-module voor Windows PowerShell voor toepassingsproxybeheer, gebruikers- en contactbeheer. In sommige gevallen moet u beide versies gebruiken. U kunt beide versies op dezelfde computer veilig installeren.
Wat moet u weten voordat u begint?
Opmerking
De Azure Active Directory (AzureAD) PowerShell-module wordt afgeschaft en vervangen door de Microsoft Graph PowerShell SDK. U kunt de Microsoft Graph PowerShell SDK gebruiken voor toegang tot alle Microsoft Graph API's. Zie Aan de slag met de Microsoft Graph PowerShell SDK voor meer informatie.
Zie ook De Microsoft Graph PowerShell SDK installeren en upgraden van Azure AD PowerShell naar Microsoft Graph PowerShell voor informatie over het installeren en upgraden naar Respectievelijk Microsoft Graph PowerShell.
Vereisten
PowerShell 7 en hoger is de aanbevolen PowerShell-versie voor gebruik met de Microsoft Graph PowerShell SDK op alle platforms. Er zijn geen andere vereisten voor het gebruik van de SDK met PowerShell 7 of hoger.
De volgende vereisten zijn vereist voor het gebruik van de Microsoft Graph PowerShell SDK met Windows PowerShell.
- Upgraden naar PowerShell 5.1 of hoger
- Installeer .NET Framework 4.7.2 of hoger
- PowerShellGet bijwerken naar de nieuwste versie met Install-Module PowerShellGet
Het uitvoeringsbeleid voor PowerShell-scripts moet zijn ingesteld op extern ondertekend of minder beperkend. Gebruik Get-ExecutionPolicy om het huidige uitvoeringsbeleid te bepalen. Raadpleeg about_Execution_Policies voor meer informatie. Voer het volgende uit om het uitvoeringsbeleid in te stellen:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Besturingssysteem
Je moet een 64-bits versie van Windows gebruiken. U kunt de volgende versies van Windows gebruiken:
Windows 11, 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
Opmerking
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.
Als u Microsoft Graph PowerShell wilt gebruiken, moet u ten minste PowerShell versie 5.1 gebruiken.
Opmerking
Deze procedures zijn bedoeld voor gebruikers die lid zijn van een Microsoft 365-beheerdersrol. Raadpleeg Over beheerdersrollen voor meer informatie.
Verbinding maken met Microsoft Graph PowerShell
In deze sectie leert u hoe u verbinding maakt met uw Microsoft 365-organisatie met behulp van de Microsoft Graph PowerShell SDK. Ga naar De Microsoft Graph PowerShell SDK installeren voor meer informatie.
Stap 1:Installeer de vereiste software
De Microsoft Graph PowerShell SDK wordt gepubliceerd in de PowerShell Gallery.
Deze stappen hoef je maar één keer uit te voeren op je computer. Waarschijnlijk moet u de software echter regelmatig bijwerken.
De Microsoft Graph PowerShell SDK en bètamodule installeren
De Microsoft Graph PowerShell SDK bestaat uit twee modules, Microsoft.Graph en Microsoft.Graph.Beta, die u afzonderlijk installeert. Deze modules roepen respectievelijk de microsoft Graph v1.0- en Microsoft Graph-bèta-eindpunten aan. U kunt de twee modules op dezelfde PowerShell-versie installeren.
Open een Windows PowerShell opdrachtpromptvenster. Afhankelijk van de machtigingen van uw aangemelde account, moet u mogelijk het PowerShell-venster openen in de beheerdersmodus.
Voer de volgende opdracht uit om de v1-module van de SDK te installeren in PowerShell Core of Windows PowerShell:
Install-Module Microsoft.Graph -Scope CurrentUserVoer deze opdracht uit om de bètamodule te installeren:
Install-Module Microsoft.Graph.Beta
Nadat de installatie is voltooid, kunt u de geïnstalleerde versie controleren met de volgende opdracht:
Get-InstalledModule Microsoft.Graph
Stap 2: verbinding maken met uw Microsoft 365-abonnement
De PowerShell SDK ondersteunt twee typen verificatie: gedelegeerde toegang en alleen-app-toegang. In deze handleiding gebruikt u gedelegeerde toegang om u aan te melden als gebruiker, toestemming te verlenen aan de SDK om namens u te handelen en microsoft Graph aan te roepen.
Zie Use app-only authentication with the Microsoft Graph PowerShell SDK (Alleen-app-verificatie gebruiken met de Microsoft Graph PowerShell SDK) voor meer informatie over het gebruik van alleen-apps voor scenario's zonder toezicht.
Vereiste machtigingsbereiken bepalen
Elke API in Microsoft Graph wordt beveiligd door een of meer machtigingsbereiken. De gebruiker die zich aanmeldt, moet toestemming geven voor een van de vereiste bereiken voor de API's die u wilt gebruiken. In dit voorbeeld gebruiken we de volgende API's.
- Gebruikers weergeven om de gebruikers-id van de aangemelde gebruiker te vinden.
- Lijst toegevoegdTeams om de Teams op te halen waarvan de gebruiker lid is.
- Kanalen weergeven om de kanalen in een team op te halen.
- Bericht verzenden om een bericht te verzenden naar het kanaal van een team.
Het machtigingsbereik User.Read.All schakelt de eerste twee aanroepen in en het bereik Group.ReadWrite.All schakelt de rest in. Voor deze machtigingen is een beheerdersaccount vereist.
Zie Find-MgGraphCommand gebruiken voor meer informatie over het bepalen van welke machtigingsbereiken u nodig hebt.
Voer de volgende opdracht uit om verbinding te maken met uw Microsoft 365-organisatie:
Connect-MgGraph -Scopes "User.Read.All","Group.ReadWrite.All"
Met de opdracht wordt u gevraagd naar een webpagina te gaan om u aan te melden met uw referenties. Zodra u dat hebt gedaan, geeft de opdracht aan dat het is gelukt met het bericht Welkom bij Microsoft Graph! . U hoeft u slechts één keer per sessie aan te melden.
Tip
U kunt machtigingen toevoegen door de opdracht Connect-MgGraph te herhalen met de nieuwe machtigingsbereiken.