Подключение к Office 365 PowerShellConnect to Office 365 PowerShell

Сводка. Подключитесь к своей организации Office 365, используя PowerShell, чтобы выполнять задачи администрирования из командной строки.Summary: Connect to your Office 365 organization using Office 365 PowerShell to perform Office 365 administration tasks from the command line.

PowerShell в Office 365 позволяет управлять параметрами Office 365 из командной строки.Office 365 PowerShell lets you to manage your Office 365 admin center settings from the command line. Подключение к PowerShell в Office 365 — это простой процесс установки необходимого программного обеспечения и последующего подключения к организации Office 365.Connecting to Office 365 PowerShell is a simple three-step process where you install the required software, run the required software, and then connect to your Office 365 organization.

Существует две версии модуля PowerShell, которые используются для подключения к Office 365 и управления учетными записями пользователей, группами и лицензиями:There are two versions of the PowerShell module that you use to connect to Office 365 and administer user accounts, groups, and licenses:

  • Azure Active Directory PowerShell для Graph (командлеты содержат AzureAD в своем имени)Azure Active Directory PowerShell for Graph (cmdlets include AzureAD in their name)
  • Модуль Microsoft Azure Active Directory для Windows PowerShell (командлеты содержат MSol в своем имени)Microsoft Azure Active Directory Module for Windows PowerShell (cmdlets include MSol in their name)

На момент выхода этой статьи модуль Azure Active Directory PowerShell для Graph не полностью заменяет функции командлетов модуля Microsoft Azure Active Directory для Windows PowerShell при администрировании пользователей, групп и лицензий.As of the date of this article, the Azure Active Directory PowerShell for Graph module does not completely replace the functionality in the cmdlets of Microsoft Azure Active Directory Module for Windows PowerShell module for user, group, and license administration. Во многих случаях необходимо использовать обе версии.In many cases, you need to use both versions. Вы можете безопасно установить обе версии на одном компьютере.You can safely install both versions on the same computer.

Совет

**Никогда не работали с PowerShell?** Посмотрите этот видеообзор на сайте LinkedIn Learning.New to PowerShell? See a video Overview of PowerShell, brought to you by LinkedIn Learning.

Что нужно знать перед началом работы?What do you need to know before you begin?

  • Предполагаемое время для завершения: 5 минут.Estimated time to complete: 5 minutes

  • Ниже приведены версии Windows, которые можно использовать.You can use the following versions of Windows:

    • Windows 10, Windows 8.1, Windows 8 или Windows 7 с пакетом обновления 1 (SP1)Windows 10, Windows 8.1, Windows 8 or Windows 7 Service Pack 1 (SP1)

    • Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012 или Windows Server 2008 R2 SP1Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, or Windows Server 2008 R2 SP1

      Примечание

      Используйте 64-разрядную версию Windows. Поддержка 32-разрядной версии модуля Microsoft Azure Active Directory для Windows PowerShell прекращена в октябре 2014 г.Use a 64-bit version of Windows. Support for the 32-bit version the Microsoft Azure Active Directory Module for Windows PowerShell was discontinued in October of 2014.

  • Эти процедуры предназначены для пользователей, являющихся участниками роли администратора Office 365.These procedures are intended for users who are members of an Office 365 admin role. Дополнительные сведения см. в статье Роли администраторов в Office 365.For more information, see About Office 365 admin roles.

Подключение к модулю Azure Active Directory PowerShell для GraphNext, you Connect with the Azure Active Directory PowerShell for Graph module .

Имена командлетов в модуле Azure Active Directory PowerShell для Graph включают компонент AzureAD.Commands in the Azure Active Directory V2 PowerShell module have "AzureAD" in their cmdlet name.

Чтобы выполнить действия, требующие использования новых командлетов в модуле Azure Active Directory PowerShell для Graph, установите его и подключитесь к подписке на Office 365. Вот как это сделать:For procedures that require the new cmdlets in the Azure Active Directory V2 PowerShell module, use these steps to install the module and connect to your Office 365 subscription.

Примечание

Информацию о поддержке в различных версиях Microsoft Windows см. в этой статье.See Azure Active Directory PowerShell for Graph module for information about the support for different versions of Microsoft Windows.

Шаг 1. Установите необходимое программное обеспечениеStep 1: Install required software

Указанные ниже действия необходимо выполнить на вашем компьютере только один раз (а не при каждом подключении). Тем не менее вам, скорее всего, придется периодически устанавливать более новые версии программного обеспечения.These steps are required once on your computer, not every time you connect. However, you'll likely need to install newer versions of the software periodically.

  1. Откройте командную строку Windows PowerShell с повышенными привилегиями (запустите Windows PowerShell от имени администратора).Open an elevated Windows PowerShell command prompt (run Windows PowerShell as an administrator).

  2. В командном окне Администратор: Windows PowerShell выполните следующую команду:In the Administrator: Windows PowerShell command window, run this command:

Install-Module -Name AzureAD

Если появится предупреждение об установке модуля из ненадежного репозитория, введите Y и нажмите клавишу ВВОД.If prompted about installing a module from an untrusted repository, type Y and press ENTER.

Шаг 2. Подключитесь к Azure AD для своей подписки Office 365Step 2: Connect to your Office 365 subscription

Чтобы подключиться к Azure AD для своей подписки на Office 365 с помощью имени учетной записи и пароля или с помощью многофакторной проверкой подлинности (MFA), запустите одну из этих команд в командной строке Windows PowerShell (повышенные привилегии не требуются).To connect to Azure AD for your Office 365 subscription with an account name and password or with multi-factor authentication (MFA), run one of these commands from a Windows PowerShell command prompt (it does not have to be elevated).

Облачная служба Office 365Office 365 cloud КомандаCommand
Office 365 Worldwide (+GCC)Office 365 Worldwide (+GCC) Connect-AzureAD
Office 365, предоставляемый 21 VianetOffice 365 operated by 21 Vianet Connect-AzureAD -AzureEnvironmentName AzureChinaCloud
Office 365 GermanyOffice 365 Germany Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud
Office 365 для DoD государственных организаций США и Office 365 для GCC High государственных организаций СШАOffice 365 U.S. Government DoD and Office 365 U.S. Government GCC High Connect-AzureAD -AzureEnvironmentName AzureUSGovernment

В диалоговом окне Вход в учетную запись введите имя пользователя и пароль своей рабочей или учебной учетной записи Office 365 и нажмите кнопку ОК.In the Windows PowerShell Credential Request dialog box, type your Office 365 work or school account user name and password, and then click OK.

Если вы используете многофакторную проверку подлинности, следуйте инструкциям в дополнительных диалоговых окнах, чтобы предоставить дополнительные сведения для проверки подлинности, например код проверки.If you are using MFA, follow the instructions in the additional dialog boxes to provide more authentication information, such as a verification code.

После подключения можно использовать новые командлеты для модуля Azure Active Directory PowerShell для Graph.After connecting, you can use the new cmdlets for the Azure Active Directory V2 PowerShell module.

Подключение к модулю Microsoft Azure Active Directory для Windows PowerShellConnect with the Microsoft Azure Active Directory Module for Windows PowerShell

Имена командлетов в модуле Microsoft Azure Active Directory для Windows PowerShell включают компонент Msol.Commands in the Microsoft Azure Active Directory Module for Windows PowerShell have Msol in their cmdlet name.

Шаг 1. Установите необходимое программное обеспечениеStep 1: Install required software

Указанные ниже действия необходимо выполнить на вашем компьютере только один раз (а не при каждом подключении). Тем не менее вам, скорее всего, придется периодически устанавливать более новые версии программного обеспечения.These steps are required once on your computer, not every time you connect. However, you'll likely need to install newer versions of the software periodically.

  1. Установите 64-разрядную версию помощника по входу в Microsoft Online Services. См. статью Помощник по входу в Microsoft Online Services для ИТ-специалистов, RTW.Install the 64-bit version of the Microsoft Online Services Sign-in Assistant: Microsoft Online Services Sign-in Assistant for IT Professionals RTW.

  2. Чтобы установить модуль Microsoft Azure Active Directory для Windows PowerShell, сделайте следующее:Install the Microsoft Azure Active Directory Module for Windows PowerShell with these steps:

  • Откройте командную строку Windows PowerShell с повышенными привилегиями (запустите Windows PowerShell от имени администратора).Open an elevated Windows PowerShell command prompt (run Windows PowerShell as an administrator).
  • Выполните команду Install-Module MSOnline.Run the Install-Module MSOnline command.
  • Если отобразится запрос на установку поставщика NuGet, введите Y и нажмите клавишу ВВОД.If prompted to install the NuGet provider, type Y and press ENTER.
  • Если отобразится запрос на установку модуля из репозитория PSGallery, введите Y и нажмите клавишу ВВОД.If prompted to install the module from PSGallery, type Y and press ENTER.

Шаг 2. Подключитесь к Azure AD для своей подписки Office 365Step 2: Connect to your Office 365 subscription

Чтобы подключиться к Azure AD для своей подписки на Office 365 с помощью имени учетной записи и пароля или с помощью многофакторной проверкой подлинности (MFA), запустите одну из этих команд в командной строке Windows PowerShell (повышенные привилегии не требуются).To connect to Azure AD for your Office 365 subscription with an account name and password or with multi-factor authentication (MFA), run one of these commands from a Windows PowerShell command prompt (it does not have to be elevated).

Облачная служба Office 365Office 365 cloud КомандаCommand
Office 365 Worldwide (+GCC)Office 365 Worldwide (+GCC) Connect-MsolService
Office 365, предоставляемый 21 VianetOffice 365 operated by 21 Vianet Connect-MsolService -AzureEnvironment AzureChinaCloud
Office 365 GermanyOffice 365 Germany Connect-MsolService -AzureEnvironment AzureGermanyCloud
Office 365 для DoD государственных организаций США и Office 365 для GCC High государственных организаций СШАOffice 365 U.S. Government DoD and Office 365 U.S. Government GCC High Connect-MsolService -AzureEnvironment USGovernment

В диалоговом окне Вход в учетную запись введите имя пользователя и пароль своей рабочей или учебной учетной записи Office 365 и нажмите кнопку ОК.In the Windows PowerShell Credential Request dialog box, type your Office 365 work or school account user name and password, and then click OK.

Если вы используете многофакторную проверку подлинности, следуйте инструкциям в дополнительных диалоговых окнах, чтобы предоставить дополнительные сведения для проверки подлинности, например код проверки.If you are using MFA, follow the instructions in the additional dialog boxes to provide more authentication information, such as a verification code.

Как проверить, все ли получилось?How do you know this worked?

Если не возникло никаких ошибок, значит, подключение выполнено успешно. Чтобы выполнить быструю проверку, запустите командлет Office 365:, например Get-MsolUser, и просмотрите результаты.If you don't receive any errors, you connected successfully. A quick test is to run an Office 365 cmdlet—for example, Get-MsolUser —and see the results.

Если возникают ошибки, просмотрите список возможных причин ниже.If you receive errors, check the following requirements:

  • Распространенная проблема — неправильный пароль..A common problem is an incorrect password. Еще раз выполните шаг 2,Run Step 3 again. внимательно проверив вводимое имя пользователя и пароль.and pay close attention to the user name and password you enter.

  • Для работы модуля Microsoft Azure Active Directory для Windows PowerShell необходимо, чтобы на вашем компьютере был включен компонент Microsoft .NET Framework 3.5. x. Скорее всего, на вашем компьютере установлена более новая версия этого компонента (например, 4 или 4.5.* x*), но вы можете включить или отключить режим обратной совместимости с более ранними версиями платформы .NET Framework.The Microsoft Azure Active Directory Module for Windows PowerShell requires that the Microsoft .NET Framework 3.5. x feature is enabled on your computer. It's likely that your computer has a newer version installed (for example, 4 or 4.5. x), but backwards compatibility with older versions of the .NET Framework can be enabled or disabled. For more information, see the following topics: Дополнительную информацию см. в следующих статьях:For more information, see the following topics:

    Установка платформы .NET Framework 3.5 на Windows 10, Windows 8.1 и Windows 8 (Windows 10, Windows 8.1 и Windows 8)For Windows 10, Windows 8.1, and Windows 8, see Install the .NET Framework 3.5 on Windows 10, Windows 8.1, and Windows 8

  • Возможно, используемая вами версия Модуль Microsoft Azure Active Directory для Windows PowerShell устарела. Чтобы проверить актуальность версии, выполните указанную ниже команду в PowerShell в Office 365 или в Модуль Microsoft Azure Active Directory для Windows PowerShell.Your version of the Microsoft Azure Active Directory Module for Windows PowerShell might be out of date. To check, run the following command in Office 365 PowerShell or the 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
    

    Если возвращенный номер версии будет меньше 1.0.8070.2, удалите Модуль Microsoft Azure Active Directory для Windows PowerShell и установите последнюю версию, скачав ее по ссылке, указанной на шаге 1.If the version number returned is lower than the value 1.0.8070.2, uninstall the Microsoft Azure Active Directory Module for Windows PowerShell and install the latest version from the link in Step 1.

  • **Если при подключении возникнет ошибка, ознакомьтесь с **этой статьей.If you receive a connection error, see this topic: "Connect-MsolService: Exception of type was thrown" error.

См. такжеSee also