Usar Update-ExchangeHelp para atualizar tópicos de ajuda do Exchange PowerShell em servidores Exchange

Os tópicos de referência do cmdlet do Exchange são criados e atualizados o tempo todo, mas é difícil obter essas atualizações para o código do Exchange de forma oportuna, para que estejam disponíveis no Shell de gerenciamento do Exchange. Agora, você pode usar o cmdlet Update-ExchangeHelp no Shell de gerenciamento do Exchange para obter os tópicos de referência de cmdlet mais atualizados para a linha de comando no Exchange 2013 ou posterior.

O cmdlet Update-ExchangeHelp se conecta automaticamente a um site predefinido, compara a versão do servidor Exchange local e os idiomas instalados com o que está disponível nos pacotes de atualização e, em seguida, baixa e instalou a ajuda atualizada do Shell de gerenciamento do Exchange. Normalmente, o cmdlet se conecta à Internet, mas você pode configurá-lo para se conectar a uma fonte de intranet dentro da sua organização.

O que você precisa saber antes de começar?

  • Tempo estimado para conclusão:

    • Use Update-ExchangeHelp em um único servidor Exchange conectado à Internet: menos de cinco minutos.

    • Configure Update-ExchangeHelp para obter atualizações de um servidor Web interno: 30 minutos.

  • Entrada "Definições de configuração do servidor Exchange" de Para executar este procedimento ou estes procedimentos, você precisa receber permissões. Para ver de que permissões você precisa, consulte o entrada "definições de configuração do servidor do Exchange" no tópico Exchange Infrastructure and PowerShell Permissions .

  • Somente o PowerShell pode ser usado para executar este procedimento.Para saber como abrir o Shell de Gerenciamento do Exchange em sua organização do Exchange local, confira Abra o Shell de Gerenciamento do Exchange.

Tip

Está com problemas? Peça ajuda nos fóruns do Exchange Server .

Use Update-ExchangeHelp em um único servidor Exchange conectado à Internet

Este método requer que o servidor Exchange tenha acesso direto à Internet.

Execute o seguinte comando no Shell de Gerenciamento do Exchange:

Update-ExchangeHelp -Verbose

Observações:

  • A opção detalhada é importante porque fornece informações úteis. Por exemplo, ela indica se o servidor Exchange já tem a versão mais recente da ajuda instalada ou se você já executou o comando nas últimas 24 horas.

  • Se quiser verificar as atualizações novamente dentro de 24 horas, use a opção Force .

Configure Update-ExchangeHelp para obter atualizações de um servidor Web interno

Em algumas organizações, os servidores internos não têm acesso à Internet. Se seus servidores do Exchange internos não tiverem acesso à Internet, você poderá configurar o Update-ExchangeHelp para apontar para um servidor Web interno para obter atualizações. As etapas são as seguintes:

  1. Baixe e inspecione o arquivo de manifesto ExchangeHelpInfo.xml.

  2. Baixe os pacotes de atualização, publique os pacotes de atualização em um servidor Web interno e personalize o arquivo de manifesto ExchangeHelpInfo.xml.

  3. Publique o arquivo de manifesto ExchangeHelpInfo.xml personalizado em um servidor Web interno.

  4. Modifique o Registro dos servidores Exchange para apontar para o arquivo de manifesto ExchangeHelpInfo.xml personalizado.

  5. Uso e manutenção de Update-ExchangeHelp.

Etapa 1. Baixe e inspecione o arquivo de manifesto ExchangeHelpInfo.xml

Em um computador com acesso à Internet, abra https://go.microsoft.com/fwlink/p/?LinkId=287244 , salve o arquivo de manifesto ExchangeHelpInfo.xml em um local que seja fácil de lembrar e abra o arquivo no bloco de notas.

Cada pacote de atualização disponível é definido em uma <HelpVersion> seção e cada <HelpVersion> seção contém as seguintes chaves.

  • <Version>: Essa chave identifica a versão do Exchange à qual o pacote de atualização se aplica. 15.01.xxxx.xxx é o Exchange 2016. 15.00.xxxx.xxx é o Exchange 2013. Normalmente, essa chave especifica um intervalo de versões.

  • <CulturesUpdated>: Essa chave identifica o idioma ao qual o pacote de atualização se aplica. Essa chave pode especificar somente um idioma ou vários idiomas.

  • <Revision>: Essa chave identifica a ordem em que os pacotes atualizados foram liberados para a versão principal do Exchange. Em outras palavras, o primeiro pacote de atualização lançado para o Exchange 2016 é 001 , o segundo é 002 , etc. E não há relação entre os pacotes de atualização e a ordem em que foram lançados. Por exemplo, 001 pode ser apenas uma atualização em inglês, 002 pode ser uma atualização para todos os outros idiomas com suporte e 003 pode ser uma atualização somente em alemão.

  • <CabinetUrl>: Essa chave identifica o nome e o local do pacote de atualização para a <HelpVersion> seção.

O pacote de atualização definido em uma <HelpVersion> seção se aplica a um servidor do Exchange com base na combinação de <Version> e <CulturesUpdated> valores.

Você pode achar que várias <HelpVersion> seções se aplicam aos seus servidores do Exchange para uma determinada versão do Exchange. Por exemplo, pode haver várias atualizações para o mesmo idioma ou atualizações separadas para idiomas diferentes que se aplicam aos servidores Exchange porque você tem vários idiomas instalados. De qualquer forma, você precisa apenas da atualização mais recente para sua versão e idioma do Exchange Server com base na <Revision> chave.

Por exemplo, suponha que seus servidores do Exchange estejam executando a versão 2016 do Exchange 15.01.0225.040 com inglês e espanhol instalados e o arquivo de manifesto ExchangeHelpInfo.xml tenha a seguinte aparência:

<?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>

Nesse exemplo, todas as atualizações se aplicam a você, com base na versão do Exchange. No entanto, você precisa apenas 003 de revisão para o inglês e revisão 002 para espanhol. Você não precisa de revisão 001 para inglês porque a revisão 003 é mais recente.

Etapa 2. Baixe os pacotes de atualização, publique os pacotes de atualização em um servidor Web interno e personalize o arquivo de manifesto ExchangeHelpInfo.xml.

A abordagem mais fácil e menos demorada pode ser baixar todos os pacotes de atualização disponíveis definidos no arquivo de manifesto ExchangeHelpInfo.xml. Os benefícios dessa abordagem são:

  • Sem necessidade de análise: é difícil cometer um erro e perder acidentalmente uma atualização que se aplica a você, porque você está baixando cada pacote de atualização disponível. O cmdlet Update-ExchangeHelp ignora os pacotes de atualização que não se aplicam ao servidor Exchange, portanto, não é possível baixar pacotes de atualização desnecessários.

  • Manutenção mais fácil: sempre que um novo pacote de atualização é lançado, não é preciso gastar tempo determinando se o pacote de atualização se aplica a você. Basta baixar e personalizar o novo arquivo de manifesto ExchangeHelpInfo.xml e baixar o novo arquivo de gabinete (.cab) definido nele.

Para baixar todos os pacotes de atualização, siga estas etapas:

  1. Baixe todos os arquivos. cab que são definidos no arquivo de manifesto ExchangeHelpInfo.xml usando os <CabinetUrl> valores. Salve os arquivos em um local que seja fácil de lembrar.

  2. Publicar os arquivos. cab em um servidor Web interno (por exemplo https://intranet.contoso.com/downloads/exchange ).

  3. Modifique os valores de URL das <CabinetUrl> chaves para apontar para o servidor Web interno onde você publicou os arquivos. cab.

    Por exemplo, altere o valor https://download.microsoft.com/download/8/7/0/870FC9AB-6D22-4478-BFBF-66CE775BCD18/ExchangePS_Update_En.cab para https://intranet.contoso.com/downloads/exchange/ExchangePS_Update_En.cab .

  4. Salve o arquivo de manifesto ExchangeHelpInfo.xml personalizado.

A desvantagem dessa abordagem é que você baixa mais arquivos .cab do que realmente precisa, e os arquivos .cab desnecessários consomem espaço no servidor Web interno.

Para identificar somente os pacotes de atualização que se aplicam a você, siga estas etapas.

  1. Localize os detalhes de versão dos servidores Exchange.

    Para localizar os detalhes de versão em um único servidor Exchange, execute o seguinte comando:

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

    Para localizar os detalhes de versão de todos os servidores Exchange de sua organização, execute o seguinte comando:

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

    O resultado para ProductVersion estará no formato 15.01.0225.xxx.

  2. Encontre as <HelpVersion> seções no arquivo de manifesto ExchangeHelpInfo.xml que se aplicam aos seus servidores Exchange com base nos valores <Version> das <CulturesUpdated> teclas, e <Revision> . A metodologia foi descrita na Etapa 1.

Após identificar os pacotes de atualização que se aplicam a você, siga estas etapas:

  1. Baixe os arquivos. cab aplicáveis usando os <CabinetUrl> valores. Salve os arquivos em um local que seja fácil de lembrar.

  2. Publicar os arquivos. cab em um servidor Web interno (por exemplo https://intranet.contoso.com/downloads/exchange ).

  3. Modifique os valores de URL das <CabinetUrl> chaves para apontar para o servidor Web interno onde você publicou os arquivos. cab.

    Por exemplo, altere o valor https://download.microsoft.com/download/8/7/0/870FC9AB-6D22-4478-BFBF-66CE775BCD18/ExchangePS_Update_En.cab para https://intranet.contoso.com/downloads/exchange/ExchangePS_Update_En.cab .

  4. Opcionalmente, você pode excluir as <HelpInfo> seções que não se aplicam a você.

  5. Salve o arquivo de manifesto ExchangeHelpInfo.xml personalizado.

Etapa 3. Publique o arquivo de manifesto ExchangeHelpInfo.xml personalizado em um servidor Web interno

Publique o arquivo de manifesto ExchangeHelpInfo.xml personalizado da Etapa 2 em um servidor Web interno que seja acessível aos servidores internos do Exchange. Por exemplo, https://intranet.contoso.com/downloads/exchange/ExchangeHelpInfo.xml. Você usará o valor de URL dessa localização na Etapa 4.

Observe que não há relação entre o arquivo de manifesto ExchangeHelpInfo.xml e as localizações de arquivos .cab. Você pode disponibilizá-los na mesma URL ou em servidores diferentes.

Etapa 4. Modifique o Registro dos servidores Exchange para apontar para o arquivo de manifesto ExchangeHelpInfo.xml personalizado

Você precisa da localização de download do arquivo de manifesto ExchangeHelpInfo.xml personalizado que configurou na Etapa 3. Este exemplo usa o valor https://intranet.contoso.com/downloads/exchange/ExchangeHelpInfo.xml .

  1. Copie e cole o texto a seguir no Bloco de Notas, personalize a URL para seu ambiente e salve o arquivo como UpdateExchangeHelp.reg em um local que seja fácil de lembrar.

    Windows Registry Editor Version 5.00
    
    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ExchangeServer\v15\UpdateExchangeHelp]
    "ManifestUrl"="https://intranet.contoso.com/downloads/exchange/ExchangeHelpInfo.xml"
    
  2. Execute o arquivo UpdateExchangeHelp.reg nos servidores internos do Exchange.

Etapa 5. Uso e manutenção de Update-ExchangeHelp

Agora, quando você executar Update-ExchangeHelp no Shell de Gerenciamento do Exchange nos servidores internos do Exchange, o comando obterá informações de download e baixará arquivos das localizações internas especificadas.

O mais interessante é a manutenção de longo prazo dessa configuração personalizada. Basicamente, você precisará repetir as etapas 1 a 3 quando descobrir que uma atualização foi disponibilizada para a ajuda de referência do cmdlet do Exchange, e convém implantar essa ajuda atualizada para os servidores Exchange.

Uma maneira fácil de localizar novos pacotes de atualização é executar periodicamente Update-ExchangeHelp em um servidor Exchange conectado à Internet ou em um computador que tenha as ferramentas de gerenciamento do Exchange instaladas.

Detalhes sobre Update-ExchangeHelp

O Windows PowerShell tem os cmdlets Update-Help e Save-Help para atualizações online e offline de tópicos de referência de cmdlet. No entanto, esses cmdlets não dão suporte à ajuda de cmdlet do Exchange. Portanto, um cmdlet específico do Exchange é necessário para atualizar os tópicos de referência de cmdlet no Shell de Gerenciamento do Exchange.