Utiliser Update-ExchangeHelp pour mettre à jour des rubriques d’aide Exchange PowerShell sur les serveurs Exchange

Exchange 2016
 

S’applique à :Exchange Server 2016

Dernière rubrique modifiée :2016-12-20

Découvrez comment mettre à jour les rubriques de référence de cmdlets Exchange qui sont disponibles dans l’Environnement de ligne de commande Exchange Management Shell à l’aide de la cmdlet Update-ExchangeHelp dans Exchange 2016.

Des rubriques de référence de cmdlets Exchange sont créées et mises à jour en permanence. S’il est facile de publier des rubriques nouvelles et mises à jour sur TechNet, il était plus compliqué de les transcrire en code Exchange de façon rapide afin qu’elles soient disponibles dans l’Environnement de ligne de commande Exchange Management Shell. Vous pouvez à présent utiliser la cmdlet Update-ExchangeHelp dans l’Environnement de ligne de commande Exchange Management Shell pour obtenir les rubriques de référence de cmdlets les plus à jour pour la ligne de commande d’Exchange 2016.

La cmdlet Update-ExchangeHelp se connecte automatiquement à un site web prédéfini, compare la version du serveur Exchange local et les langues installées à celles disponibles dans les packages de mise à jour, puis télécharge et installe l’aide Environnement de ligne de commande Exchange Management Shell mise à jour. En règle générale, la cmdlet se connecte à Internet, mais vous pouvez le configurer pour qu’elle se connecte à une source appartenant à l’Intranet de votre organisation.

Contenu de cette rubrique

Utiliser Update-ExchangeHelp sur un seul serveur Exchange connecté à Internet

Configurer Update-ExchangeHelp pour obtenir des mises à jour à partir d’un serveur web interne

Informations sur la commande Update-ExchangeHelp

  • Durée d’exécution estimée :

    • Utiliser Update-ExchangeHelp sur un seul serveur Exchange connecté à Internet : moins de 5 minutes.

    • Configurer Update-ExchangeHelp pour obtenir des mises à jour à partir d’un serveur web interne : 30 minutes.

  • Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette procédure. Pour voir les autorisations qui vous sont nécessaires, consultez Entrée « Paramètres de configuration du serveur Exchange » dans la rubrique Infrastructure Exchange et des autorisations de PowerShell.

  • Vous pouvez uniquement utiliser PowerShell pour effectuer cette procédure.Pour en savoir plus sur l’ouverture de l’environnement de ligne de commande Exchange Management Shell dans votre organisation Exchange locale, consultez la rubrique Ouverture de l’environnement de ligne de commande Exchange Management Shell.

  • Pour des informations sur les raccourcis clavier applicables aux procédures de cette rubrique, voir Raccourcis clavier dans Exchange 2013Raccourcis clavier dans le Centre d’administration Exchange.

tipConseil :
Vous rencontrez des difficultés ? Demandez de l’aide en participant aux forums Exchange. Visitez le forum à l’adresse : Exchange Server, Exchange Online ou Exchange Online Protection.

Cette méthode requiert que le serveur Exchange 2016 dispose d’un accès direct à Internet.

Exécutez la commande suivante dans l’Environnement de ligne de commande Exchange Management Shell :

Update-ExchangeHelp -Verbose

Remarques :

  • Le commutateur Verbose est important car il fournit des informations utiles. Par exemple, il vous indique si la dernière version de l’aide est déjà installée sur votre serveur Exchange ou si vous avez exécuté la commande au cours des 24 dernières heures.

  • Si vous souhaitez vérifier de nouveau si des mises à jour sont disponibles depuis 24 heures, utilisez le commutateur Force.

Retour au début

Dans certaines organisations, les serveurs internes n’ont pas accès à Internet. Si vos serveurs Exchange 2016 internes n’ont pas accès à Internet, vous pouvez configurer la cmdlet Update-ExchangeHelp pour qu’elle pointe vers un serveur web interne afin d’obtenir des mises à jour. Pour ce faire, procédez comme suit :

  1. Téléchargez et examinez le fichier manifeste ExchangeHelpInfo.xml.

  2. Téléchargez les packages de mise à jour, publiez-les sur un serveur web interne et personnalisez le fichier manifeste ExchangeHelpInfo.xml.

  3. Publiez le fichier manifeste ExchangeHelpInfo.xml personnalisé sur un serveur web interne.

  4. Modifiez le registre des serveurs Exchange pour qu’il pointe vers le fichier manifeste ExchangeHelpInfo.xml personnalisé.

  5. Utilisation et maintenance de Update-ExchangeHelp.

Retour au début

Sur un ordinateur disposant d’un accès à Internet, ouvrez https://go.microsoft.com/fwlink/p/?LinkId=287244, enregistrez le fichier manifeste ExchangeHelpInfo.xml dans un emplacement facile à mémoriser et ouvrez le fichier dans le Bloc-notes.

Chaque package de mise à jour disponible est défini dans une section <HelpVersion> et chaque section <HelpVersion> contient les clés suivantes.

  • <Version>   Cette clé indique la version d’Exchange à laquelle le package de mise à jour s’applique. 15.01.xxxx.xxx correspond à Exchange 2016. 15.00.xxxx.xxx correspond à Exchange 2013. En règle générale, cette clé définit une plage de versions.

  • <CulturesUpdated>   Cette clé indique la langue à laquelle le package de mise à jour s’applique. Cette clé peut spécifier une ou plusieurs langues.

  • <Revision>   Cette clé identifie l’ordre dans lequel les packages de mise à jour ont été publiés pour la version majeure d’Exchange. En d’autres termes, le premier package de mise à jour publié pour Exchange 2016 est 001, le deuxième est 002, etc. Il n’existe aucune relation entre les packages de mise à jour et l’ordre dans lequel ils ont été publiés. Par exemple, 001 peut être une mise à jour concernant uniquement l’anglais, 002 une mise à jour concernant toutes les autres langues prises en charge et 003 une mise à jour concernant uniquement l’allemand.

  • <CabinetUrl>   Cette clé identifie le nom et l’emplacement du package de mise à jour pour la section <HelpVersion>.

Le package de mise à jour défini dans une section <HelpVersion> s’applique à un serveur Exchange déterminé à l’aide de la combinaison des valeurs <Version> et <CulturesUpdated>.

Il se peut que vous constatiez que plusieurs sections <HelpVersion> s’appliquent à vos serveurs Exchange pour une version donnée d’Exchange. Par exemple, il se peut que plusieurs mises à jour s’appliquent à une même langue, ou que des mises à jour distinctes s’appliquent à différentes langues et que toutes s’appliquent à vos serveurs Exchange parce que plusieurs langues y sont installées. Quel que soit le cas, vous avez uniquement besoin de la mise à jour la plus récente pour la version et la langue de votre serveur Exchange, laquelle est déterminée par la clé <Revision>.

Par exemple, supposons que vos serveurs Exchange exécutent la version 15.01.0225.040 d’Exchange 2016, que l’anglais et l’espagnol soient installés, et que le fichier manifeste ExchangeHelpInfo.xml ait l’aspect suivant :

<?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>http://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>http://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>http://download.microsoft.com/download/8/7/0/870FC9AB-6D22-4478-BFBF-66CE775BCD18/ExchangePS_Update_En2.cab</CabinetUrl>
    </HelpVersion>
  </HelpVersions>
</ExchangeHelpInfo>

Dans cet exemple, toutes les mises à jour s’appliquent à vous si l’on tient compte de la version d’Exchange. Toutefois, vous n’avez besoin que de la révision 003 pour l’anglais et de la révision 002 pour l’espagnol. Vous n’avez pas besoin de la révision 001 pour l’anglais car la révision 003 est plus récente.

Retour au début

La méthode la plus simple et la plus rapide peut être de télécharger chaque package de mise à jour disponible qui est défini dans le fichier manifeste ExchangeHelpInfo.xml. Les avantages de cette méthode sont les suivants :

  • Aucune analyse nécessaire   Il est peu probable que vous fassiez une erreur et que vous manquiez accidentellement une mise à jour qui vous concerne, puisque vous téléchargez tous les packages de mise à jour disponibles. Dans la mesure où la cmdlet Update-ExchangeHelp ignore les packages de mise à jour qui ne s’appliquent pas au serveur Exchange, il n’est pas grave de télécharger des mises à jour qui ne sont pas nécessaires.

  • Maintenance plus facile   Lorsqu’un nouveau package de mise à jour est disponible, vous n’avez pas besoin de perdre du temps à déterminer s’il s’applique à vous. Il vous suffit simplement de télécharger et de personnaliser le nouveau fichier manifeste ExchangeHelpInfo.xml, puis de télécharger le nouveau fichier CAB qui y est défini.

Pour télécharger tous les packages de mise à jour, procédez comme suit.

  1. Téléchargez tous les fichiers CAB qui sont définis dans le fichier manifeste ExchangeHelpInfo.xml en utilisant les valeurs <CabinetUrl>. Enregistrez les fichiers dans un emplacement facile à mémoriser.

  2. Publiez les fichiers .cab sur un serveur web interne (par exemple http://intranet.contoso.com/downloads/exchange).

  3. Modifiez les valeurs d’URL des clés <CabinetUrl> afin qu’elles pointent vers le serveur web interne où vous avez publié les fichiers .cab.

    Par exemple, remplacez la valeur http://download.microsoft.com/download/8/7/0/870FC9AB-6D22-4478-BFBF-66CE775BCD18/ExchangePS_Update_En.cab par la valeur http://intranet.contoso.com/downloads/exchange/ExchangePS_Update_En.cab.

  4. Enregistrez le fichier manifeste ExchangeHelpInfo.xml personnalisé.

L’inconvénient de cette méthode est que vous téléchargez plus de fichiers .cab que vous n’en avez réellement besoin et que les fichiers .cab inutiles consomment de l’espace sur votre serveur web interne.

Si vous voulez déterminer les packages de mise à jour qui s’appliquent à vos serveurs, procédez comme suit.

  1. Rechercher les détails de la version de vos serveurs Exchange.

    Pour trouver les détails sur la version d’un seul serveur Exchange, exécutez la commande suivante :

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

    Pour rechercher tous les détails sur la version de tous les serveurs Exchange de votre organisation, exécutez la commande suivante :

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

    Le résultat pour ProductVersion sera au format 15.01.0225.xxx.

  2. Recherchez les sections <HelpVersion> du fichier manifeste ExchangeHelpInfo.xml qui s’appliquent à vos serveurs Exchange, comme indiqué par la valeur des clés <Version>, <CulturesUpdated> et <Revision>. La marche à suivre est décrite à l’étape 1.

Après avoir identifié les packages de mise à jour qui vous concernent, procédez comme suit :

  1. Téléchargez les fichiers .cab applicables en vous aidant des valeurs <CabinetUrl>. Enregistrez les fichiers dans un emplacement facile à mémoriser.

  2. Publiez les fichiers .cab sur un serveur web interne (par exemple http://intranet.contoso.com/downloads/exchange).

  3. Modifiez les valeurs d’URL des clés <CabinetUrl> afin qu’elles pointent vers le serveur web interne où vous avez publié les fichiers .cab.

    Par exemple, remplacez la valeur http://download.microsoft.com/download/8/7/0/870FC9AB-6D22-4478-BFBF-66CE775BCD18/ExchangePS_Update_En.cab par la valeur http://intranet.contoso.com/downloads/exchange/ExchangePS_Update_En.cab.

  4. Si vous le souhaitez, vous pouvez supprimer les sections <HelpInfo> qui ne vous concernent pas.

  5. Enregistrez le fichier manifeste ExchangeHelpInfo.xml personnalisé.

Retour au début

Publiez le fichier manifeste ExchangeHelpInfo.xml personnalisé à l’étape 2 sur un serveur web interne accessible à vos serveurs Exchange internes. Par exemple, http://intranet.contoso.com/downloads/exchange/ExchangeHelpInfo.xml. Vous devrez utiliser la valeur d’URL de cet emplacement à l’étape 4.

Notez qu’il n’existe aucune relation entre le fichier manifeste ExchangeHelpInfo.xml et l’emplacement des fichiers .cab. Vous pouvez les mettre à disposition sur la même URL ou sur des serveurs différents.

Retour au début

Vous devez utiliser l’emplacement de téléchargement du fichier manifeste ExchangeHelpInfo.xml personnalisé que vous avez configuré à l’étape 3. Cet exemple utilise la valeur http://intranet.contoso.com/downloads/exchange/ExchangeHelpInfo.xml.

  1. Copiez et collez le texte suivant dans le Bloc-notes, personnalisez l’URL pour qu’elle corresponde à votre environnement et enregistrez le fichier sous le nom UpdateExchangeHelp.reg dans un emplacement facile à mémoriser.

    Windows Registry Editor Version 5.00
    
    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ExchangeServer\v15\UpdateExchangeHelp]
    "ManifestUrl"="http://intranet.contoso.com/downloads/exchange/ExchangeHelpInfo.xml"
    
  2. Exécutez le fichier UpdateExchangeHelp.reg sur vos serveurs Exchange internes.

Retour au début

À présent, lorsque vous exécutez Update-ExchangeHelp dans l’Environnement de ligne de commande Exchange Management Shell sur vos serveurs Exchange internes, la commande obtient des informations sur les téléchargements et télécharge des fichiers à partir des emplacements internes que vous avez spécifiés.

Cela dit, l’intérêt de cette configuration personnalisée réside dans sa maintenance à long terme. En bref, vous devez répéter les étapes 1 à  3 lorsque vous voyez qu’une nouvelle mise à jour est disponible pour l’aide concernant les références de cmdlets Exchange et que vous souhaitez la déployer sur vos serveurs Exchange.

Un moyen simple de trouver de nouveaux packages de mise à jour consiste à exécuter régulièrement Update-ExchangeHelp sur un serveur Exchange connecté à Internet ou sur un ordinateur sur lequel les outils de gestion Exchange sont installés.

Retour au début

Windows PowerShell est doté des cmdlets Update-Help et Save-Help pour la mise à jour en ligne et hors ligne des rubriques de référence des cmdlets. Toutefois, ces cmdlets ne prennent pas en charge l’aide Exchange concernant les cmdlets et vous devez donc utiliser une cmdlet Exchange spécifique pour mettre à jour les rubriques de référence dans l’Environnement de ligne de commande Exchange Management Shell.

Retour au début

 
Afficher: