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

Exchange Online PowerShell позволяет Управление параметрами Exchange Online с помощью командной строки. Использование Windows PowerShell на локальном компьютере для создания удаленного сеанса PowerShell в Exchange Online. Это простой процесс трех этапов, где введите учетные данные Office 365, предоставляют необходимые параметры этого подключения и затем импортировать командлеты Exchange Online в локальный сеанс Windows PowerShell, чтобы их можно использовать.Exchange Online PowerShell allows you to manage your Exchange Online settings from the command line. You use Windows PowerShell on your local computer to create a remote PowerShell session to Exchange Online. 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 многофакторная проверка подлинности (многофакторной проверкой Подлинности), необходимо загрузить и использовать Exchange Online Remote PowerShell Module. Дополнительные сведения можно Подключить к Exchange Online PowerShell с помощью многофакторной проверки подлинности. Если вы находитесь на отдельных клиента Exchange Online Protection (EOP), и вы используете службу для защиты локальных почтовых ящиков, используйте инструкции подключения в разделе подключение к Exchange Online Protection PowerShell. Если подписка EOP — клиентская лицензия Exchange Enterprise CAL со службами (включает защиту от потери данных (DLP) и создание отчетов с помощью веб-служб), подключения к инструкциям в этом разделе помогут решить проблему.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. For more information, see Connect to Exchange Online PowerShell using multi-factor authentication. 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. 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

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

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

  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 используйте значение ConnectionUri :https://outlook.office.de/powershell-liveid/For Office 365 Germany, use the ConnectionUri value: https://outlook.office.de/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 и отслеживаемых индикатор хода выполнения. Если сообщений об ошибках нет, то подключение успешно. Быстрой проверки необходимо запустить Exchange Online командлета, например, Get-Mailboxи просмотрите результаты.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. 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.

См. также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.