Сведения о модуле PowerShell Exchange Online

Модуль PowerShell Exchange Online (также известный как модуль Exchange Online PowerShell версии 3 или модуль EXO V3 с 2022 года) использует современную проверку подлинности и работает с многофакторной проверкой подлинности (MFA) для подключения ко всем облачным средам PowerShell Exchange: Exchange Online PowerShell, безопасность & соответствия требованиям PowerShell и PowerShell для встроенной надстройки безопасности для локальных почтовых ящиков.

Инструкции по подключению с помощью модуля см. в следующих статьях:

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

  Совет

  Инструкции по подключению к PowerShell в встроенной надстройке безопасности для локальных почтовых ящиков совпадают с инструкциями по подключению для Exchange Online PowerShell.

• Подключение к PowerShell безопасности и соответствия требованиям

• Проверка подлинности только для приложений для автоматических сценариев в Exchange Online PowerShell и powerShell & безопасности

• Использование управляемых удостоверений Azure для подключения к Exchange Online PowerShell

• Подключение к Exchange Online PowerShell с помощью C#

В оставшейся части этой статьи описано, как работает модуль, как установить и обслуживать модуль, а также оптимизированные командлеты Exchange Online, доступные в модуле.

Подключения REST API в модуле EXO версии 3

с 2023 года Exchange Online PowerShell и безопасности & соответствия требованиям Используют подключения REST API для всех командлетов.

Для подключений REST API требуются модули PowerShellGet и PackageManagement. Дополнительные сведения см. в статье PowerShellGet для подключений на основе REST в Windows.

Командлеты в подключениях REST API имеют следующие преимущества по сравнению со своими историческими аналогами:

• Более безопасно: встроенная поддержка современной проверки подлинности и отсутствие зависимости от удаленного сеанса PowerShell. PowerShell на клиентском компьютере не требует обычной проверки подлинности в WinRM.
• Более надежный: при временных сбоях используются встроенные повторные попытки, поэтому сбои или задержки сведены к минимуму. Например, вы можете:
  • Сбои из-за задержек в сети.
  • Задержки из-за больших запросов, которые занимают много времени.
• Повышение производительности. Подключения REST API не позволяют настраивать пространство выполнения PowerShell.

В следующей таблице сравниваются преимущества командлетов REST API с недоступными удаленными командлетами PowerShell и эксклюзивными командлетами Get-EXO* в модуле EXO версии 3.

Командлеты REST API имеют те же имена командлетов и работают так же, как их удаленные эквиваленты PowerShell, поэтому вам не нужно обновлять имена командлетов или параметры в скриптах.

Несколько командлетов в Exchange Online PowerShell обновлены экспериментальным параметром UseCustomRouting. Этот переключатель направляет команду прямо на нужный сервер почтовых ящиков. При этом может повышаться общая производительность. Используйте параметр UseCustomRouting экспериментально.

• При применении UseCustomRoutingSwitch можно использовать только следующие значения для идентификатора почтового ящика:

  • Имя участника-пользователя (UPN)
  • Адрес электронной почты
  • GUID почтового ящика

• Параметр UseCustomRouting доступен только в следующих Exchange Online командлетах PowerShell:

  • Get-Clutter
  • Get-FocusedInbox
  • Get-InboxRule
  • Get-MailboxAutoReplyConfiguration
  • Get-MailboxCalendarFolder
  • Get-MailboxFolderPermission
  • Get-MailboxFolderStatistics
  • Get-MailboxMessageConfiguration
  • Get-MailboxPermission
  • Get-MailboxRegionalConfiguration
  • Get-MailboxStatistics
  • Get-MobileDeviceStatistics
  • Get-UserPhoto
  • Remove-CalendarEvents
  • Set-Clutter
  • Set-FocusedInbox
  • Set-MailboxRegionalConfiguration
  • Set-UserPhoto

• Используйте командлет Get-ConnectionInformation, чтобы получить сведения о подключениях к Exchange Online PowerShell и PowerShell & безопасности. Этот командлет является обязательным, так как командлет Get-PSSession в Windows PowerShell не возвращает сведения о подключениях REST API.

  Сценарии, в которых можно использовать Get-ConnectionInformation , описаны в следующей таблице:

  Сценарий	Ожидаемые выходные данные
  Выполните команды Connect-ExchangeOnline или Connect-IPPSSession .	Возвращает один объект сведений о подключении.
  Выполните после нескольких команд Connect-ExchangeOnline или Connect-IPPSSession .	Возвращает коллекцию объектов сведений о подключении.

• Используйте переключатель SkipLoadingFormatData в командлете Connect-ExchangeOnline , чтобы избежать загрузки данных формата и ускорить выполнение команд Connect-ExchangeOnline .

• Командлеты, поддерживаемые REST API, имеют 15-минутное время ожидания, что может повлиять на массовые операции. Например, следующая команда Update-DistributionGroupMember для обновления 10 000 членов группы рассылки может истекать:

  $Members = @("member1","member2",...,"member10000")
  
  Update-DistributionGroupMember -Identity DG01 -Members $Members
  

  Вместо этого используйте команду Update-DistributionGroupMember , чтобы обновить меньше элементов, а затем добавить остальные члены по отдельности с помощью команды Add-DistributionGroupMember . Например, вы можете:

  Update-DistributionGroupMember -Identity DG01 -Members $Members[0..4999]
  
  $Remaining = $Members[-5000..-1]
  
  foreach ($Member in $Remaining)
  
  {
     Add-DistributionGroupMember -Identity DG01 -Member $Member
  }
  

Дополнительные сведения о новых возможностях модуля EXO версии 3 см. в разделе Заметки о выпуске далее в этой статье.

Сообщение об ошибках и проблемах для предварительных версий модуля PowerShell Exchange Online

Для предварительных версий модуля используйте , exocmdletpreview[at]service[dot]microsoft[dot]com чтобы сообщить о любых проблемах, которые могут возникнуть. Обязательно включите файлы журналов в сообщение электронной почты. Чтобы создать файлы журнала, замените <Path> выходной папкой, а затем выполните следующую команду:

Connect-ExchangeOnline -EnableErrorReporting -LogDirectoryPath <Path> -LogLevel All

Командлеты в модуле PowerShell Exchange Online

Модуль EXO содержит девять эксклюзивных командлетов Get-EXO*, оптимизированных для ускорения сценариев массового получения данных (тысячи и тысячи объектов) в Exchange Online PowerShell. Улучшенные командлеты в модуле перечислены в следующей таблице:

Командлеты, связанные с подключением, в модуле перечислены в следующей таблице:

В следующей таблице перечислены другие командлеты Exchange Online функций, которые находятся в модуле:

Установка и обслуживание модуля PowerShell Exchange Online

Скачайте модуль из коллекции PowerShell по адресу https://www.powershellgallery.com/packages/ExchangeOnlineManagement/.

В процедурах, описанных в этом разделе, объясняется, как установить, обновить и удалить модуль.

Поддерживаемые операционные системы для модуля PowerShell Exchange Online

Модуль официально поддерживается в PowerShell 7 в Windows, Linux и MacOS Apple:

• Для модулей версии 3.5.0 (май 2024 г.) или более поздней требуется PowerShell 7.4.0 (ноябрь 2023 г.) или более поздней из-за зависимостей сборки .NET 8.0. Более ранние версии PowerShell 7 могут столкнуться с проблемами совместимости (PowerShell 7.3.6 более совместим, чем 7.3.7).
• Для модулей версий 3.0.0 (сентябрь 2022 г.) до 3.4.0 (октябрь 2023 г.) требуется PowerShell 7.2.0 (ноябрь 2021 г.) или более поздней версии из-за зависимостей сборки .NET 6.0 в командлетах и подключениях REST API.
• Поддержка модуля в PowerShell 7 началась с версии 2.0.4 (февраль 2021 г.) в PowerShell 7.0.3 (июль 2020 г.).

Дополнительные сведения о PowerShell 7 см. в статье Что такое PowerShell?.

Apple macOS

Модуль поддерживается в следующих версиях macOS:

• macOS 13 Ventura или более поздней версии:

  Версия модуля	Версия PowerShell
  3.5.0 или более поздней версии	7.4.0 или более поздней версии

  7.4.0 — это минимальная поддерживаемая версия PowerShell 7 в macOS 13 или более поздней версии. Также поддерживаются версии модулей с 3.0.0 до 3.4.0.

• macOS 12 Monterey и mac OS 11 Big Sur:

  Версия модуля	Версия PowerShell
  3.5.0 или более поздней версии	7.4.x
  С 3.0.0 до 3.4.0	С 7.2.0 до 7.3.7 (или более поздней версии)
  2.0.4 и 2.0.5	С 7.0.3 до 7.1.5 (или более поздней версии)

  Модули версии 3.0.0 или более поздние поддерживаются на всех процессорах.

  Модули версий 2.0.4 и 2.0.5 изначально работают на процессорах Intel. Для процессоров Apple M1 или Apple M2 требуется Apple Rosetta 2.

  7.4.x — это последняя поддерживаемая версия PowerShell 7 в macOS 11 и macOS 12.

• macOS 10.15 Catalina:

  Версия модуля	Версия PowerShell
  С 3.0.0 до 3.4.0	С 7.2.0 по 7.2.22
  2.0.4 и 2.0.5	С 7.0.3 до 7.1.5 (или более поздней версии)

  7.2.22 — это последняя поддерживаемая версия PowerShell 7 в macOS 10.15.

• macOS 10.14 Mojave

  Версия модуля	Версия PowerShell
  2.0.4 и 2.0.5	С 7.0.3 по 7.1.5

  7.1.5 — это последняя поддерживаемая версия PowerShell 7 в macOS 10.14.

Инструкции по установке PowerShell 7 в macOS см. в статье Установка PowerShell в macOS.

Как описано в статье об установке, необходимо установить OpenSSL, что необходимо для WSMan.

После установки PowerShell 7 и OpenSSL выполните следующие действия.

1. Запустите PowerShell в качестве суперпользователя: sudo pwsh

2. В сеансе суперпользователя PowerShell запустите следующие команды:

   Install-Module -Name PSWSMan
   
   Install-WSMan
   

   Если будет предложено, примите PSGallery в качестве источника командлетов.

Теперь вы можете выполнить обычные предварительные требования к PowerShell и установить Exchange Online модуля PowerShell.

Linux

Модуль официально поддерживается в следующих дистрибутивах Linux:

• Ubuntu 24.04 LTS

  Версия модуля	Версия PowerShell
  3.5.0 или более поздней версии	7.4.0 или более поздней версии
  С 3.0.0 до 3.4.0	С 7.2.0 до 7.3.7 (или более поздней версии)

• Ubuntu 20.04 LTS

  Версия модуля	Версия PowerShell
  3.5.0 или более поздней версии	7.4.x
  С 3.0.0 до 3.4.0	С 7.2.0 до 7.3.7 (или более поздней версии)
  2.0.4 и 2.0.5	С 7.0.3 до 7.1.5 (или более поздней версии)

  В версиях 3.7.0 или более поздних может возникнуть сбой с ошибками протокола SSL.

• Ubuntu 18.04 LTS

  Версия модуля	Версия PowerShell
  3.5.0 или более поздней версии	7.4.x
  С 3.0.0 до 3.4.0	С 7.2.0 до 7.3.7 (или более поздней версии)
  2.0.4 и 2.0.5	С 7.0.3 до 7.1.5 (или более поздней версии)

  Модули версии 3.7.0 или более поздней могут иметь проблемы с надежностью в Ubuntu 18.04 LTS.

Инструкции по установке PowerShell 7 в Linux см. в статье Установка PowerShell в Linux.

После установки PowerShell 7 выполните следующие действия:

1. Запустите PowerShell в качестве суперпользователя: sudo pwsh

2. В сеансе суперпользователя PowerShell запустите следующие команды:

   Install-Module -Name PSWSMan
   
   Install-WSMan
   

   Если будет предложено, примите PSGallery в качестве источника командлетов.

Теперь вы можете выполнить обычные предварительные требования к PowerShell и установить Exchange Online модуля PowerShell.

Windows

• Windows PowerShell 5.1:

  • Поддерживаются все версии модуля.
  • Текущие версии Windows включают необходимые версии платформа .NET Framework, поэтому вам не нужно устанавливать платформа .NET Framework для использования модуля в Windows PowerShell 5.1.

• PowerShell 7:

  • Для модулей версии 3.5.0 (май 2024 г.) или более поздней требуется PowerShell 7.4.0 (ноябрь 2023 г.) или более поздней из-за зависимостей сборки .NET 8.0. В более ранних версиях PowerShell 7 могут возникнуть проблемы совместимости (PowerShell 7.3.6 более совместим с модулем, чем с 7.3.7).
  • Для модулей версий 3.0.0 (сентябрь 2022 г.) до 3.4.0 (октябрь 2023 г.) требуется PowerShell 7.2.0 (ноябрь 2021 г.) или более поздней версии из-за зависимостей сборки .NET 6.0 в командлетах и подключениях REST API.
  • Поддержка модуля в PowerShell 7 началась с версии 2.0.4 (февраль 2021 г.) в PowerShell 7.0.3 (июль 2020 г.).

Поддержка определенных версий модулей в Windows зависит от поддержки Windows PowerShell и платформа .NET Framework и (или) поддержки .NET, как описано в следующем списке.

• Windows 11:

  Версия модуля	Версия PowerShell	Требование .NET
  2.0.5 или более поздней версии	5.1	платформа .NET Framework 4.7.2 (включена версия 4.8.x, поэтому вам не нужно устанавливать платформа .NET Framework)
  3.5.0 или более поздней версии	7.4.0 или более поздней версии	.NET 8.0 Входит в состав версии 24H2 или более поздней версии.
  С 3.0.0 до 3.4.0	С 7.2.0 до 7.3.7 (или более поздней версии)	.NET 6.0 (7.2.x) .NET 7.0 (7.3.x)

  7.2.0 (.NET 6.0) — самая ранняя поддерживаемая версия PowerShell 7 в Windows 11.

• Windows Server 2022 г.:

  Версия модуля	Версия PowerShell	Требование .NET
  2.0.5 или более поздней версии	5.1	платформа .NET Framework 4.7.2 (включена версия 4.8, поэтому устанавливать платформа .NET Framework не требуется)
  3.5.0 или более поздней версии	7.4.0 или более поздней версии	.NET 8.0
  С 3.0.0 до 3.4.0	С 7.2.0 до 7.3.7 (или более поздней версии)	.NET 6.0 (7.2.x) .NET 7.0 (7.3.x)

  7.2.0 (.NET 6.0) — самая ранняя поддерживаемая версия PowerShell 7 в Windows Server 2022 г.

• Windows 10:

  Версия модуля	Версия PowerShell	Поддерживаемая версия Windows	Требование .NET
  2.0.5 или более поздней версии	5.1	Юбилейное обновление (версия 1607; Август 2016 г.) или более поздняя версия	.NET Framework 4.7.2 Обновление за апрель 2018 г. (версия 1803) или более поздняя версия включает платформа .NET Framework 4.7.2, поэтому его не нужно скачивать.
  3.5.0 или более поздней версии	7.4.0 или более поздней версии	Обновление за октябрь 2018 г. (версия 1809) или более поздняя версия	.NET 8.0
  С 3.0.0 до 3.4.0	С 7.2.0 до 7.3.7 (или более поздней версии)	Обновление за октябрь 2018 г. (версия 1809) или более поздняя версия	.NET 6.0 (7.2.x) .NET 7.0 (7.3.x)
  2.0.4 и 2.0.5	С 7.0.3 до 7.1.5 (или более поздней версии)	Юбилейное обновление (версия 1607; Август 2016 г.) или более поздняя версия	.NET Core 3.1 (7.0.x) .NET 5.0 (7.1.x)

• Windows Server 2016 и Windows Server 2019 г.:

  Версия модуля	Версия PowerShell	Требование .NET
  2.0.5 или более поздней версии	5.1	.NET Framework 4.7.2 Включено в Windows Server 2019 года.
  3.5.0 или более поздней версии	7.4.0 или более поздней версии	.NET 8.0
  С 3.0.0 до 3.4.0	С 7.2.0 до 7.3.7 (или более поздней версии)	.NET 6.0 (7.2.x) .NET 7.0 (7.3.x)
  2.0.4 и 2.0.5	С 7.0.3 до 7.1.5 (или более поздней версии)	.NET Core 3.1 (7.0.x) .NET 5.0 (7.1.x)

• Windows 8.1, Windows Server 2012 и Windows Server 2012 R2:

  Версия модуля	Версия PowerShell	Требование .NET
  2.0.5 или более поздней версии	5.1	.NET Framework 4.7.2
  С 3.0.0 до 3.4.0	7.2.x	.NET 6.0
  2.0.4 и 2.0.5	С 7.0.3 до 7.1.5 (или более поздней версии)	.NET Core 3.1 (7.0.x) .NET 5.0 (7.1.x)

  7.2.22 (.NET 6.0) — это последняя поддерживаемая версия PowerShell 7 в Windows 8.1, Windows Server 2012 и Windows Server 2012 R2.

• Windows 7.1 с пакетом обновления 1 (SP1) и Windows Server 2008 R2 с пакетом обновления 1 (SP1):

  Версия модуля	Версия PowerShell	Требование .NET
  2.0.3	5.1	.NET Framework 4.7.1

  Примечание.

  Хотя вы можете установить эту версию модуля, вы не можете подключиться к Exchange Online PowerShell. Модуль версии 2.0.3 не поддерживает подключения REST API.

Предварительные требования для модуля PowerShell Exchange Online

Задайте для политики выполнения PowerShell значение RemoteSigned.

Чтобы запускать сценарии, необходимо настроить PowerShell. По умолчанию это приложение не настроено. При попытке подключения появляется следующая ошибка:

Файлы невозможно загрузить, поскольку выполнение сценариев в этой системе отключено. Предоставьте действительный сертификат для подписи файлов.

Чтобы требовать подписывание доверенного издателя для всех скриптов PowerShell, скачанных из Интернета, выполните следующую команду в окне PowerShell с повышенными привилегиями (окно PowerShell, открываемое путем выбора запуска от имени администратора):

Set-ExecutionPolicy RemoteSigned

Дополнительные сведения о политиках выполнения см. в статье Сведения о политиках выполнения.

Обычная проверка подлинности в WinRM

По состоянию на октябрь 2023 г. подключения REST API заменили подключения с базовой проверкой подлинности (удаленной оболочкой PowerShell) в Exchange Online PowerShell и PowerShell & безопасности. Для подключений REST API не требуется обычная проверка подлинности в WinRM.

Версия 3.2.0 (июнь 2023 г.) и более поздняя версия модуля полностью поддерживают командлеты REST API в Exchange Online PowerShell и Безопасность & соответствия Требованиям PowerShell.

Требуется PowerShellGet в Windows

Для подключений REST API в Windows требуется модуль PowerShellGet. По зависимости для модуля PowerShellGet требуется модуль PackageManagement. Эти модули больше относятся к PowerShell 5.1, чем к PowerShell 7, но все версии PowerShell получают преимущество от установки последних версий модулей. Инструкции по установке и обновлению см. в статье Установка PowerShellGet в Windows.

Если при попытке подключения не установлен PowerShellGet, возникает следующая ошибка:

Не удается найти Update-Manifest командлета

Установка модуля PowerShell Exchange Online

Чтобы установить модуль в первый раз, выполните следующие действия.

1. Установите или обновите модуль PowerShellGet, как описано в статье Установка PowerShellGet.

2. Закройте и снова откройте окно Windows PowerShell.

3. Теперь можно использовать командлет Install-Module для установки модуля из коллекция PowerShell. Как правило, требуется последняя общедоступная версия модуля, но вы также можете установить предварительную версию, которая является более новой, чем текущая версия.

   • Чтобы установить последнюю общедоступную версию модуля, выполните одну из следующих команд:

     • В окне PowerShell с повышенными правами (все пользователи):

       Install-Module -Name ExchangeOnlineManagement
       

     • Только для учетной записи текущего пользователя:

       Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser
       

   • Чтобы просмотреть доступные предварительные версии модуля, выполните следующую команду:

     Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease
     

   • Чтобы установить последнюю доступную предварительную версию модуля, выполните одну из следующих команд:

     • В окне PowerShell с повышенными правами (все пользователи):

       Install-Module -Name ExchangeOnlineManagement -AllowPrerelease
       

     • Только для учетной записи текущего пользователя:

       Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser -AllowPrerelease
       

   • Чтобы установить определенную предварительную версию модуля, замените <PreviewVersion> необходимым значением и выполните одну из следующих команд:

     • В окне PowerShell с повышенными правами (все пользователи):

       Install-Module -Name ExchangeOnlineManagement -RequiredVersion <PreviewVersion> -AllowPrerelease
       

     • Только для учетной записи текущего пользователя:

       Install-Module -Name ExchangeOnlineManagement -RequiredVersion <PreviewVersion> -AllowPrerelease -Scope CurrentUser
       

   После завершения введите Y, чтобы принять лицензионное соглашение.

Дополнительные сведения о синтаксисе и параметрах см. в разделе Install-Module.

Обновление модуля PowerShell Exchange Online

Если модуль уже установлен на компьютере, можно использовать процедуры, описанные в этом разделе, для обновления модуля.

1. Чтобы просмотреть версию установленного модуля и его расположение, выполните следующую команду:

   Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocation
   

   Если модуль установлен в C:\Program Files\WindowsPowerShell\Modules, он устанавливается для всех пользователей. Если модуль установлен в папке Документы, он устанавливается только для текущей учетной записи пользователя.

2. Чтобы обновить модуль из коллекция PowerShell, можно использовать командлет Update-Module. Как правило, требуется последняя общедоступная версия модуля, но вы также можете выполнить обновление до предварительной версии, если они доступны.

   • Чтобы выполнить обновление до последней общедоступной версии модуля, выполните одну из следующих команд в зависимости от того, как вы изначально установили модуль (все пользователи и только для текущей учетной записи пользователя):

     • В окне PowerShell с повышенными правами (все пользователи):

       Update-Module -Name ExchangeOnlineManagement
       

     • Только для учетной записи текущего пользователя:

       Update-Module -Name ExchangeOnlineManagement -Scope CurrentUser
       

   • Чтобы выполнить обновление до предварительной версии модуля, можно обновить до последней доступной предварительной версии или использовать параметр RequiredVersion для обновления до определенной предварительной версии.

     • Чтобы просмотреть доступные предварительные версии модуля, выполните следующую команду:

       Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease
       

     • Чтобы обновить модуль до последней доступной предварительной версии , выполните одну из следующих команд:

       • В окне PowerShell с повышенными правами (все пользователи):

         Update-Module -Name ExchangeOnlineManagement -AllowPrerelease
         

       • Только для учетной записи текущего пользователя:

         Update-Module -Name ExchangeOnlineManagement -Scope CurrentUser -AllowPrerelease
         

     • Чтобы выполнить обновление до определенной предварительной версии модуля, замените <PreviewVersion> необходимым значением и выполните одну из следующих команд:

       • В окне PowerShell с повышенными правами (все пользователи):

         Update-Module -Name ExchangeOnlineManagement -RequiredVersion <PreviewVersion> -AllowPrerelease
         

       • Только для учетной записи текущего пользователя:

         Update-Module -Name ExchangeOnlineManagement -Scope CurrentUser -RequiredVersion <PreviewVersion> -AllowPrerelease
         

   После завершения введите Y, чтобы принять лицензионное соглашение.

3. Чтобы убедиться, что обновление прошло успешно, выполните следующие команды, чтобы проверка сведения о версии установленного модуля:

   Import-Module ExchangeOnlineManagement; Get-Module ExchangeOnlineManagement
   

Дополнительные сведения о синтаксисе и параметрах см. в разделе Update-Module.

Устранение неполадок с установкой модуля PowerShell Exchange Online

• Вы получаете одну из следующих ошибок:

  Указанный модуль ExchangeOnlineManagement с PowerShellGetFormatVersion version<> не поддерживается текущей версией PowerShellGet. Получите последнюю версию модуля PowerShellGet, чтобы установить этот модуль, "ExchangeOnlineManagement".

  ПРЕДУПРЕЖДЕНИЕ. Не удается скачать из URI 'https://go.microsoft.com/fwlink/?LinkID=627338& clcid=0x409" до "".

  ПРЕДУПРЕЖДЕНИЕ. Не удается скачать список доступных поставщиков. Проверьте подключение к Интернету.

  Обновите установку модуля PowerShellGet до последней версии, как описано в разделе Установка PowerShellGet. Не забудьте закрыть и снова открыть окно PowerShell, прежде чем снова пытаться обновить модуль ExchangeOnlineManagement.

• Вы получаете следующую ошибку:

  Для указанных критериев поиска и имени модуля ExchangeOnlineManagement совпадений не найдено. Чтобы увидеть все доступные репозитории зарегистрированных модулей, запустите Get-PSRepository.

  Для репозитория по умолчанию для модулей PowerShell не задано значение PSGallery. Чтобы устранить эту ошибку, запустите следующую команду:

  Register-PSRepository -Default
  

• С апреля 2020 г. коллекция PowerShell поддерживает только подключения с использованием TLS 1.2 или более поздней версии. Дополнительные сведения см. в разделе Поддержка TLS в коллекции PowerShell.

  Чтобы проверить текущие параметры в Microsoft .NET Framework, выполните в Windows PowerShell следующую команду.

  [Net.ServicePointManager]::SecurityProtocol
  

  Как описано в статье о поддержке TLS в коллекции PowerShell, чтобы временно изменить протокол безопасности на TLS 1.2 для установки модулей PowerShellGet или ExchangeOnlineManagement, перед установкой модуля выполните в Windows PowerShell следующую команду.

  [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  

  Чтобы навсегда включить надежное шифрование в Microsoft .NET Framework версии 4.x или более поздней, выполните одну из следующих команд в зависимости от своей архитектуры Windows.

  • x64:

    Set-ItemProperty -Path 'HKLM:\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Type DWord -Value '1'
    

  • x86:

    Set-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\.NETFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Type DWord -Value '1'
    

  Дополнительные сведения см. в разделе SchUseStrongCrypto.

Удаление модуля PowerShell Exchange Online

Чтобы просмотреть версию установленного модуля и его расположение, выполните следующую команду:

Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocation

Если модуль установлен в C:\Program Files\WindowsPowerShell\Modules, он был установлен для всех пользователей. Если модуль установлен в папке Документы, он был установлен только для текущей учетной записи пользователя.

Чтобы удалить модуль, выполните следующую команду в одной из следующих сред в зависимости от того, как вы изначально установили модуль (все пользователи и только для текущей учетной записи пользователя):

• В окне PowerShell с повышенными привилегиями (все пользователи).

• В обычном окне PowerShell (только для текущей учетной записи пользователя).

  Uninstall-Module -Name ExchangeOnlineManagement
  

Дополнительные сведения о синтаксисе и параметрах см. в разделе Uninstall-Module.

Свойства и наборы свойств в модуле PowerShell Exchange Online

Традиционные командлеты Exchange Online возвращают все возможные свойства объекта, включая множество пустых или неинтересных свойств. Такое поведение приводит к снижению производительности (увеличивается объем серверных вычислений и нагрузка на сеть). Полный набор свойств редко требуется (практически никогда) в выходных результатах командлета.

Командлеты Get-EXO* в модуле содержат классифицированные выходные свойства. Вместо того, чтобы присвоить всем свойствам одинаковую важность и возвращать их во всех сценариях, мы классифицировали определенные связанные свойства в наборы свойств. Эти наборы свойств представляют собой контейнеры двух или более связанных свойств в командлете .

Самые большие и наиболее часто используемые командлеты Get-EXO* используют наборы свойств:

• Get-EXOCasMailbox
• Get-EXOMailbox
• Get-EXOMailboxStatistics
• Get-EXORecipient

В этих командлетах свойства задаются следующими параметрами:

• PropertySets: этот параметр принимает одно или больше доступных имен наборов свойств с разделителями-запятыми. Доступные наборы свойств описаны в разделе Наборы свойств в командлетах модуля Exchange Online PowerShell.
• Properties: этот параметр принимает одно или больше имен свойств с разделителями-запятыми.

Вы можете использовать параметры PropertySets и Properties вместе в одной команде.

Мы также включили минимальный набор свойств, включающий минимальный набор обязательных свойств для выходных данных командлета (например, свойства удостоверения). Свойства в минимальных наборах свойств также описаны в разделе Наборы свойств в командлетах модуля Exchange Online PowerShell.

• Если вы не используете параметры PropertySets или Properties, то автоматически получите свойства из набора Minimum.
• Если вы используете параметры PropertySets или Properties, вы получите указанные свойства и свойства из набора Minimum.

В любом случае выходные данные командлета содержат гораздо меньше свойств, а результаты возвращаются гораздо быстрее.

Например, после подключения к Exchange Online PowerShell в следующем примере возвращаются только свойства в наборе свойств Minimum для первых 10 почтовых ящиков.

Get-EXOMailbox -ResultSize 10

В отличие от этого, выходные данные той же команды Get-Mailbox возвращают по крайней мере 230 свойств для каждого из первых 10 почтовых ящиков.

Дополнительные сведения о фильтрации в модуле см. в разделе Фильтры в Exchange Online модуля PowerShell.

Заметки о выпуске

Если не указано иное, текущий выпуск модуля PowerShell Exchange Online содержит все функции предыдущих выпусков.

Текущая версия

Версия 3.9.2

• Новые командлеты Add-WorkforceInsightsDelegationAccess, Get-WorkforceInsightsDelegationAccess и Remove-WorkforceInsightsDelegationAccess для делегирования Аналитики рабочей силы.
• Новый параметр EXOModuleBasePath в Connect-ExchangeOnline и Connect-IPPSSession для хранения временных файлов модуля EXO по пользовательскому пути.
• Устаревший параметр UseRpsSession из Connect-ExchangeOnline и Connect-IPPSSession.

Предыдущие выпуски

Версия 3.9.0

• Новый переключатель EnableSearchOnlySession для Connect-IPPSSession, который включает определенные командлеты обнаружения электронных данных и связанные командлеты, которые подключаются к другим службам Microsoft 365.

Версия 3.8.0

• Новый параметр AccessToken в Connect-IPPSSession.

• Get-VivaModuleFeature теперь возвращает сведения о ParentFeature, ChildFeature и PolicyModes. Эти значения представляют родительские и дочерние функции функции приложения Viva, а также доступные режимы включения для будущих политик.

• Новые параметры IsUserOptedInByDefault в командлетах Add-VivaModuleFeaturePolicy и Update-VivaModuleFeaturePolicy и соответствующее значение свойства во всех командлетах *-VivaModuleFeaturePolicy . Значение указывает, разрешены ли пользователи политикой, если пользователь не задает предпочтения.

  Этот параметр можно использовать для сохранения включенной функции в организации при отказе от затронутых пользователей по умолчанию, эффективно отключая функцию для этих пользователей.

• Не рекомендуется использовать командлет Get-VivaFeatureCategory , все связанные с категориями параметры и возвращаемые значения (CategoryId, IsCategoryEnabled).

Версия 3.7.2

• Параметр DisableWAM доступен в командлете Connect-ExchangeOnline для отключения диспетчера веб-учетных записей (WAM), если возникают ошибки подключения, связанные с WAM.

Версия 3.7.1

• Добавлено новое свойство с именем ExoExchangeSecurityDescriptor в выходные данные Get-EXOMailbox , похожее на ExchangeSecurityDescriptor свойство в выходных данных Get-Mailbox.
• Добавлены новые командлеты для поддержки функции делегирования Viva Org Insights:
  • Add-VivaOrgInsightsDelegatedRole
  • Get-VivaOrgInsightsDelegatedRole
  • Remove-VivaOrgInsightsDelegatedRole

Версия 3.7.0

• Интегрированный диспетчер веб-учетных записей (WAM) в потоки проверки подлинности для повышения безопасности.
• Справка по командной строке для командлетов PowerShell Exchange Online больше не загружается по умолчанию. Используйте параметр LoadCmdletHelp в командлете Connect-ExchangeOnline, чтобы получить справку по Exchange Online командлетам PowerShell.
• Исправлены проблемы с подключением к проверке подлинности только для приложений в PowerShell для соответствия требованиям безопасности &.

Версия 3.6.0

• Get-VivaModuleFeature теперь возвращает сведения о типах удостоверений, для которые функция поддерживает создание политик (например, пользователей, групп или всей организации).
• Командлеты для управления доступом к функциям Viva теперь обрабатывают запросы утверждений непрерывной оценки доступа (CAE).
• Добавлено исправление проблемы совместимости с модулем Microsoft.Graph.

Версия 3.5.1

• Исправления ошибок в Get-EXOMailboxPermission и Get-EXOMailbox.
• Модуль обновлен для запуска в .NET 8, заменив предыдущую версию на основе .NET 6.
• Усовершенствования в Add-VivaModuleFeaturePolicy.

Версия 3.5.0

• Новый командлет Get-VivaFeatureCategory .
• Добавлена поддержка операций политики на уровне категорий в Viva Управление доступом к функциям (VFAM).
• Новое свойство IsFeatureEnabledByDefault в выходных данных Get-VivaModuleFeaturePolicy. Значение этого свойства показывает состояние включения по умолчанию для пользователей, когда организация или политики пользователей или групп не были созданы.

Версия 3.4.0

• Исправления ошибок в Connect-ExchangeOnline, Get-EXORecipientPermission и Get-EXOMailboxFolderPermission.
• Параметр SigningCertificate в Connect-ExchangeOnline теперь поддерживает режим ограниченного языка (CLM).

Версия 3.3.0

• Параметр SkipLoadingCmdletHelp в Connect-ExchangeOnline для поддержки пропуска загрузки файлов справки командлетов.
• Глобальная переменная EXO_LastExecutionStatus доступна для проверка состояния последнего запущенного командлета.
• Исправления ошибок в Connect-ExchangeOnline и Connect-IPPSSession.
• Параметр IsUserControlEnabled в Add-VivaModuleFeaturePolicy и Update-VivaModuleFeaturePolicy поддерживает включение пользовательских элементов управления по политике для функций, подключенных к управлению доступом к функциям Viva.

Версия 3.2.0

• Новые командлеты:
  • Get-DefaultTenantBriefingConfig и Set-DefaultTenantBriefingConfig.
  • Get-DefaultTenantMyAnalyticsFeatureConfig и Set-DefaultTenantMyAnalyticsFeatureConfig.
  • Get-VivaModuleFeature, Get-VivaModuleFeatureEnablement, Add-VivaModuleFeaturePolicy, Get-VivaModuleFeaturePolicy, Remove-VivaModuleFeaturePolicy и Update-VivaModuleFeaturePolicy.
• Поддержка подключений REST API для PowerShell & соответствия требованиям безопасности.
• Параметр ConnectionId в Get-ConnectionInformation и Disconnect-ExchangeOnline:
  • Получение сведений о подключении для определенных подключений REST API.
  • Выборочное отключение для подключений REST API.
• Параметр SignCertificate в Connect-ExchangeOnline позволяет подписывать файлы форматирования (*. Format.ps1xml) или файлы модуля скриптов (PSM1) во временном модуле, который Connect-ExchangeOnline создает с сертификатом клиента для использования во всех политиках выполнения PowerShell.
• Исправления ошибок в Connect-ExchangeOnline.

Версия 3.1.0

• Параметр AccessToken доступен в Connect-ExchangeOnline.
• Исправления ошибок в Connect-ExchangeOnline и Get-ConnectionInformation.
• Исправлена ошибка в Connect-IPPSSession для подключения к PowerShell & соответствия безопасности с помощью CertificateThumbprint.

Версия 3.0.0 (предварительные версии, известные как v2.0.6-PreviewX)

• Функции, уже описанные в разделе "Подключения REST API" в модуле EXO версии 3 :
  • Проверка подлинности на основе сертификатов для PowerShell & соответствия безопасности (версия 2.0.6-Preview5 или более поздняя).
  • Командлет Get-ConnectionInformation для подключений на основе REST (версии 2.0.6-Preview7 или более поздней).
  • Переключатель SkipLoadingFormatData в командлете Connect-ExchangeOnline для подключений на основе REST (версия 2.0.6-Preview8 или более поздняя).
• Параметр DelegatedOrganization работает в командлете Connect-IPPSSession , если в команде также используется параметр AzureADAuthorizationEndpointUri .
• Некоторые командлеты, запрашивающие подтверждение в определенных сценариях, больше не делают этого. По умолчанию командлет выполняется до завершения.
• Формат ошибки, возвращенной при неудачном выполнении командлета, немного изменен. Исключение теперь содержит больше данных (например, тип исключения), а FullyQualifiedErrorId объект не содержит FailureCategory. Формат ошибки может быть изменен в дальнейшем.

Версия 2.0.5

• Новые командлеты Get-OwnerlessGroupPolicy и Set-OwnerlessGroupPolicy для управления бесхозяйными Группы Microsoft 365.

  Примечание.

  Хотя командлеты доступны в модуле, функция доступна только участникам закрытой предварительной оценки.

• Новые командлеты Get-VivaInsightsSettings и Set-VivaInsightsSettings для управления доступом пользователей к функциям Headspace в Viva Insights.

Версия 2.0.4

• PowerShell 7 официально поддерживается в Windows, Linux и Apple macOS, как описано в разделе Предварительные требования для модуля Exchange Online PowerShell этой статьи.

• Модуль в PowerShell 7 поддерживает единый вход на основе браузера и другие методы входа. Дополнительные сведения см. в разделе Эксклюзивные методы подключения PowerShell 7.

• Командлеты Get-UserAnalyticsConfig и Set-UserAnalyticsConfig были заменены командлетами Get-MyAnalyticsConfig и Set-MyAnalyticsConfig. Кроме того, вы можете настроить доступ на уровне компонентов. Дополнительные сведения см. в статье Настройка MyAnalytics.

• Применение политики в режиме реального времени и защиты во всех проверках подлинности на основе пользователей. В модуле включена непрерывная оценка доступа (CAE). Узнайте больше о CAE здесь.

• Свойства LastUserActionTime и LastInteractionTime теперь доступны в выходных данных командлета Get-EXOMailboxStatistics.

• В интерактивном процессе входа теперь используется более безопасный метод получения маркеров доступа с использованием безопасных URL-адресов ответа.

Версия 2.0.3

• Общедоступная проверка подлинности на основе сертификатов (CBA), которая обеспечивает использование современной проверки подлинности при автоматических сценариях или сценариях с фоновой автоматизацией. Ниже указаны доступные расположения хранилищ сертификатов.
  • Удаленный в параметре Azure Key Value (Certificate). Этот параметр повышает уровень безопасности за счет получения сертификата только в среде выполнения.
  • Локальный в хранилище сертификатов CurrentUser или LocalMachine (параметр CertificateThumbprint).
  • Локальный в экспортированном файле сертификата (параметры CertificateFilePath и CertificatePassword). Дополнительные сведения см. в описании параметров в разделе Проверка подлинности только для приложений и Connect-ExchangeOnline для автоматических сценариев в модуле Exchange Online PowerShell.
• Одновременное подключение к Exchange Online PowerShell и PowerShell безопасности и соответствия требованиям в одном окне PowerShell.
• Новый параметр CommandName позволяет указать и ограничить командлеты Exchange Online PowerShell, импортированные во время сеанса. Этот параметр сокращает объем памяти для приложений PowerShell с высокой загрузкой.
• Get-EXOMailboxFolderPermission теперь поддерживает ExternalDirectoryObjectID в параметреIdentity.
• Оптимизированная задержка первого вызова командлета V2. Результаты лаборатории показывают, что задержка первого вызова снизилась с 8 секунд до примерно 1 секунды. Фактические результаты зависят от размера результата командлета и среды организации.

Версия 1.0.1

• Общедоступная версия модуля EXO V2. Он стабилен и готов к использованию в рабочих средах.
• Командлет Get-ExoMobileDeviceStatistics теперь поддерживает параметр Identity.
• Повышена надежность автоматического повторного подключения сеансов в некоторых сценариях, когда скрипт выполнялся в течение ~50 минут и вызвал ошибку "Командлет не найден" из-за ошибки в логике автоматического повторного подключения.
• Устранены проблемы с типом данных двух широко используемых атрибутов "User" и "MailboxFolderUser" для легкого переноса сценариев.
• Улучшена поддержка фильтров. Теперь поддерживаются еще четыре оператора: EndsWith, Contains, Not и NotLike. Проверьте фильтры в модуле Exchange Online PowerShell для атрибутов, которые не поддерживаются в фильтрах.

Версия 0.4578.0

• Добавлена поддержка настройки писем со сводкой дел для организации на уровне пользователя с применением командлетов Set-UserBriefingConfig и Get-UserBriefingConfig.
• Поддержка очистки сеанса с помощью командлета Disconnect-ExchangeOnline. Этот командлет является эквивалентом Get-PSSession | Remove-PSSession V2. Кроме очистки объекта сеанса и локальных файлов, это также приводит к удалению маркера доступа из кэша, который используется для проверки подлинности в командлетах V2.
• Теперь можно использовать FolderId как параметр удостоверения в Get-EXOMailboxFolderPermission. Чтобы получить значение FolderId, используйте Get-MailboxFolder. Например: Get-MailboxFolderPermission -Identity <UPN>:<Folder-Path>Get-MailboxFolderPermission -Identity <UPN>:\<Folder-Id>
• Повышена надежность Get-EXOMailboxStatistics , так как устранены определенные ошибки маршрутизации запросов, которые привели к сбоям.
• Оптимизировано использование памяти для новых сеансов, созданных при повторном использовании существующих модулей вместо создания нового сеанса при каждом импорте сеанса.

Версия 0.4368.1

• Добавлена поддержка командлетов PowerShell безопасности и соответствия требованиям с использованием командлета Connect-IPPSSession.
• Скрыть баннер с объявлением можно с помощью переключателя ShowBanner (-ShowBanner:$false).
• Остановите выполнение командлета на исключениях клиента.
• Удаленная оболочка PowerShell содержит различные сложные типы данных, которые намеренно не поддерживаются в командлетах EXO для повышения производительности. Различия в некомплексных типах данных между удаленными командлетами PowerShell и командлетами версии 2 устранены, чтобы обеспечить беспроблемную миграцию сценариев управления.

Версия 0.3582.0

• Поддержка префикса во время создания сеанса:
  • Одновременно можно создать только один сеанс, содержащий командлеты с префиксом.
  • Командлеты EXO версии 2 не имеют префикса, так как они уже имеют префикс EXO, поэтому не используйте EXO в качестве префикса.
• Используйте командлеты EXO V2, даже если на клиентском компьютере отключена обычная проверка подлинности WinRM. Для удаленных подключений PowerShell требуется обычная проверка подлинности WinRM, а удаленные командлеты PowerShell недоступны, если обычная проверка подлинности отключена в WinRM.
• Параметр identity для командлетов версии 2 теперь поддерживает имя и псевдоним. Использование псевдонима или имени замедляет производительность командлетов версии 2, поэтому мы не рекомендуем их использовать.
• Устранена проблема, из-за которой тип данных атрибутов, возвращаемых командлетом V2, отличался от тех, что возвращались командлетами PowerShell. У нас по-прежнему есть несколько атрибутов с разными типами данных, и мы планируем обрабатывать их в ближайшие месяцы.
• Исправлена ошибка: частые проблемы с повторным подключением сеансов при вызове Connect-ExchangeOnline с помощью Credentials или UserPrincipalName

Версия 0.3555.1

• Исправлена ошибка, из-за которой переданные командлеты не работали из-за проблемы с проверкой подлинности:

  Не удается вызвать конвейер, так как пространство выполнения не в состоянии "Открыто". Текущее состояние пространства выполнения — "закрыто".

Версия 0.3527.4

• Обновлено содержимое Get-Help.
• Исправлена проблема в Get-Help, из-за которой параметр Online перенаправлялся на несуществующую страницу с кодом ошибки 400.

Версия 0.3527.3

• Добавлена поддержка управления Exchange для другой организации с помощью потока делегирования.
• Работает в тандеме с другими модулями PowerShell в одном окне PowerShell.
• Добавлена поддержка позиционных параметров.
• Поле "Дата и время" теперь поддерживает языковой стандарт клиента.
• Устранена ошибка, из-за которой параметр PSCredential становился пустым при передаче во время Connect-ExchangeOnline.
• Устранена ошибка в модуле клиента, которая возникала, когда фильтр содержал $null.
• Теперь у сеансов, созданных внутри в модуле EXO V2, есть имена (формат имен: ExchangeOnlineInternalSession_%SomeNumber%).
• Исправление ошибки: удаленные командлеты PowerShell периодически завершаются сбоем из-за разницы между истечением срока действия маркера и бездействующим сеансом.
• Значительное обновление безопасности.
• Исправления ошибок и улучшения.