Opret forbindelse til Microsoft 365 med Microsoft Graph PowerShell

  • Artikel

Denne artikel gælder både for Microsoft 365 Enterprise og Office 365 Enterprise.

Med Microsoft Graph PowerShell kan du administrere dine Microsoft 365-indstillinger fra kommandolinjen. I denne artikel kan du se, hvordan du installerer den påkrævede software og derefter opretter forbindelse til din Microsoft 365-organisation ved hjælp af Microsoft Graph PowerShell SDK.

Azure Active Directory PowerShell til Graph-modulet erstatter i øjeblikket ikke helt funktionaliteten i Microsoft Azure Active Directory-modulet for Windows PowerShell til administration af programproxyer, bruger og kontaktadministration. I nogle tilfælde skal du bruge begge versioner. Du kan sikkert installere begge versioner på den samme computer.

Hvad har du brug for at vide, før du begynder?

Bemærk!

Azure Active Directory (AzureAD) PowerShell-modulet frarådes og erstattes af Microsoft Graph PowerShell SDK. Du kan bruge Microsoft Graph PowerShell SDK til at få adgang til alle Microsoft Graph-API'er. Du kan få flere oplysninger under Kom i gang med Microsoft Graph PowerShell SDK.

Se også Installér Microsoft Graph PowerShell SDK og Upgrade from Azure AD PowerShell to Microsoft Graph PowerShell for at få oplysninger om, hvordan du installerer og opgraderer til henholdsvis Microsoft Graph PowerShell.

Forudsætninger

PowerShell 7 og nyere er den anbefalede PowerShell-version til brug sammen med Microsoft Graph PowerShell SDK på alle platforme. Der er ingen andre forudsætninger for at bruge SDK'et med PowerShell 7 eller nyere.

Følgende forudsætninger er påkrævet for at bruge Microsoft Graph PowerShell SDK sammen med Windows PowerShell.

  • Opgrader til PowerShell 5.1 eller nyere
  • Installér .NET Framework 4.7.2 eller nyere
  • Opdater PowerShellHent til den nyeste version ved hjælp af Install-Module PowerShellHent

Politikken for udførelse af PowerShell-script skal være angivet til fjernsigneret eller mindre restriktiv. Brug Get-ExecutionPolicy til at bestemme den aktuelle udførelsespolitik. Du kan få flere oplysninger under about_Execution_Policies. Hvis du vil angive kørselspolitikken, skal du køre:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Operativsystem

Du skal bruge en 64-bit version af Windows. Du kan bruge følgende versioner af Windows:

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

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

Bemærk!

Til Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012 og Windows Server 2008 R2 SP1 skal du downloade og installere Windows Management Framework 5.1.

Hvis du vil bruge Microsoft Graph PowerShell, skal du som minimum bruge PowerShell version 5.1.

Bemærk!

Disse procedurer er beregnet til brugere, der er medlemmer af en Microsoft 365-administratorrolle. Du kan få mere at vide under Om administratorroller.

Opret forbindelse med Microsoft Graph PowerShell

I dette afsnit lærer du, hvordan du opretter forbindelse til din Microsoft 365-organisation ved hjælp af Microsoft Graph PowerShell SDK. Du kan se Installér Microsoft Graph PowerShell SDK for at få mere vejledning.

Trin 1: Installér den påkrævede software

Microsoft Graph PowerShell SDK udgives i PowerShell-galleriet.

Disse trin kræves kun én gang på computeren. Du skal dog sandsynligvis opdatere softwaren med jævne mellemrum.

Installér Microsoft Graph PowerShell SDK og betamodulet

Microsoft Graph PowerShell SDK leveres i to moduler, Microsoft.Graph og Microsoft.Graph.Beta, som du installerer separat. Disse moduler kalder henholdsvis Microsoft Graph v1.0- og Microsoft Graph-betaslutpunkterne. Du kan installere de to moduler på den samme PowerShell-version.

  1. Åbn et Windows PowerShell kommandopromptvindue. Afhængigt af tilladelserne for din konto, der er logget på, skal du muligvis åbne PowerShell-vinduet i administratortilstand.

  2. Hvis du vil installere v1-modulet for SDK'et i PowerShell Core eller Windows PowerShell, skal du køre følgende kommando:

    Install-Module Microsoft.Graph -Scope CurrentUser

  3. Kør denne kommando for at installere betamodulet:

    Install-Module Microsoft.Graph.Beta

Når installationen er fuldført, kan du kontrollere den installerede version med følgende kommando:

Get-InstalledModule Microsoft.Graph

Trin 2: Opret forbindelse til dit Microsoft 365-abonnement

PowerShell SDK understøtter to typer godkendelse: uddelegeret adgang og kun appadgang. I denne vejledning skal du bruge delegeret adgang til at logge på som bruger, give samtykke til SDK'et for at handle på dine vegne og kalde Microsoft Graph.

Du kan finde flere oplysninger om brug af kun app-adgang til automatiske scenarier under Brug godkendelse kun til apps med Microsoft Graph PowerShell SDK.

Fastlæg påkrævede tilladelsesområder

Hver API i Microsoft Graph er beskyttet af et eller flere tilladelsesområder. Brugeren, der logger på, skal give samtykke til et af de påkrævede områder for de API'er, du planlægger at bruge. I dette eksempel bruger vi følgende API'er.

  • Vis brugere for at finde bruger-id'et for den bruger, der er logget på.
  • Opret en liste over tilmeldteTeams for at få de Teams, som brugeren er medlem af.
  • Vis kanaler for at hente kanalerne i et team.
  • Send en meddelelse for at sende en meddelelse til et teams kanal.

Tilladelsesomfanget User.Read.All aktiverer de første to kald, og området Group.ReadWrite.All aktiverer resten. Disse tilladelser kræver en administratorkonto.

Du kan finde flere oplysninger om, hvordan du bestemmer, hvilke tilladelsesområder du skal bruge, under Brug Find-MgGraphCommand.

Kør følgende kommando for at oprette forbindelse til din Microsoft 365-organisation:

Connect-MgGraph -Scopes "User.Read.All","Group.ReadWrite.All"

Du bliver bedt om at gå til en webside for at logge på med dine legitimationsoplysninger. Når du har gjort det, angiver kommandoen succes med meddelelsen Velkommen til Microsoft Graph! Du skal kun logge på én gang pr. session.

Tip

Du kan tilføje tilladelser ved at gentage kommandoen Connect-MgGraph med de nye tilladelsesområder.

Se også