Připojení ke službě Microsoft 365 pomocí prostředí PowerShell
On 22 října, 2021 by admin- 07/17/2020
- 6 minut ke čtení
-
- J
- D
- m
- d
Tento článek platí pro Microsoft 365 Enterprise i Office 365 Enterprise.
PowerShell pro Microsoft 365 umožňuje spravovat nastavení Microsoft 365 z příkazového řádku. Chcete-li se připojit k prostředí PowerShell, stačí nainstalovat potřebný software a poté se připojit k organizaci Microsoft 365.
Existují dvě verze modulu PowerShell, které můžete použít k připojení ke službě Microsoft 365 a ke správě uživatelských účtů, skupin a licencí:
- Modul Azure Active Directory PowerShell for Graph, jehož rutiny obsahují v názvu AzureAD
- Modul Microsoft Azure Active Directory pro prostředí Windows PowerShell, jehož rutiny obsahují v názvu Msol
Modul Azure Active Directory PowerShell for Graph v současné době zcela nenahrazuje funkce modulu Microsoft Azure Active Directory Module for Windows PowerShell pro správu uživatelů, skupin a licencí. V některých případech je třeba použít obě verze. Obě verze můžete bezpečně nainstalovat do stejného počítače.
Co potřebujete vědět, než začnete?
Operační systém
Musíte používat 64bitovou verzi systému Windows. Podpora 32bitové verze modulu Microsoft Azure Active Directory pro prostředí Windows PowerShell skončila v roce 2014.
Můžete používat následující verze systému Windows:
-
Windows 10, Windows 8.1, Windows 8 nebo Windows 7 Service Pack 1 (SP1)
-
Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012 nebo Windows Server 2008 R2 SP1
Poznámka
Pro Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012 a Windows Server 2008 R2 SP1 si stáhněte a nainstalujte Windows Management Framework 5.1.
PowerShell
-
Pro modul Azure Active Directory PowerShell for Graph musíte použít PowerShell verze 5.1 nebo novější.
-
Pro modul Microsoft Azure Active Directory Module for Windows PowerShell musíte používat prostředí PowerShell verze 5.1 nebo novější, až po PowerShell verze 6. Nelze použít prostředí PowerShell verze 7.
Poznámka
Tyto postupy jsou určeny pro uživatele, kteří jsou členy role správce Microsoft 365. Další informace naleznete v části O rolích správce.
Připojení s modulem Azure Active Directory PowerShell for Graph
Příkazy v modulu Azure Active Directory PowerShell for Graph mají v názvu rutiny AzureAD. Můžete nainstalovat modul Azure Active Directory PowerShell for Graph nebo Azure PowerShell.
Pro postupy, které vyžadují nové rutiny v modulu Azure Active Directory PowerShell for Graph, postupujte podle následujících kroků a nainstalujte modul a připojte se k předplatnému Microsoft 365.
Poznámka
Informace o podpoře různých verzí systému Windows naleznete v části Azure Active Directory PowerShell for Graph module .
Krok 1: Instalace požadovaného softwaru
Tyto kroky jsou v počítači nutné pouze jednou. Pravděpodobně však budete muset software pravidelně aktualizovat.
-
Otevřete zvýšené okno příkazového řádku prostředí Windows PowerShell (spusťte prostředí Windows PowerShell jako správce).
-
Spusťte tento příkaz:
Install-Module -Name AzureAD
Pokud budete vyzváni k instalaci modulu z nedůvěryhodného úložiště, zadejte Y a stiskněte Enter.
Krok 2: Připojení k Azure AD pro vaše předplatné Microsoft 365
Chcete-li se připojit k Azure Active Directory (Azure AD) pro vaše předplatné Microsoft 365 pomocí jména účtu a hesla nebo pomocí vícefaktorového ověřování, spusťte jeden z těchto příkazů z příkazového řádku prostředí Windows PowerShell. (Nemusí být zvýšený.)
Office 365 cloud | Příkaz |
---|---|
Office 365 Worldwide (+GCC) | Connect-AzureAD |
Office 365 provozuje 21 Vianet | Connect-AzureAD -AzureEnvironmentName AzureChinaCloud |
Office 365 Německo | Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud |
Office 365 U.US Government DoD a Office 365 U.S. Government GCC High | Connect-AzureAD -AzureEnvironmentName AzureUSGovernment |
V dialogovém okně Přihlášení k účtu zadejte své uživatelské jméno a heslo k pracovnímu nebo školnímu účtu Microsoft 365 a vyberte OK.
Pokud používáte vícefaktorové ověřování, zadejte podle pokynů další ověřovací informace, například ověřovací kód.
Po připojení můžete použít rutiny pro modul Azure Active Directory PowerShell for Graph.
Připojení pomocí modulu Microsoft Azure Active Directory pro prostředí Windows PowerShell
Poznámka
Kmdlety modulu Microsoft Azure Active Directory pro prostředí Windows PowerShell mají v názvu Msol.
PowerShell verze 7 a novější nepodporují modul Microsoft Azure Active Directory pro prostředí Windows PowerShell a kmdlety s Msol v názvu. Pro prostředí PowerShell verze 7 a novější je nutné použít modul Azure Active Directory PowerShell for Graph nebo Azure PowerShell.
PowerShell Core nepodporuje modul Microsoft Azure Active Directory Module for Windows PowerShell a rutiny s Msol v názvu. Spusťte tyto rutiny z prostředí Windows PowerShell.
Krok 1: Nainstalujte požadovaný software
Tyto kroky je nutné provést v počítači pouze jednou. Pravděpodobně však budete muset software pravidelně aktualizovat.
-
Pokud nepoužíváte systém Windows 10, nainstalujte 64bitovou verzi nástroje Microsoft Online Services Sign-in Assistant: Microsoft Online Services Sign-in Assistant for IT Professionals RTW.
-
Podle následujících kroků nainstalujte modul Microsoft Azure Active Directory pro prostředí Windows PowerShell:
- Otevřete zvýšený příkazový řádek prostředí Windows PowerShell (spusťte prostředí Windows PowerShell jako správce).
- Spusťte příkaz Install-Module MSOnline.
- Jestliže budete vyzváni k instalaci poskytovatele NuGet, zadejte Y a stiskněte Enter.
- Jestliže budete vyzváni k instalaci modulu z PSGallery, zadejte Y a stiskněte Enter.
Krok 2: Připojení k Azure AD pro předplatné Microsoft 365
Pro připojení k Azure AD pro předplatné Microsoft 365 pomocí jména účtu a hesla nebo pomocí vícefaktorového ověřování spusťte z příkazového řádku prostředí Windows PowerShell jeden z těchto příkazů. (Nemusí být zvýšený.)
Office 365 cloud | Příkaz |
---|---|
Office 365 Worldwide (+GCC) | Connect-MsolService |
Office 365 provozuje 21 Vianet | Connect-MsolService -AzureEnvironment AzureChinaCloud |
Office 365 Německo | Connect-MsolService -AzureEnvironment AzureGermanyCloud |
Office 365 U.Vláda USA DoD a Office 365 U.S. Government GCC High | Connect-MsolService -AzureEnvironment USGovernment |
V dialogovém okně Přihlášení k účtu zadejte své uživatelské jméno a heslo k pracovnímu nebo školnímu účtu Microsoft 365 a vyberte OK.
Pokud používáte vícefaktorové ověřování, zadejte podle pokynů další ověřovací informace, například ověřovací kód.
Jak poznáte, že to fungovalo?“
Pokud se nezobrazí chybová zpráva, připojení proběhlo úspěšně. Pro rychlý test spusťte rutinu Microsoft 365, například Get-MsolUser, a podívejte se na výsledky.
Pokud se zobrazí chybová zpráva, zkontrolujte následující problémy:
-
Častým problémem je nesprávné heslo. Znovu spusťte krok 2 a věnujte zvýšenou pozornost zadávanému uživatelskému jménu a heslu.
-
Modul Microsoft Azure Active Directory pro prostředí Windows PowerShell vyžaduje, aby byl v počítači povolen Microsoft .NET Framework 3.5.x.
-
. Je pravděpodobné, že ve vašem počítači je nainstalována novější verze (například 4 nebo 4.5.x). Zpětnou kompatibilitu se staršími verzemi prostředí .NET Framework však lze povolit nebo zakázat. Další informace naleznete v následujících článcích:
-
Pro Windows Server 2012 nebo Windows Server 2012 R2 viz Povolení rozhraní .NET Framework 3.5 pomocí Průvodce přidáním rolí a funkcí.
-
Pro Windows 7 nebo Windows Server 2008 R2 viz Nelze otevřít modul Azure Active Directory pro prostředí Windows PowerShell.
-
Pro Windows 10, Windows 8.1 a Windows 8 viz Instalace .NET Framework 3.5 v systémech Windows 10, Windows 8.1 a Windows 8.
-
-
Vaše verze modulu Microsoft Azure Active Directory Module for Windows PowerShell může být zastaralá. Chcete-li to zkontrolovat, spusťte následující příkaz v prostředí PowerShell pro Microsoft 365 nebo v modulu Microsoft Azure Active Directory Module for Windows PowerShell:
(Get-Item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion
Pokud je vrácené číslo verze nižší než 1.0.8070.2, odinstalujte modul Microsoft Azure Active Directory Module for Windows PowerShell a nainstalujte jej od kroku 1 výše.
-
Pokud se zobrazí chybová zpráva o připojení, viz „Connect-MsolService:
-
Pokud se zobrazí zpráva „Get-Item: Nelze najít cestu“, spusťte tento příkaz:
(dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name
Viz také
- Správa služby Microsoft 365 pomocí prostředí PowerShell
- Začněte s prostředím PowerShell pro Microsoft 365
- Připojení ke všem službám Microsoft 365 v jediném okně prostředí Windows PowerShell
.
Napsat komentář