Outil de réinitialisation de mise à jour

S’applique à : Gestionnaire de Configuration (branche actuelle)

À compter de la version 1706, Configuration Manager sites principaux et les sites d’administration centrale incluent l’outil de réinitialisation de mise à jour Configuration Manager, CMUpdateReset.exe. Utilisez l’outil pour résoudre les problèmes de téléchargement ou de réplication des mises à jour dans la console. L’outil se trouve dans le dossier \cd.latest\SMSSETUP\TOOLS du serveur de site.

Vous pouvez utiliser cet outil avec n’importe quelle version de la branche actuelle qui reste prise en charge.

Utilisez cet outil lorsqu’une mise à jour dans la console n’est pas encore installée et qu’elle est en état d’échec. Un état d’échec signifie que le téléchargement de la mise à jour est en cours, mais qu’il est bloqué ou prend trop de temps. Un temps long est considéré comme étant plus long que vos attentes historiques pour les packages de mise à jour de taille similaire. Il peut également s’agir d’un échec de réplication de la mise à jour sur les sites principaux enfants.

Lorsque vous exécutez l’outil, il s’exécute sur la mise à jour que vous spécifiez. Par défaut, l’outil ne supprime pas correctement les mises à jour installées ou téléchargées.

Conditions préalables

Le compte que vous utilisez pour exécuter l’outil nécessite les autorisations suivantes :

• Autorisations de lecture et d’écriture sur la base de données du site d’administration centrale et sur chaque site principal de votre hiérarchie. Pour définir ces autorisations, vous pouvez ajouter le compte d’utilisateur en tant que membre du db_datawriter et db_datareaderdes rôles de base de données fixes sur la base de données Configuration Manager de chaque site. L’outil n’interagit pas avec les sites secondaires.
• Administrateur local sur le site de niveau supérieur de votre hiérarchie.
• Administrateur local sur l’ordinateur qui héberge le point de connexion de service.

Vous avez besoin du GUID du package de mise à jour que vous souhaitez réinitialiser. Pour obtenir le GUID :

1. Dans la console, accédez à Administration>Mises à jour et Maintenance.
2. Dans le volet d’affichage, cliquez avec le bouton droit sur l’en-tête de l’une des colonnes (par exemple, État), puis sélectionnez Guid du package pour ajouter cette colonne à l’affichage.
3. La colonne affiche maintenant le GUID du package de mise à jour.

Conseil

Pour copier le GUID, sélectionnez la ligne du package de mise à jour que vous souhaitez réinitialiser, puis utilisez CTRL+C pour copier cette ligne. Si vous collez votre sélection copiée dans un éditeur de texte, vous pouvez copier uniquement le GUID à utiliser comme paramètre de ligne de commande lorsque vous exécutez l’outil.

Exécuter l’outil

L’outil doit être exécuté sur le site de niveau supérieur de la hiérarchie.

Lorsque vous exécutez l’outil, utilisez les paramètres de ligne de commande pour spécifier :

• Le SQL Server sur le site de niveau supérieur de la hiérarchie.
• Nom de la base de données de site sur le site de niveau supérieur.
• GUID du package de mise à jour que vous souhaitez réinitialiser.

En fonction de l’état de la mise à jour, l’outil identifie les serveurs supplémentaires auxquels il doit accéder.

Si le package de mise à jour est dans un état post-téléchargement , l’outil ne nettoie pas le package. En guise d’option, vous pouvez forcer la suppression d’une mise à jour téléchargée avec succès à l’aide du paramètre force delete (voir paramètres de ligne de commande plus loin dans cette rubrique).

Après l’exécution de l’outil :

• Si un package a été supprimé, redémarrez le service SMS_Executive sur le site de niveau supérieur. Ensuite, recherchez les mises à jour pour pouvoir télécharger à nouveau le package.
• Si un package n’a pas été supprimé, vous n’avez pas besoin d’effectuer d’action. La mise à jour réinitialise, puis redémarre la réplication ou l’installation.

Paramètres de ligne de commande :

Paramètre	Description
-S <FQDN du SQL Server de votre site de niveau supérieur>	Obligatoire Spécifiez le nom de domaine complet du SQL Server qui héberge la base de données de site pour le site de niveau supérieur de votre hiérarchie.
-D <Nom de la base de données>	Obligatoire Spécifiez le nom de la base de données sur le site de niveau supérieur.
-P <Package GUID>	Obligatoire Spécifiez le GUID du package de mise à jour que vous souhaitez réinitialiser.
-Je <SQL Server nom de l’instance>	Optional Identifiez l’instance de SQL Server qui héberge la base de données du site.
-FDELETE	Optional Forcer la suppression d’un package de mise à jour téléchargé avec succès.

Exemples :
Dans un scénario classique, vous souhaitez réinitialiser une mise à jour qui rencontre des problèmes de téléchargement. Votre nom de domaine complet SQL Server est server1.fabrikam.com, la base de données du site est CM_XYZ et le GUID du package est 61F16B3C-F1F6-4F9F-8647-2A524B0C802C. Vous exécutez : CMUpdateReset.exe -S server1.fabrikam.com -D CM_XYZ -P 61F16B3C-F1F6-4F9F-8647-2A524B0C802C

Dans un scénario plus extrême, vous souhaitez forcer la suppression du package de mise à jour problématique. Votre nom de domaine complet SQL Server est server1.fabrikam.com, la base de données du site est CM_XYZ et le GUID du package est 61F16B3C-F1F6-4F9F-8647-2A524B0C802C. Vous exécutez : CMUpdateReset.exe -FDELETE -S server1.fabrikam.com -D CM_XYZ -P 61F16B3C-F1F6-4F9F-8647-2A524B0C802C