Připojení k Microsoftu 365 pomocí PowerShellu

Tento článek se týká Microsoft 365 Enterprise i Office 365 Enterprise.

PowerShell pro Microsoft 365 umožňuje spravovat nastavení Microsoft 365 z příkazového řádku. Pokud se chcete připojit k PowerShellu, stačí nainstalovat požadovaný software a pak se připojit k organizaci Microsoft 365.

Existují dvě verze modulu PowerShellu, které můžete použít k připojení k Microsoft 365 a správě uživatelských účtů, skupin a licencí:

  • Azure Active Directory PowerShell pro Graph, jehož rutiny obsahují v názvu AzureAD
  • Microsoft Azure Active Directory Modul pro Windows PowerShell, jehož rutiny obsahují ve svém názvu Msol

Modul Azure Active Directory PowerShell for Graph v současné době úplně nenahrazuje funkce modulu Microsoft Azure Active Directory pro Windows PowerShell modul pro správu uživatelů, skupin a licencí. V některých případech je potřeba použít obě verze. Obě verze můžete bezpečně nainstalovat na stejný počítač.

Poznámka

Můžete se také připojit pomocí Cloud Shell Azure z Centrum pro správu Microsoftu 365.

Co potřebujete vědět, než začnete?

Poznámka

Modul Azure Active Directory nahrazuje sada Microsoft Graph PowerShell SDK. Pro přístup ke všem rozhraním Microsoft Graph API můžete použít sadu Microsoft Graph PowerShell SDK. Další informace najdete v tématu Začínáme se sadou Microsoft Graph PowerShell SDK.

Operační systém

Musíte použít 64bitovou verzi Windows. Podpora 32bitové verze modulu Microsoft Azure Active Directory pro Windows PowerShell skončila v roce 2014.

Můžete použít následující verze 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 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.

  • Pro modul Microsoft Azure Active Directory pro Windows PowerShell musíte použít PowerShell verze 5.1 nebo novější až do PowerShellu verze 6. Nemůžete použít PowerShell verze 7.

Poznámka

Tyto postupy jsou určené pro uživatele, kteří jsou členy role správce Microsoft 365. Další informace najdete v článku Role správců.

Připojení pomocí modulu Azure Active Directory PowerShell for Graph

Příkazy v modulu Azure Active Directory PowerShell pro Graph mají v názvu rutiny AzureAD . Můžete nainstalovat modul Azure Active Directory PowerShell for Graph nebo Azure PowerShell.

V případě postupů, které vyžadují nové rutiny v modulu Azure Active Directory PowerShell pro Graph, postupujte podle těchto kroků a nainstalujte modul a připojte se k předplatnému Microsoft 365.

Poznámka

Informace o podpoře různých verzí Windows najdete v tématu Modul Azure Active Directory PowerShell pro Graph .

Krok 1: Instalace požadovaného softwaru

Tento postup se vyžaduje jenom jednou na počítači. Pravděpodobně ale budete muset software pravidelně aktualizovat.

  1. Otevřete okno Windows PowerShell příkazového řádku.

  2. Spusťte tento příkaz:

    Install-Module -Name AzureAD
    

Ve výchozím nastavení není Galerie prostředí PowerShell (PSGallery) nakonfigurované jako důvěryhodné úložiště pro PowerShellGet. Při prvním použití PSGallery se zobrazí následující zpráva:

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"):

Pokud chcete pokračovat v instalaci, odpovězte Ano nebo Ano všem.

  1. Spuštěním tohoto příkazu naimportujte modul:

    Import-Module  AzureAD
    

Krok 2: Připojení k Azure AD pro vaše předplatné Microsoft 365

Pokud se chcete připojit k Azure Active Directory (Azure AD) pro předplatné Microsoft 365 pomocí názvu účtu a hesla nebo pomocí vícefaktorového ověřování, spusťte jeden z těchto příkazů z Windows PowerShell příkazového řádku. (Nemusí být zvýšená.)

Office 365 cloud Příkaz
Office 365 Worldwide (+GCC) Connect-AzureAD
Office 365 provozovaný společností 21 Vianet Connect-AzureAD -AzureEnvironmentName AzureChinaCloud
Office 365 Německo Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud
Office 365 U.S. Government DoD a Office 365 U.S. Government GCC High Connect-AzureAD -AzureEnvironmentName AzureUSGovernment

V dialogovém okně Přihlásit se k účtu zadejte uživatelské jméno a heslo k pracovnímu nebo školnímu účtu Microsoft 365 a pak vyberte OK.

Pokud používáte vícefaktorové ověřování, postupujte podle pokynů a zadejte 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 Windows PowerShell

Poznámka

Rutiny v modulu Microsoft Azure Active Directory pro Windows PowerShell mají v názvu Msol.

PowerShell verze 7 a novější nepodporuje modul Microsoft Azure Active Directory pro modul Windows PowerShell a rutiny s Msol v názvu. Pro PowerShell verze 7 a novější musíte použít sadu Microsoft Graph PowerShell SDK.

PowerShell Core nepodporuje modul Microsoft Azure Active Directory pro modul Windows PowerShell a rutiny s Msol v názvu. Spusťte tyto rutiny z Windows PowerShell.

Krok 1: Instalace požadovaného softwaru

Tento postup se vyžaduje jenom jednou na počítači. Pravděpodobně ale budete muset software pravidelně aktualizovat.

  1. Pokud nepoužíváte Windows 10, nainstalujte si 32bitovou verzi Pomocníka pro přihlášení k Microsoft Online Services: Microsoft Online Services Sign-in Assistant for IT Professionals RTW.

  2. Pokud chcete nainstalovat modul Microsoft Azure Active Directory pro Windows PowerShell, postupujte následovně:

    1. Otevřete Windows PowerShell příkazovém řádku se zvýšenými oprávněními (spusťte Windows PowerShell jako správce).
    2. Spusťte příkaz Install-Module MSOnline .
    3. Pokud se zobrazí výzva k instalaci zprostředkovatele NuGet, zadejte Y a stiskněte Enter.
    4. Pokud se zobrazí výzva k instalaci modulu z PSGallery, zadejte Y a stiskněte Enter.

Krok 2: Připojení k Azure AD pro vaše předplatné Microsoft 365

Pokud se chcete připojit k Azure AD předplatného Microsoft 365 pomocí názvu účtu a hesla nebo pomocí vícefaktorového ověřování, spusťte jeden z těchto příkazů z příkazového řádku Windows PowerShell. (Nemusí být zvýšená.)

Office 365 cloud Příkaz
Office 365 Worldwide (+GCC) Connect-MsolService
Office 365 provozovaný společností 21 Vianet Connect-MsolService -AzureEnvironment AzureChinaCloud
Office 365 Německo Connect-MsolService -AzureEnvironment AzureGermanyCloud
Office 365 U.S. Government DoD a Office 365 U.S. Government GCC High Connect-MsolService -AzureEnvironment USGovernment

V dialogovém okně Přihlásit se k účtu zadejte uživatelské jméno a heslo k pracovnímu nebo školnímu účtu Microsoft 365 a pak vyberte OK.

Pokud používáte vícefaktorové ověřování, postupujte podle pokynů a zadejte další ověřovací informace, například ověřovací kód.

Jak víte, že to fungovalo?

Pokud se nezobrazí chybová zpráva, úspěšně jste se připojili. Pro účely rychlého testu 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:

  • Běžným problémem je nesprávné heslo. Spusťte znovu krok 2 a věnujte velkou pozornost zadanému uživatelskému jménu a heslu.

  • Modul Microsoft Azure Active Directory pro Windows PowerShell vyžaduje, aby Microsoft rozhraní .NET Framework 3.5. x je na vašem počítači povolená. Je pravděpodobné, že v počítači je nainstalovaná novější verze (například 4 nebo 4.5). x). Zpětnou kompatibilitu se staršími verzemi rozhraní .NET Framework je však možné povolit nebo zakázat. Další informace najdete v následujících článcích:

  • Vaše verze modulu Microsoft Azure Active Directory pro Windows PowerShell možná není aktuální. Pokud to chcete zkontrolovat, spusťte v PowerShellu následující příkaz pro Microsoft 365 nebo modul Microsoft Azure Active Directory pro 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 pro Windows PowerShell a nainstalujte ho z kroku 1 výše.

  • Pokud se zobrazí chybová zpráva připojení, podívejte se na chybu Connect-MsolService: Došlo k výjimce typu.

  • Pokud se zobrazí chybová zpráva Get-Item: Nelze najít cestu, spusťte tento příkaz:

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

Připojení pomocí azure Cloud Shell

Pokud se chcete připojit pomocí azure Cloud Shell z Centrum pro správu Microsoftu 365 a používat ho, vyberte ikonu okna PowerShellu v pravém horním rohu hlavního panelu. V podokně Vítá vás Azure Cloud Shell vyberte PowerShell.

Pro vaši organizaci budete potřebovat aktivní předplatné Azure, které je svázané s předplatným Microsoft 365. Pokud ho ještě nemáte, můžete si ho vytvořit. Jakmile máte předplatné Azure, otevře se okno PowerShellu, ze kterého můžete spouštět příkazy a skripty PowerShellu.

Další informace najdete v tématu Azure Cloud Shell.

Viz také