Koble til Microsoft 365 med Microsoft Graph PowerShell

  • Artikkel

Denne artikkelen gjelder for både Microsoft 365 Enterprise og Office 365 Enterprise.

Med Microsoft Graph PowerShell kan du administrere Microsoft 365-innstillingene fra kommandolinjen. Denne artikkelen viser deg hvordan du installerer den nødvendige programvaren og deretter kobler til Microsoft 365-organisasjonen ved hjelp av Microsoft Graph PowerShell SDK.

For øyeblikket erstatter ikke Azure Active Directory PowerShell for Graph-modulen helt funksjonaliteten til Microsoft Azure Active Directory-modulen for Windows PowerShell for programproxybehandling, bruker- og kontaktadministrasjon. I noen tilfeller må du bruke begge versjonene. Du kan trygt installere begge versjonene på samme datamaskin.

Hva må du vite før du begynner?

Obs!

Azure Active Directory (AzureAD) PowerShell-modulen avvikles og erstattes av Microsoft Graph PowerShell SDK. Du kan bruke Microsoft Graph PowerShell SDK til å få tilgang til alle Microsoft Graph API-er. Hvis du vil ha mer informasjon, kan du se Komme i gang med Microsoft Graph PowerShell SDK.

Se også Installere Microsoft Graph PowerShell SDK og oppgradere fra Azure AD PowerShell til Microsoft Graph PowerShell for informasjon om hvordan du installerer og oppgraderer til henholdsvis Microsoft Graph PowerShell.

Forutsetninger

PowerShell 7 og nyere er den anbefalte PowerShell-versjonen for bruk med Microsoft Graph PowerShell SDK på alle plattformer. Det finnes ingen andre forutsetninger for å bruke SDK med PowerShell 7 eller nyere.

Følgende forutsetninger kreves for å bruke Microsoft Graph PowerShell SDK med Windows PowerShell.

  • Oppgrader til PowerShell 5.1 eller nyere
  • Installer .NET Framework 4.7.2 eller nyere
  • Oppdater PowerShellGet til den nyeste versjonen ved hjelp av Install-Module PowerShellGet

Policyen for kjøring av PowerShell-skript må være satt til ekstern signert eller mindre restriktiv. Bruk Get-ExecutionPolicy til å bestemme gjeldende kjøringspolicy. Hvis du vil ha mer informasjon, kan du se about_Execution_Policies. Hvis du vil angi kjøringspolicyen, kjører du:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Operativsystem

Du må bruke en 64-biters versjon av Windows. Du kan bruke følgende versjoner av 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

Obs!

Last ned og installer Windows Management Framework 5.1 for Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012 R2, Windows Server 2012 R2, Windows Server 2012 og Windows Server 2008 R2 SP1.

Hvis du vil bruke Microsoft Graph PowerShell, må du minst bruke PowerShell versjon 5.1.

Obs!

Disse prosedyrene er ment for brukere som er medlemmer av en administratorrolle i Microsoft 365. Hvis du vil ha mer informasjon, kan du se Om administratorroller.

Koble til Microsoft Graph PowerShell

I denne delen lærer du hvordan du kobler til Microsoft 365-organisasjonen ved hjelp av Microsoft Graph PowerShell SDK. Du kan gå til Installer Microsoft Graph PowerShell SDK for mer veiledning.

Trinn 1: Installer den nødvendige programvaren

Microsoft Graph PowerShell SDK publiseres i PowerShell-galleriet.

Disse trinnene kreves bare én gang på datamaskinen. Du må imidlertid sannsynligvis oppdatere programvaren med jevne mellomrom.

Installer Microsoft Graph PowerShell SDK- og betamodulen

Microsoft Graph PowerShell SDK leveres i to moduler, Microsoft.Graph og Microsoft.Graph.Beta, som du installerer separat. Disse modulene kaller henholdsvis beta-endepunktene Microsoft Graph v1.0 og Microsoft Graph. Du kan installere de to modulene på samme PowerShell-versjon.

  1. Åpne et Windows PowerShell ledetekstvindu. Avhengig av tillatelsene til den påloggede kontoen, må du kanskje åpne PowerShell-vinduet i administratormodus.

  2. Hvis du vil installere v1-modulen for SDK i PowerShell Core eller Windows PowerShell, kjører du følgende kommando:

    Install-Module Microsoft.Graph -Scope CurrentUser

  3. Kjør denne kommandoen for å installere betamodulen:

    Install-Module Microsoft.Graph.Beta

Når installasjonen er fullført, kan du bekrefte den installerte versjonen med følgende kommando:

Get-InstalledModule Microsoft.Graph

Trinn 2: Koble til Microsoft 365-abonnementet

PowerShell SDK støtter to typer godkjenning: delegert tilgang og bare apptilgang. I denne veiledningen skal du bruke delegert tilgang til å logge på som bruker, gi samtykke til SDK-en til å handle på dine vegne og ringe Microsoft Graph.

Hvis du vil ha mer informasjon om hvordan du bruker bare apptilgang for uovervåkede scenarioer, kan du se Bruke bare app-godkjenning med Microsoft Graph PowerShell SDK.

Fastslå nødvendige tillatelsesomfang

Hver API i Microsoft Graph er beskyttet av ett eller flere tillatelsesomfang. Brukeren som logger på, må samtykke til ett av de nødvendige omfangene for API-ene du har tenkt å bruke. I dette eksemplet bruker vi følgende API-er.

  • Før opp brukere for å finne bruker-ID-en til den påloggede brukeren.
  • List opp joinedTeams for å få Teams som brukeren er medlem av.
  • Før opp kanaler for å få kanalene i et team.
  • Send melding for å sende en melding til en gruppekanal.

Tillatelsesomfanget User.Read.All aktiverer de to første oppkallene, og group.ReadWrite.All-omfanget aktiverer resten. Disse tillatelsene krever en administratorkonto.

Hvis du vil ha mer informasjon om hvordan du fastslår hvilke tillatelsesomfang du trenger, kan du se Bruke Finn-MgGraphCommand.

Hvis du vil koble til Microsoft 365-organisasjonen, kjører du følgende kommando:

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

Kommandoen ber deg om å gå til en nettside for å logge på med legitimasjonen din. Når du har gjort dette, angir kommandoen suksess med en velkommen til Microsoft Graph! -melding. Du trenger bare å logge på én gang per økt.

Tips

Du kan legge til tillatelser ved å gjenta kommandoen Connect-MgGraph med de nye tillatelsesomfangene.

Se også