Opret forbindelse til Microsoft 365 med PowerShell
Denne artikel gælder både for Microsoft 365 Enterprise og Office 365 Enterprise.
Med PowerShell til Microsoft 365 kan du administrere dine Microsoft 365-indstillinger fra kommandolinjen. Hvis du vil oprette forbindelse til PowerShell, skal du blot installere den nødvendige software og derefter oprette forbindelse til din Microsoft 365-organisation.
Der er to versioner af PowerShell-modulet, som du kan bruge til at oprette forbindelse til Microsoft 365 og administrere brugerkonti, grupper og licenser:
- Azure Active Directory PowerShell til Graph, hvis cmdlet'er indeholder AzureAD i deres navn
- Microsoft Azure Active Directory Modul til Windows PowerShell, hvis cmdlet'er indeholder Msol i deres navn
Azure Active Directory PowerShell til Graph-modulet erstatter i øjeblikket ikke helt funktionaliteten i Microsoft Azure Active Directory modulet for Windows PowerShell modul til bruger-, gruppe- og licensadministration. I nogle tilfælde skal du bruge begge versioner. Du kan sikkert installere begge versioner på den samme computer.
Bemærk!
Du kan også oprette forbindelse til Azure Cloud Shell fra Microsoft 365 Administration.
Hvad har du brug for at vide, før du begynder?
Bemærk!
Azure Active Directory-modulet 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.
Operativsystem
Du skal bruge en 64-bit version af Windows. Understøttelse af 32-bit versionen af Microsoft Azure Active Directory modulet for Windows PowerShell ophørt i 2014.
Du kan bruge følgende versioner af Windows:
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.
PowerShell
Til Azure Active Directory PowerShell til Graph-modulet skal du bruge PowerShell version 5.1.
I forbindelse med modulet Microsoft Azure Active Directory til Windows PowerShell skal du bruge PowerShell version 5.1 eller nyere op til PowerShell version 6. Du kan ikke bruge PowerShell version 7.
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 Azure Active Directory PowerShell til Graph-modulet
Kommandoer i Azure Active Directory PowerShell til Graph-modulet har AzureAD i deres cmdlet-navn. Du kan installere Azure Active Directory PowerShell til Graph-modulet eller Azure PowerShell.
I forbindelse med procedurer, der kræver de nye cmdlet'er i Azure Active Directory PowerShell til Graph-modulet, skal du følge disse trin for at installere modulet og oprette forbindelse til dit Microsoft 365-abonnement.
Bemærk!
Du kan få oplysninger om understøttelse af forskellige versioner af Windows i Azure Active Directory PowerShell til Graph-modulet .
Trin 1: Installér den påkrævede software
Disse trin kræves kun én gang på computeren. Men du skal sandsynligvis opdatere softwaren med jævne mellemrum.
Åbn et Windows PowerShell kommandopromptvindue.
Kør denne kommando:
Install-Module -Name AzureAD
PowerShell-galleriet (PSGallery) er som standard ikke konfigureret som et lager, der er tillid til, for PowerShellGet. Første gang du bruger PSGallery, får du vist følgende meddelelse:
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"):
Svar ja eller Ja til alle for at fortsætte installationen.
Kør denne kommando for at importere modulet:
Import-Module AzureAD
Trin 2: Opret forbindelse til Azure AD for dit Microsoft 365-abonnement
Hvis du vil oprette forbindelse til Azure Active Directory (Azure AD) for dit Microsoft 365-abonnement med et kontonavn og en adgangskode eller med multifaktorgodkendelse, skal du køre en af disse kommandoer fra en Windows PowerShell kommandoprompt. (Det behøver ikke at blive forøget).
Office 365 cloud | Kommando |
---|---|
Office 365 verdensomspændende (+GCC) | Connect-AzureAD |
Office 365 drevet af 21 Vianet | Connect-AzureAD -AzureEnvironmentName AzureChinaCloud |
Office 365 Tyskland | Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud |
Office 365 amerikanske regering dod og Office 365 amerikanske regering GCC High | Connect-AzureAD -AzureEnvironmentName AzureUSGovernment |
I dialogboksen Log på din konto skal du skrive brugernavnet og adgangskoden til din Microsoft 365 arbejds- eller skolekonto og derefter vælge OK.
Hvis du bruger multifaktorgodkendelse, skal du følge vejledningen for at angive yderligere godkendelsesoplysninger, f.eks. en bekræftelseskode.
Når du har oprettet forbindelse, kan du bruge cmdlet'erne til Azure Active Directory PowerShell til Graph-modulet.
Opret forbindelse til Microsoft Azure Active Directory modulet til Windows PowerShell
Bemærk!
Cmdlet'er i Microsoft Azure Active Directory module for Windows PowerShell har Msol i deres navn.
PowerShell version 7 og nyere understøtter ikke det Microsoft Azure Active Directory modul til Windows PowerShell modul og cmdlet'er med Msol i deres navn. Til PowerShell version 7 og nyere skal du bruge Microsoft Graph PowerShell SDK.
PowerShell Core understøtter ikke Microsoft Azure Active Directory modulet til Windows PowerShell moduler og cmdlet'er med Msol i deres navn. Kør disse cmdlet'er fra Windows PowerShell.
Trin 1: Installér den påkrævede software
Disse trin kræves kun én gang på computeren. Men du skal sandsynligvis opdatere softwaren med jævne mellemrum.
Hvis du ikke kører Windows 10, skal du installere 32-bit versionen af Microsoft Online Services Sign-in Assistant: Microsoft Online Services Sign-in Assistant for IT Professionals RTW.
Følg disse trin for at installere Microsoft Azure Active Directory modulet til Windows PowerShell:
- Åbn en kommandoprompt med administratorrettigheder Windows PowerShell (kør Windows PowerShell som administrator).
- Kør kommandoen Install-Module MSOnline .
- Hvis du bliver bedt om at installere NuGet-udbyderen, skal du skrive Y og trykke på Enter.
- Hvis du bliver bedt om at installere modulet fra PSGallery, skal du skrive Y og trykke på Enter.
Trin 2: Opret forbindelse til Azure AD for dit Microsoft 365-abonnement
Hvis du vil oprette forbindelse til Azure AD for dit Microsoft 365-abonnement med et kontonavn og en adgangskode eller med multifaktorgodkendelse, skal du køre en af disse kommandoer fra en Windows PowerShell kommandoprompt. (Det behøver ikke at blive forøget).
Office 365 cloud | Kommando |
---|---|
Office 365 verdensomspændende (+GCC) | Connect-MsolService |
Office 365 drevet af 21 Vianet | Connect-MsolService -AzureEnvironment AzureChinaCloud |
Office 365 Tyskland | Connect-MsolService -AzureEnvironment AzureGermanyCloud |
Office 365 amerikanske regering dod og Office 365 amerikanske regering GCC High | Connect-MsolService -AzureEnvironment USGovernment |
I dialogboksen Log på din konto skal du skrive brugernavnet og adgangskoden til din Microsoft 365 arbejds- eller skolekonto og derefter vælge OK.
Hvis du bruger multifaktorgodkendelse, skal du følge vejledningen for at angive yderligere godkendelsesoplysninger, f.eks. en bekræftelseskode.
Hvordan ved du, det virkede?
Hvis du ikke får vist en fejlmeddelelse, har du oprettet forbindelse. Hvis du vil have en hurtig test, skal du køre en Microsoft 365 cmdlet, f.eks Get-MsolUser, og se resultaterne.
Hvis du får vist en fejlmeddelelse, skal du kontrollere følgende problemer:
Et almindeligt problem er en forkert adgangskode. Kør trin 2 igen, og vær opmærksom på det brugernavn og den adgangskode, du angiver.
Det Microsoft Azure Active Directory modul til Windows PowerShell kræver Microsoft .NET Framework 3.5. x er aktiveret på computeren. Det er sandsynligt, at computeren har en nyere version installeret (f.eks. 4 eller 4.5. x). Men bagudkompatibilitet med ældre versioner af .NET Framework kan aktiveres eller deaktiveres. Du kan finde flere oplysninger i følgende artikler:
For Windows Server 2012 eller Windows Server 2012 R2 skal du se Aktivér .NET Framework 3.5 ved hjælp af guiden Tilføj roller og funktioner.
Du kan se Windows 7 eller Windows Server 2008 R2 under Du kan ikke åbne Azure Active Directory-modulet til Windows PowerShell.
Hvis du vil have Windows 10, Windows 8.1 og Windows 8, skal du se Installér .NET Framework 3.5 på Windows 10, Windows 8.1 og Windows 8.
Din version af Microsoft Azure Active Directory modulet til Windows PowerShell er muligvis forældet. Kør følgende kommando i PowerShell for Microsoft 365 eller Microsoft Azure Active Directory Module for Windows PowerShell for at kontrollere det:
(Get-Item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion
Hvis det returnerede versionsnummer er lavere end 1.0.8070.2, skal du fjerne Microsoft Azure Active Directory Module for Windows PowerShell og installere fra trin 1 ovenfor.
Hvis du får vist en forbindelsesfejlmeddelelse, skal du se fejlen "Connect-MsolService: Undtagelse af typen blev udløst".
Hvis du får vist fejlmeddelelsen "Hent element: Stien blev ikke fundet", skal du køre denne kommando:
(dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name
Opret forbindelse med Azure Cloud Shell
Hvis du vil oprette forbindelse til og bruge Azure Cloud Shell fra Microsoft 365 Administration, skal du vælge powershell-vinduesikonet i øverste højre hjørne af proceslinjen. I ruden Velkommen til Azure Cloud Shell skal du vælge PowerShell.
Du skal bruge et aktivt Azure-abonnement til din organisation, der er knyttet til dit Microsoft 365-abonnement. Hvis du ikke allerede har en, kan du oprette en. Når du har et Azure-abonnement, åbnes der et PowerShell-vindue, hvorfra du kan køre PowerShell-kommandoer og -scripts.
Du kan få flere oplysninger under Azure Cloud Shell.