Ansluta till Microsoft 365 med Microsoft Graph PowerShell
Denna artikel gäller för både Microsoft 365 Enterprise och Office 365 Enterprise.
Med Microsoft Graph PowerShell kan du hantera dina Microsoft 365-inställningar från kommandoraden. Den här artikeln visar hur du installerar den programvara som krävs och sedan ansluter till din Microsoft 365-organisation med hjälp av Microsoft Graph PowerShell SDK.
För närvarande ersätter inte Azure Active Directory PowerShell för Graph-modulen helt funktionerna i Microsoft Azure Active Directory-modulen för Windows PowerShell för hantering av programproxy, användare och kontaktadministration. I vissa fall måste du använda båda versionerna. Du kan på ett säkert sätt installera båda versionerna på samma dator.
Vad behöver jag veta innan jag börjar?
Obs!
PowerShell-modulen Azure Active Directory (AzureAD) är inaktuell och ersätts av Microsoft Graph PowerShell SDK. Du kan använda Microsoft Graph PowerShell SDK för att komma åt alla Microsoft Graph API:er. Mer information finns i Komma igång med Microsoft Graph PowerShell SDK.
Mer information om hur du installerar och uppgraderar till Microsoft Graph PowerShell finns i Installera Microsoft Graph PowerShell SDK och Uppgradera från Azure AD PowerShell till Microsoft Graph PowerShell.
Förutsättningar
PowerShell 7 och senare är den rekommenderade PowerShell-versionen för användning med Microsoft Graph PowerShell SDK på alla plattformar. Det finns inga andra krav för att använda SDK med PowerShell 7 eller senare.
Följande krav krävs för att använda Microsoft Graph PowerShell SDK med Windows PowerShell.
- Uppgradera till PowerShell 5.1 eller senare
- Installera .NET Framework 4.7.2 eller senare
- Uppdatera PowerShellGet till den senaste versionen med hjälp av Install-Module PowerShellGet
Körningsprincipen för PowerShell-skript måste vara inställd på fjärrsignerad eller mindre restriktiv. Använd Get-ExecutionPolicy för att fastställa den aktuella körningsprincipen. Mer information finns i about_Execution_Policies. Om du vill ange körningsprincipen kör du:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Operativsystem
Du måste använda en 64-bitarsversion av Windows. Du kan använda följande versioner av Windows:
Windows 11, Windows 10, Windows 8.1, Windows 8 eller Windows 7 Service Pack 1 (SP1)
Firefox Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012 eller Windows Server 2008 R2 SP1
Obs!
För Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012 och Windows Server 2008 R2 SP1 laddar du ned och installerar Windows Management Framework 5.1.
Om du vill använda Microsoft Graph PowerShell måste du använda minst PowerShell version 5.1.
Obs!
De här procedurerna är avsedda för användaren som är medlemmar i en administratörs roll för Microsoft 365. Mer information finns i Om administratörsroller.
Ansluta med Microsoft Graph PowerShell
I det här avsnittet får du lära dig hur du ansluter till din Microsoft 365-organisation med hjälp av Microsoft Graph PowerShell SDK. Mer information finns i Installera Microsoft Graph PowerShell SDK .
Steg 1: Installera den programvara som krävs
Microsoft Graph PowerShell SDK publiceras i PowerShell-galleriet.
De här stegen krävs bara en gång på din dator. Du behöver dock förmodligen uppdatera programvaran med jämna mellanrum.
Installera Microsoft Graph PowerShell SDK och betamodulen
Microsoft Graph PowerShell SDK finns i två moduler, Microsoft.Graph och Microsoft.Graph.Beta, som du installerar separat. De här modulerna anropar betaslutpunkterna Microsoft Graph v1.0 respektive Microsoft Graph. Du kan installera de två modulerna på samma PowerShell-version.
Öppna ett Windows PowerShell kommandotolkfönster. Beroende på behörigheterna för ditt inloggade konto kan du behöva öppna PowerShell-fönstret i administratörsläge.
Kör följande kommando för att installera v1-modulen för SDK i PowerShell Core eller Windows PowerShell:
Install-Module Microsoft.Graph -Scope CurrentUserKör det här kommandot för att installera betamodulen:
Install-Module Microsoft.Graph.Beta
När installationen är klar kan du verifiera den installerade versionen med följande kommando:
Get-InstalledModule Microsoft.Graph
Steg 2: Ansluta till din Microsoft 365-prenumeration
PowerShell SDK stöder två typer av autentisering: delegerad åtkomst och åtkomst endast för appar. I den här guiden använder du delegerad åtkomst för att logga in som användare, bevilja medgivande till SDK:t för att agera åt dig och anropa Microsoft Graph.
Mer information om hur du använder appåtkomst för obevakade scenarier finns i Använda appbaserad autentisering med Microsoft Graph PowerShell SDK.
Fastställa nödvändiga behörighetsomfattningar
Varje API i Microsoft Graph skyddas av ett eller flera behörighetsomfång. Användaren som loggar in måste godkänna något av de nödvändiga omfången för de API:er som du planerar att använda. I det här exemplet använder vi följande API:er.
- Lista användare för att hitta användar-ID för den inloggade användaren.
- Lista joinedTeams för att hämta de Teams som användaren är medlem i.
- Lista kanaler för att hämta kanalerna i ett team.
- Skicka ett meddelande för att skicka ett meddelande till ett teams kanal.
Behörighetsomfånget User.Read.All aktiverar de två första anropen och omfånget Group.ReadWrite.All aktiverar resten. Dessa behörigheter kräver ett administratörskonto.
Mer information om hur du avgör vilka behörighetsomfattningar du behöver finns i Använda Find-MgGraphCommand.
Kör följande kommando för att ansluta till din Microsoft 365-organisation:
Connect-MgGraph -Scopes "User.Read.All","Group.ReadWrite.All"
Kommandot uppmanar dig att gå till en webbsida för att logga in med dina autentiseringsuppgifter. När du har gjort det visar kommandot att det lyckades med ett Välkommen till Microsoft Graph! -meddelande. Du behöver bara logga in en gång per session.
Tips
Du kan lägga till behörigheter genom att upprepa kommandot Connect-MgGraph med de nya behörighetsomfattningarna.