Подключение к Exchange Online PowerShellConnect to Exchange Online PowerShell

Exchange Online PowerShell позволяет управлять настройками Exchange Online из командной строки.Exchange Online PowerShell allows you to manage your Exchange Online settings from the command line. С помощью Windows PowerShell на локальном компьютере можно создать удаленный сеанс PowerShell с Exchange Online.You use Windows PowerShell on your local computer to create a remote PowerShell session to Exchange Online. Эта простая трехэтапная процедура предусматривает ввод учетных данных Office 365, настройку необходимых параметров подключения, а также импорт командлетов Exchange Online в локальный сеанс Windows PowerShell для дальнейшего использования.It's a simple three-step process where you enter your Office 365 credentials, provide the required connection settings, and then import the Exchange Online cmdlets into your local Windows PowerShell session so that you can use them.

Important

Если для подключения к Exchange Online PowerShell требуется многофакторная проверка подлинности (MFA), необходимо скачать и использовать удаленный модуль PowerShell для Exchange Online.If you want to use multi-factor authentication (MFA) to connect to Exchange Online PowerShell, you need to download and use the Exchange Online Remote PowerShell Module. Дополнительные сведения см. в статье Подключение к Exchange Online PowerShell с помощью многофакторной проверки подлинности.For more information, see Connect to Exchange Online PowerShell using multi-factor authentication.

Если вы клиент автономной службы Exchange Online Protection (EOP) (например, вы используете EOP для защиты локальной почтовой среды), придерживайтесь инструкций по подключению из статьи Подключение к PowerShell для Exchange Online Protection.If you're an Exchange Online Protection (EOP) standalone customer, and you're using the service to protect on-premises mailboxes, use the connection instructions in the topic Connect to Exchange Online Protection PowerShell. Если ваша подписка на автономную службу EOP — это корпоративная клиентская лицензия Exchange со службами (включает защиту от потери данных (DLP) и создание отчетов с помощью веб-служб), вам помогут инструкции по подключению, приведенные в этой статье.If your EOP subscription is Exchange Enterprise CAL with Services (includes data loss prevention (DLP) and reporting using web services), the connection instructions in this topic will work for you.

Что нужно знать перед началом работы?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 PowerShell. По умолчанию это приложение не настроено. При попытке подключения появится указанная ниже ошибка.Windows PowerShell needs to be configured to run scripts, and by default, it isn't. You'll get the following error when you try to connect:

    Files cannot be loaded because running scripts is disabled on this system. Provide a valid certificate with which to sign the files.

    Чтобы требовать подпись надежного издателя для всех сценариев PowerShell, загружаемых из Интернета, выполните следующую команду в окне Windows PowerShell с повышенными привилегиями (окно Windows PowerShell, которое открывается с помощью параметра Запуск от имени администратора).To require all PowerShell scripts that you download from the internet are signed by a trusted publisher, run the following command in an elevated Windows PowerShell window (a Windows PowerShell window you open by selecting Run as administrator):

    Set-ExecutionPolicy RemoteSigned
    

    Достаточно настроить этот параметр один раз, и вам не придется делать это при каждом подключении.You need to configure this setting only once on your computer, not every time you connect.

Tip

Возникли проблемы?Having problems? Обратитесь за помощью к участникам форумов Exchange.Ask for help in the Exchange forums. Посетите форумы по Exchange Online или Exchange Online Protection.Visit the forums at: Exchange Online, or Exchange Online Protection.

Подключение к Exchange OnlineConnect to Exchange Online

  1. На локальном компьютере откройте Windows PowerShell и запустите следующую команду.On your local computer, open Windows PowerShell and run the following command.

    $UserCredential = Get-Credential
    

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

  2. Выполните следующую команду:Run the following command:

    $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/powershell-liveid/ -Credential $UserCredential -Authentication Basic -AllowRedirection
    

    Примечания.Notes:

    • Для Office 365 под управлением 21Vianet используйте значение ConnectionUri: https://partner.outlook.cn/PowerShellFor Office 365 operated by 21Vianet, use the ConnectionUri value: https://partner.outlook.cn/PowerShell

    • Для Office 365 Germany используйте значение ConnectionUri: https://outlook.office.de/powershell-liveid/For Office 365 Germany, use the ConnectionUri value: https://outlook.office.de/powershell-liveid/

    • Для Office 365 для государственных организаций в облаке High (GCC High) используйте значение ConnectionUri: https://outlook.office365.us/powershell-liveid/For Office 365 Government Community Cloud High (GCC High), use the ConnectionUri value: https://outlook.office365.us/powershell-liveid/

    • Если вы находитесь за прокси-сервером, сначала выполните следующую команду: $ProxyOptions = New-PSSessionOption -ProxyAccessType <Value>, где значение ProxyAccessType равно IEConfig, WinHttpConfig или AutoDetect.If you're behind a proxy server, run this command first: $ProxyOptions = New-PSSessionOption -ProxyAccessType <Value>, where the ProxyAccessType value is IEConfig, WinHttpConfig, or AutoDetect.

      Затем добавьте указанный ниже параметр и значение в конец команды $Session = ... : -SessionOption $ProxyOptions.Then, add the following parameter and value to the end of the $Session = ... command: -SessionOption $ProxyOptions.

      Дополнительные сведения см. в статье New-PSSessionOption.For more information, see New-PSSessionOption.

  3. Выполните следующую команду:Run the following command:

    Import-PSSession $Session -DisableNameChecking
    

Note

По завершении настройки отключите удаленный сеанс PowerShell. Если закрыть окно оболочки Windows PowerShell, не выполнив отключение сеанса, то можно исчерпать лимит доступных сеансов удаленной оболочки PowerShell. Кроме того, вам придется дождаться окончания срока действия сеансов. Чтобы отключить удаленный сеанс PowerShell, выполните приведенную ниже команду.Be sure to disconnect the remote PowerShell session when you're finished. If you close the Windows PowerShell window without disconnecting the session, you could use up all the remote PowerShell sessions available to you, and you'll need to wait for the sessions to expire. To disconnect the remote PowerShell session, run the following command.

Remove-PSSession $Session

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

После выполнения действия 3 командлеты Exchange Online импортируются в локальный сеанс Windows PowerShell и отображаются на индикаторе выполнения.After Step 3, the Exchange Online cmdlets are imported into your local Windows PowerShell session and tracked by a progress bar. Если при этом не возникают ошибки, подключение установлено.If you don't receive any errors, you connected successfully. Чтобы выполнить быструю проверку, запустите командлет Exchange Online, например Get-Mailbox, и просмотрите результаты его выполнения.A quick test is to run an Exchange Online cmdlet, for example, Get-Mailbox, and see the results.

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

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

  • Для предотвращения атак типа "отказ в обслуживании" (DoS) можно открыть не более трех подключений консоли PowerShell к организации Exchange Online.To help prevent denial-of-service (DoS) attacks, you're limited to three open remote PowerShell connections to your Exchange Online organization.

  • Для учетной записи, которую вы используете для подключения к Exchange Online, необходимо включить доступ к удаленному сеансу PowerShell. Дополнительные сведения см. в статье Включение и отключение доступа к Exchange Online PowerShell.The account you use to connect to Exchange Online must be enabled for remote PowerShell. For more information, see Enable or disable access to Exchange Online PowerShell.

  • Необходимо открыть TCP-порт 80 для трафика между локальным компьютером и Office 365.TCP port 80 traffic needs to be open between your local computer and Office 365. Вполне вероятно, что он уже открыт, но в этом следует убедиться, если в вашей организации действует политика ограниченного доступа к Интернету.It's probably open, but it's something to consider if your organization has a restrictive internet access policy.

  • Если в вашей организации используется федеративная проверка подлинности и ваш поставщик удостоверений (IDP) и/или служба маркеров безопасности (STS) не являются общедоступными, вы не сможете использовать федеративную учетную запись для подключения к Exchange Online PowerShell.If your organization uses federated authentication, and your identity provider (IDP) and/or security token service (STS) isn't publicly available, you can't use a federated account to connect to Exchange Online PowerShell. Вместо этого вам нужно создать и использовать нефедеративную учетную запись в Office 365, чтобы подключиться к Exchange Online PowerShell.Instead, create and use a non-federated account in Office 365 to connect to Exchange Online PowerShell.

См. такжеSee also

В этом разделе используются командлеты Windows PowerShell.The cmdlets that you use in this topic are Windows PowerShell cmdlets. Дополнительные сведения об этих командлетах см. в следующих разделах.For more information about these cmdlets, see the following topics.

Дополнительные сведения об управлении Office 365 см. в разделе Управление Office 365.For more information about managing Office 365, see Manage Office 365.