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 vaší Microsoft 365 organizaci.

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 PowerShellu pro Graph, jejichž rutiny zahrnují AzureAD do svého názvu
  • modul Microsoft Azure Active Directory pro Windows PowerShell, jehož rutiny zahrnují do názvu Msol

Modul Azure Active Directory PowerShell pro Graph v současné době zcela nenahrazuje funkce modulu Microsoft Azure Active Directory module pro Windows PowerShell 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 k 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. Sadu Microsoft Graph PowerShell SDK můžete použít pro přístup ke všem rozhraním Microsoft Graph API. Další informace najdete v tématu Začínáme pomocí sady 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 pro 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. PowerShell verze 7 se nedá použít.

Poznámka

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

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

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

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

Poznámka

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

Krok 1: Instalace požadovaného softwaru

Tento postup se vyžaduje jenom jednou v počítači. Budete ale pravděpodobně muset software pravidelně aktualizovat.

  1. Otevřete okno příkazového řádku Windows PowerShell se zvýšenými oprávněními (spusťte Windows PowerShell jako správce).

  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í Azure AD předplatného Microsoft 365

Pokud se chcete připojit k Azure Active Directory (Azure AD) pro předplatné Microsoft 365 s názvem účtu a heslem nebo s vícefaktorovým ověřováním, 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-AzureAD
Office 365 provozovaný společností 21 Vianet Connect-AzureAD -AzureEnvironmentName AzureChinaCloud
Office 365 Německo Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud
Office 365 státní správy USA a Office 365 státní správu USA GCC Vysoká Connect-AzureAD -AzureEnvironmentName AzureUSGovernment

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

Pokud používáte vícefaktorové ověřování, postupujte podle pokynů k poskytnutí dalších ověřovacích informací, jako je ověřovací kód.

Po připojení můžete použít rutiny pro modul Azure Active Directory PowerShell pro Graph.

Připojení s modulem Microsoft Azure Active Directory pro Windows PowerShell

Poznámka

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

PowerShell verze 7 a novější nepodporuje modul Microsoft Azure Active Directory pro modul Windows PowerShell a rutiny s názvem Msol. 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 názvem Msol. Spusťte tyto rutiny z Windows PowerShell.

Krok 1: Instalace požadovaného softwaru

Tento postup se vyžaduje jenom jednou v počítači. Budete ale pravděpodobně muset software pravidelně aktualizovat.

  1. Pokud nepoužíváte Windows 10, nainstalujte 32bitovou verzi Pomocníka pro přihlášení ke službám Microsoft Online Services: Pomocník pro přihlášení ke službám Microsoft Online Services pro ODBORNÍKY V OBLASTI IT.

  2. Pokud chcete nainstalovat modul Microsoft Azure Active Directory pro Windows PowerShell, postupujte takto:

    1. Otevřete příkazový řádek Windows PowerShell 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 poskytovatele 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í Azure AD předplatného Microsoft 365

Pokud se chcete připojit k Azure AD pro předplatné Microsoft 365 s názvem účtu a heslem nebo s vícefaktorovým ověřováním, 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-MsolService
Office 365 provozovaný společností 21 Vianet Connect-MsolService -AzureEnvironment AzureChinaCloud
Office 365 Německo Connect-MsolService -AzureEnvironment AzureGermanyCloud
Office 365 státní správy USA a Office 365 státní správu USA GCC Vysoká Connect-MsolService -AzureEnvironment USGovernment

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

Pokud používáte vícefaktorové ověřování, postupujte podle pokynů k poskytnutí dalších ověřovacích informací, jako je ověřovací kód.

Jak víte, že to fungovalo?

Pokud se vám nezobrazí chybová zpráva, úspěšně jste se připojili. 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:

  • Běžným problémem je nesprávné heslo. Znovu spusťte krok 2 a věnujte pozornost uživatelskému jménu a hesly, které zadáte.

  • Modul Microsoft Azure Active Directory pro Windows PowerShell vyžaduje, aby rozhraní Microsoft .NET Framework 3.5. x je na vašem počítači povoleno**. Je pravděpodobné, že váš počítač má nainstalovanou novější verzi (například 4 nebo 4.5).* x*). Ale zpětná kompatibilita se staršími verzemi rozhraní .NET Framework je 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 může být zastaralá. Pokud to chcete zkontrolovat, spusťte v PowerShellu pro Microsoft 365 nebo v modulu Microsoft Azure Active Directory pro Windows PowerShell následující příkaz:

    (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í, přečtěte si chybu Připojení-MsolService: Došlo k výjimce typu.

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

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

Připojení s azure Cloud Shell

Pokud se chcete připojit a používat Cloud Shell Azure z Centrum pro správu Microsoftu 365, 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 vázané na vaše předplatné 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é