Используйте Update-ExchangeHelp для обновления статей справки Exchange PowerShell на серверах Exchange

Справочные статьи exchange создаются и обновляются постоянно, но получить эти обновления в код Exchange своевременно, чтобы они были доступны в оболочке управления Exchange, было сложно. Теперь вы можете использовать командлет Update-ExchangeHelp в командной оболочке Exchange, чтобы получить самые последние справочные статьи командлета для командной строки в Exchange 2013 или более поздней версии.

Командылет Update-ExchangeHelp автоматически подключается к предопределенным веб-сайту, сравнивает версию локального сервера Exchange и установленных языков с доступными в пакетах обновлений, а затем скачивает и устанавливается обновленная справка об управлении Exchange. Как правило, этот комлет подключается к Интернету, но его можно настроить для подключения к источнику интрасети внутри организации.

Что нужно знать перед началом работы?

  • Предполагаемое время для завершения:

    • Используйте Update-ExchangeHelp на одном подключенном к Интернету сервере Exchange: менее 5 минут.

    • Настройка командлета Update-ExchangeHelp для получения обновлений с внутреннего веб-сервера: 30 минут.

  • Для выполнения этой процедуры (процедур) необходимы соответствующие разрешения. Чтобы узнать о необходимых разрешениях, см. запись "Параметры конфигурации сервера Exchange" в статье Инфраструктура Exchange и разрешения PowerShell.

  • Для выполнения этой процедуры можно использовать только PowerShell. Сведения о том, как открыть командную консоль Exchange в локальной организации Exchange, см. в статье Open the Exchange Management Shell.

Совет

Возникли проблемы? Попросите о помощи на Exchange Server форумах.

Использование Update-ExchangeHelp на одном подключенном к Интернету сервере Exchange

Этот метод требует, чтобы сервер Exchange получил прямой доступ к Интернету.

Выполните следующую команду в Командная консоль Exchange:

Update-ExchangeHelp -Verbose

Примечания.

  • Переключатель Verbose имеет важное значение, так как он предоставляет полезную информацию. Например, он указывает, установлена ли на сервере Exchange последняя версия справки, либо выполняли ли вы команду за последние 24 часа.

  • Если в течение 24 часов необходимо повторно проверить обновления, используйте переключатель Force.

Настройка командлета Update-ExchangeHelp для получения обновлений с внутреннего веб-сервера

В некоторых организациях внутренние серверы не имеют доступа к Интернету. Если на внутренних серверах Exchange нет доступа к Интернету, можно настроить Update-ExchangeHelp, чтобы указать на внутренний веб-сервер для получения обновлений. Этапы настройки описаны ниже.

  1. Скачайте и проверьте файл манифеста ExchangeHelpInfo.xml.

  2. Скачайте пакеты обновления, опубликуйте их на внутреннем веб-сервере и настройте файл манифеста ExchangeHelpInfo.xml.

  3. Опубликуйте настроенный файл манифеста ExchangeHelpInfo.xml на внутреннем веб-сервере.

  4. Измените реестр серверов Exchange таким образом, чтобы он указывал на настроенный файл манифеста ExchangeHelpInfo.xml.

  5. Использование и обновление командлета Update-ExchangeHelp.

Шаг 1. Скачивание и проверка файла манифеста ExchangeHelpInfo.xml.

На компьютере, который имеет доступ к Интернету, откройте, сохраните файл манифеста ExchangeHelpInfo.xml в удобном для запоминаемом расположении и откройте файл в https://go.microsoft.com/fwlink/p/?LinkId=287244 Блокноте.

Каждый доступный пакет обновлений определяется в разделе, и каждый <HelpVersion> <HelpVersion> раздел содержит следующие клавиши.

  • <Version>. Этот ключ определяет версию Exchange, к которую применяется пакет обновлений. 15.01.xxxx.xxx является Exchange 2016. 15.00.xxxx.xxx Exchange 2013. Обычно этот ключ указывает целый ряд версий.

  • <CulturesUpdated>. Этот ключ определяет язык, на который применяется пакет обновлений. Этот ключ может указывать как один, так и несколько языков.

  • <Revision>: Этот ключ определяет порядок выпуска обновленных пакетов для основной версии Exchange. Другими словами, первый пакет обновлений, выпущенный для Exchange 2016, — второй — 001 002 и т.д. Кроме того, между пакетами обновлений и порядком, в который они были выпущены, отношения нет. Например, может быть только обновление на английском языке, может быть обновлением для всех других поддерживаемых языков и может быть обновлением только 001 002 на 003 немецком языке.

  • <CabinetUrl>. Этот ключ определяет имя и расположение пакета обновления для <HelpVersion> раздела.

Пакет обновлений, определенный в разделе, применяется к серверу Exchange на основе сочетания <HelpVersion> <Version> <CulturesUpdated> значений и значений.

Вы можете обнаружить, что несколько <HelpVersion> разделов применяются к вашим серверам Exchange для данной версии Exchange. Например, могут присутствовать несколько обновлений для одного языка или отдельные обновления для разных языков, применимые к вашим серверам Exchange, так как вы установили несколько языков. В любом случае для версии сервера Exchange и языка на основе ключа требуется только самое последнее <Revision> обновление.

Например, предположим, что на серверах Exchange запущена версия Exchange 2016 с установленными на английском и испанском языках, а файл манифеста ExchangeHelpInfo.xml выглядит 15.01.0225.040 так:

<?xml version="1.0" encoding="utf-8"?>
<ExchangeHelpInfo>
  <HelpVersions>
    <HelpVersion>
      <Version>15.01.0225.030-15.01.0225.050</Version>
       <Revision>001</Revision>
      <CulturesUpdated>en</CulturesUpdated>
      <CabinetUrl>https://download.microsoft.com/download/8/7/0/870FC9AB-6D22-4478-BFBF-66CE775BCD18/ExchangePS_Update_En.cab</CabinetUrl>
    </HelpVersion>
    <HelpVersion>
      <Version>15.01.0225.030-15.01.0225.050</Version>
      <Revision>002</Revision>
      <CulturesUpdated>de, es, fr, it, ja, ko, pt, pu, ru, zh-HanS, zh-HanT</CulturesUpdated>
      <CabinetUrl>https://download.microsoft.com/download/8/7/0/870FC9AB-6D22-4478-BFBF-66CE775BCD18/ExchangePS_Update_Loc.cab</CabinetUrl>
    </HelpVersion>
    <HelpVersion>
      <Version>15.01.0225.030-15.01.0225.050</Version>
       <Revision>003</Revision>
      <CulturesUpdated>en</CulturesUpdated>
      <CabinetUrl>https://download.microsoft.com/download/8/7/0/870FC9AB-6D22-4478-BFBF-66CE775BCD18/ExchangePS_Update_En2.cab</CabinetUrl>
    </HelpVersion>
  </HelpVersions>
</ExchangeHelpInfo>

В этом примере все обновления применимы к вашим серверам на основании версии Exchange. Однако для английского языка требуется только 003 изменение, а для 002 испанского — пересмотр. Вам не нужна версия 001 для английского языка, поскольку версия 003 новее.

Шаг 2. Загрузка пакетов обновления, их публикация на внутреннем веб-сервере и настройка файла манифеста ExchangeHelpInfo.xml

Возможно, проще и быстрее всего скачать все доступные пакеты обновления, определенные в файле манифеста ExchangeHelpInfo.xml. Ниже указаны преимущества такого подхода.

  • Нет необходимости в анализе. Трудно сделать ошибку и случайно пропустить обновление, которое применяется к вам, так как вы скачиваете все доступные пакеты обновлений. В комлете Update-ExchangeHelp игнорируются пакеты обновлений, которые не применяются к серверу Exchange, поэтому не помешает скачивать нежелательные пакеты обновлений.

  • Более простое обслуживание. Всякий раз, когда будет выпущен новый пакет обновлений, вам не нужно тратить время на определение того, применяется ли к вам пакет обновлений. Вам нужно лишь скачать и настроить новый файл манифеста ExchangeHelpInfo.xml, а также скачать новый определенный в нем CAB-файл (.cab).

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

  1. Скачайте все файлы .cab, определенные в файле манифеста ExchangeHelpInfo.xml с помощью <CabinetUrl> значений. Сохраните файлы в расположении, путь к которому легко запомнить.

  2. Публикация файлов .cab на внутреннем веб-сервере https://intranet.contoso.com/downloads/exchange (например).

  3. Измените значения URL-адресов ключей, чтобы указать на внутренний веб-сервер, на котором были опубликованы <CabinetUrl> файлы .cab.

    Например, измените значение https://download.microsoft.com/download/8/7/0/870FC9AB-6D22-4478-BFBF-66CE775BCD18/ExchangePS_Update_En.cab https://intranet.contoso.com/downloads/exchange/ExchangePS_Update_En.cab на .

  4. Сохраните настроенный файл манифеста ExchangeHelpInfo.xml.

Недостаток этого подхода в том, что вы скачиваете больше CAB-файлов, чем нужно, и ненужные CAB-файлы занимают место на внутреннем веб-сервере.

Если вам требуется идентифицировать только применимые к вашим серверам пакеты обновления, сделайте следующее.

  1. Найдите сведения о версии для ваших серверов Exchange.

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

    Get-Command Exsetup.exe | ForEach {$_.FileVersionInfo}
    

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

    Get-ExchangeServer | Sort-Object Name | ForEach {Invoke-Command -ComputerName $_.Name -ScriptBlock {Get-Command ExSetup.exe | ForEach{$_.FileVersionInfo}}} | Format-Table -Auto
    

    Результат для ProductVersion будет представлен в формате 15.01.0225.xxx.

  2. Найдите разделы в файле манифеста ExchangeHelpInfo.xml, которые применяются к серверам Exchange на основе значений <HelpVersion> <Version> , и <CulturesUpdated> <Revision> ключей. Методология описана в шаге 1.

Определив применимые к вашим серверам пакеты обновления, выполните следующие действия:

  1. Скачайте применимые файлы .cab с помощью <CabinetUrl> значений. Сохраните файлы в расположении, путь к которому легко запомнить.

  2. Публикация файлов .cab на внутреннем веб-сервере https://intranet.contoso.com/downloads/exchange (например).

  3. Измените значения URL-адресов ключей, чтобы указать на внутренний веб-сервер, на котором были опубликованы <CabinetUrl> файлы .cab.

    Например, измените значение https://download.microsoft.com/download/8/7/0/870FC9AB-6D22-4478-BFBF-66CE775BCD18/ExchangePS_Update_En.cab https://intranet.contoso.com/downloads/exchange/ExchangePS_Update_En.cab на .

  4. Дополнительно можно удалить разделы, которые не <HelpInfo> применяются к вам.

  5. Сохраните настроенный файл манифеста ExchangeHelpInfo.xml.

Шаг 3. Публикация настроенного файла манифеста ExchangeHelpInfo.xml на внутреннем веб-сервере

Опубликуйте настроенный файл манифеста ExchangeHelpInfo.xml из шага 2 на внутреннем веб-сервере, доступном для внутренних серверов Exchange. Например, https://intranet.contoso.com/downloads/exchange/ExchangeHelpInfo.xml. Значение URL-адреса этого расположения потребуется вам в шаге 4.

Обратите внимание, что между расположениями файла манифеста ExchangeHelpInfo.xml и CAB-файлов связи нет. Они могут находиться по одному URL-адресу или на разных серверах.

Шаг 4. Изменение реестра серверов Exchange таким образом, чтобы он указывал на настроенный файл манифеста ExchangeHelpInfo.xml

Вам потребуется расположение загрузки файла манифеста ExchangeHelpInfo.xml, настроенного в шаге 3. В этом примере используется значение https://intranet.contoso.com/downloads/exchange/ExchangeHelpInfo.xml .

  1. Скопируйте и вставьте следующий текст в Блокнот, настройте URL-адрес под вашу среду и сохраните файл с именем UpdateExchangeHelp.reg в расположении, путь к которому легко запомнить.

    Windows Registry Editor Version 5.00
    
    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ExchangeServer\v15\UpdateExchangeHelp]
    "ManifestUrl"="https://intranet.contoso.com/downloads/exchange/ExchangeHelpInfo.xml"
    
  2. Запустите файл UpdateExchangeHelp.reg на внутренних серверах Exchange.

Шаг 5. Использование и обновление командлета Update-ExchangeHelp

Теперь, после запуска командлета Update-ExchangeHelp в Командная консоль Exchange на внутренних серверах Exchange, команда получает сведения о загрузке и скачивает файлы из указанных вами внутренних расположений.

Больший интерес представляет долгосрочное обслуживание этой настроенной конфигурации. В целом, когда вы обнаружите обновление, выпущенное для разделов справки о командлетах Exchange, и соберетесь развернуть обновленную версию справки на серверах Exchange, вам потребуется повторить шаги с 1 по 3.

Простой способ поиска новых пакетов обновлений — периодически запускать Update-ExchangeHelp на подключенном к Интернету сервере Exchange или компьютере с установленными средствами управления Exchange.

Подробнее о командлете Update-ExchangeHelp

Windows PowerShell для сетевых и автономных обновлений справочных статей для update-help и Save-Help. Однако эти команды не поддерживают справку о комлете Exchange, поэтому для обновления ссылок на статьи в руководстве Exchange требуется определенный комдлет Exchange.