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

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

Office 365 PowerShell позволяет Управление параметрами Office 365 с помощью командной строки. Подключение к Office 365 PowerShell — простой процесс, где Установка необходимого программного обеспечения, а затем подключиться к своей организации Office 365.Office 365 PowerShell lets you to manage your Office 365 settings from the command line. Connecting to Office 365 PowerShell is a simple process where you install 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 для диаграммы (включая командлеты 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 для модуля график не полностью заменяет функциональные возможности в командлетах модуля 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 с пакетом обновления 1Windows Server 2019, Windows 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. Дополнительные сведения см в роли администраторов об Office 365.These procedures are intended for users who are members of an Office 365 admin role. For more information, see About Office 365 admin roles.

Связь с Azure Active Directory PowerShell для модуля "график"Connect with the Azure Active Directory PowerShell for Graph module

Команды в модуле Windows Azure Active Directory PowerShell для диаграммы имеют AzureAD в имени командлета.Commands in the Azure Active Directory PowerShell for Graph module have AzureAD in their cmdlet name.

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

Примечание

Windows Azure Active Directory PowerShell для модуля "график" в разделе сведения о поддержке для разных версий 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 Azure AD for your Office 365 subscription

Для подключения к Azure AD для подписки Office 365 с имя учетной записи и пароль или многофакторная проверка подлинности (многофакторной проверкой Подлинности), выполните одну из следующих команд в командной строке 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 по всему миру (+ GCC)Office 365 Worldwide (+GCC) Connect-AzureAD
Office 365, которой с 21 VianetOffice 365 operated by 21 Vianet Connect-AzureAD -AzureEnvironmentName AzureChinaCloud
Office 365 в ГерманииOffice 365 Germany Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud
Обороны США государственных Office 365 и Office 365 США государственных GCC высокойOffice 365 U.S. Government DoD and Office 365 U.S. Government GCC High Connect-AzureAD -AzureEnvironmentName AzureUSGovernment

В диалоговом окне входа в учетную запись введите работы Office 365 или школа имя учетной записи и пароль и нажмите кнопку ОК.In the Sign into your account 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.

После подключения, можно использовать новые командлеты для Windows Azure Active Directory PowerShell для модуля "график".After connecting, you can use the new cmdlets for the Azure Active Directory PowerShell for Graph 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 Azure AD for your Office 365 subscription

Для подключения к Azure AD для подписки Office 365 с имя учетной записи и пароль или многофакторная проверка подлинности (многофакторной проверкой Подлинности), выполните одну из следующих команд в командной строке 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 по всему миру (+ GCC)Office 365 Worldwide (+GCC) Connect-MsolService
Office 365, которой с 21 VianetOffice 365 operated by 21 Vianet Connect-MsolService -AzureEnvironmentName AzureChinaCloud
Office 365 в ГерманииOffice 365 Germany Connect-MsolService -AzureEnvironmentName AzureGermanyCloud
Обороны США государственных Office 365 и Office 365 США государственных GCC высокойOffice 365 U.S. Government DoD and Office 365 U.S. Government GCC High Connect-MsolService -AzureEnvironmentName USGovernment

В диалоговом окне входа в учетную запись введите работы Office 365 или школа имя учетной записи и пароль и нажмите кнопку ОК.In the Sign into your account 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:

  • Распространенные проблемы имеет неверный пароль. Повторите шаг 2. и обратите внимание на имя пользователя и пароль, введенные.A common problem is an incorrect password. Run Step 2 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:

  • Возможно, используемая вами версия Модуль 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