Connect to Microsoft 365 with PowerShell

• 07/17/2020
• 6 minutes to read
• • J
  • D
  • m
  • d

Tämä artikkeli koskee sekä Microsoft 365 Enterprisea että Office 365 Enterprisea.

PowerShell for Microsoft 365 mahdollistaa Microsoft 365 -asetusten hallinnan komentoriviltä. Jos haluat muodostaa yhteyden PowerShelliin, asenna tarvittava ohjelmisto ja muodosta yhteys Microsoft 365 -organisaatioon.

PowerShell-moduulista on kaksi versiota, joiden avulla voit muodostaa yhteyden Microsoft 365:een ja hallita käyttäjätilejä, ryhmiä ja lisenssejä:

• Azure Active Directory PowerShell for Graph, jonka cmdlettien nimessä on AzureAD
• Microsoft Azure Active Directory Module for Windows PowerShell, jonka cmdlettien nimessä on Msol

Nykyisin Azure Active Directory PowerShell for Graph -moduuli ei korvaa täysin Microsoft Azure Active Directory Module for Windows PowerShell -moduulin toiminnallisuutta käyttäjä-, ryhmä- ja lisenssienhallinnassa. Joissakin tapauksissa sinun on käytettävä molempia versioita. Voit asentaa molemmat versiot turvallisesti samaan tietokoneeseen.

Mitä sinun on tiedettävä, ennen kuin aloitat?

Käyttöjärjestelmä

Sinun on käytettävä 64-bittistä Windows-versiota. Microsoft Azure Active Directory Module for Windows PowerShellin 32-bittisen version tuki päättyi vuonna 2014.

Voit käyttää seuraavia Windows-versioita:

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

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

PowerShell

• Azure Active Directory PowerShell for Graph -moduulin käyttämiseen on käytettävä PowerShellin versiota 5.1 tai uudempi.

• Microsoft Azure Active Directory Module for Windows PowerShell -moduulissa on käytettävä PowerShell-versiota 5.1 tai uudempaa, enintään PowerShell-versiota 6. PowerShell-versiota 7 ei voi käyttää.

Yhteyden muodostaminen Azure Active Directory PowerShell for Graph -moduuliin

Azure Active Directory PowerShell for Graph -moduulin komentojen cmdlet-nimessä on AzureAD. Voit asentaa Azure Active Directory PowerShell for Graph -moduulin tai Azure PowerShellin.

Jos menettelyt edellyttävät Azure Active Directory PowerShell for Graph -moduulin uusia komentokomentoja, asenna moduuli ja muodosta yhteys Microsoft 365 -tilaukseesi seuraavien ohjeiden mukaisesti.

Vaihe 1: Asenna tarvittava ohjelmisto

Nämä vaiheet vaaditaan vain kerran tietokoneeseen. Sinun on kuitenkin todennäköisesti päivitettävä ohjelmisto säännöllisesti.

1. Avaa kohotettu Windows PowerShell Command Prompt -ikkuna (suorita Windows PowerShell järjestelmänvalvojana).

2. Suorita tämä komento:

   Install-Module -Name AzureAD

   Jos sinua pyydetään asentamaan moduuli epäluotettavasta arkistosta, kirjoita Y ja paina Enter.

Vaihe 2: Yhteyden muodostaminen Azure AD:hen Microsoft 365 -liittymääsi varten

Voidaksesi muodostaa yhteyden Azure Active Directoryyn (Azure AD) Microsoft 365 -liittymääsi varten tilinimellä ja salasanalla tai monitekijätodennuksen avulla suorita jokin seuraavista komennoista Windows PowerShell -komentokehotteesta. (Sen ei tarvitse olla korotettu.)

Kirjoita kirjaudu tilillesi -valintaikkunassa Microsoft 365 -työtilin tai koulutilin käyttäjänimi ja salasana ja valitse sitten OK.

Jos käytät monitekijätodennusta, noudata ohjeita lisätodennustietojen, kuten tarkistuskoodin, antamiseksi.

Yhteyden muodostamisen jälkeen voit käyttää Azure Active Directory PowerShell for Graph -moduulin komentoja.

Yhteyden muodostaminen Microsoft Azure Active Directory Module for Windows PowerShell -moduulilla

PowerShell-versio 7:n ja uudempien versioiden komentokomennot eivät tue Microsoftto Active Directory Module for Windows PowerShell -moduulia ja komentokomennotietokoneita, joiden nimessä on Msol. PowerShell-versiossa 7 ja uudemmissa versioissa on käytettävä Azure Active Directory PowerShell for Graph -moduulia tai Azure PowerShelliä.

PowerShell Core ei tue Microsoft Azure Active Directory Module for Windows PowerShell -moduulia ja cmdletteja, joiden nimessä on Msol. Suorita nämä komentokomennot Windows PowerShellistä.

Vaihe 1: Asenna tarvittavat ohjelmistot

Nämä vaiheet tarvitaan vain kerran tietokoneeseen. Sinun on kuitenkin todennäköisesti päivitettävä ohjelmistoja säännöllisesti.

1. Jos käytössäsi ei ole Windows 10, asenna Microsoft Online Services Sign-in Assistant -ohjelman 64-bittinen versio: Microsoft Online Services Sign-in Assistant for IT Professionals RTW.

2. Asenna Microsoft Azure Active Directory Module for Windows PowerShell seuraavasti:

   1. Avaa kohotettu Windows PowerShell -komentokehote (suorita Windows PowerShell järjestelmänvalvojana).
   2. Aja Install-Module MSOnline-komento.
   3. Jos sinua pyydetään asentamaan NuGet-palveluntarjoaja, kirjoita Y ja paina Enteriä.
   4. Jos sinua pyydetään asentamaan moduuli PSGalleriasta, kirjoita Y ja paina Enteriä.

Vaihe 2: Yhteyden muodostaminen Microsoft 365 -tilauksen Azure AD:hen

Jos haluat muodostaa yhteyden Microsoft 365 -tilauksen Azure AD:hen tilinimellä ja salasanalla tai monitekijätodennuksella, suorita jokin seuraavista komennoista Windows PowerShell -komentokehotteesta. (Sen ei tarvitse olla korotettu.)

Kirjoita kirjaudu tilillesi -valintaikkunassa Microsoft 365 -työ- tai koulutilin käyttäjänimi ja salasana ja valitse sitten OK.

Jos käytät monitekijätodennusta, noudata ohjeita lisätodennustietojen, kuten tarkistuskoodin, antamiseksi.

Miten tiedät, että se toimi?

Jos et saa virheilmoitusta, yhteys muodostettiin onnistuneesti. Voit tehdä nopean testin suorittamalla Microsoft 365:n cmdletin, kuten Get-MsolUser, ja nähdä tulokset.

Jos saat virheilmoituksen, tarkista seuraavat ongelmat:

• Yleinen ongelma on väärä salasana. Suorita vaihe 2 uudelleen ja kiinnitä erityistä huomiota syöttämääsi käyttäjänimeen ja salasanaan.

• Microsoft Azure Active Directory Module for Windows PowerShell edellyttää, että tietokoneessa on käytössä Microsoft .NET Framework 3.5.x. On todennäköistä, että tietokoneellesi on asennettu uudempi versio (esimerkiksi 4 tai 4.5.x). Yhteensopivuus .NET Frameworkin vanhempien versioiden kanssa voidaan kuitenkin ottaa käyttöön tai poistaa käytöstä. Lisätietoja on seuraavissa artikkeleissa:

  • Windows Server 2012:n tai Windows Server 2012 R2:n osalta katso kohtaa .NET Framework 3.5:n ottaminen käyttöön ohjattua Lisää rooleja ja ominaisuuksia -ohjelmaa käyttämällä.

  • Windows 7:n tai Windows Server 2008 R2:n osalta katso kohtaa Et voi avata Azure Active Directory -moduulia Windows PowerShellille.

  • Windows 10:n, Windows 8.1:n ja Windows 8:n osalta katso Asenna .NET Framework 3.5 Windows 10:een, Windows 8.1:een ja Windows 8:aan.

• Versiosi Microsoft Azure Active Directory Module for Windows PowerShellistä saattaa olla vanhentunut. Voit tarkistaa sen suorittamalla seuraavan komennon PowerShell for Microsoft 365:ssä tai Microsoft Azure Active Directory Module for Windows PowerShellissä:

  (Get-Item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion

  Jos palautettu versionumero on pienempi kuin 1.0.8070.2, poista Microsoft Azure Active Directory Module for Windows PowerShell -moduulin asennus ja asenna se edellä olevasta vaiheesta 1 alkaen.

• Jos saat yhteysvirheilmoituksen, katso ”Connect-MsolService: Exception of type was thrown” -virheilmoitus.

• Jos saat ”Get-Item: Cannot find path” -virheilmoitus, suorita tämä komento:

   (dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name

Katso myös

• Microsoft 365:n hallinta PowerShellin avulla
• Aloita Microsoft 365:n PowerShellin käyttö
• Yhteyden muodostaminen kaikkiin Microsoft 365:n palveluihin yhdessä Windows PowerShell -ikkunassa

.