Outil de nettoyage de bibliothèque de contenu

  • Article

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

Utilisez l’outil en ligne de commande de nettoyage de la bibliothèque de contenu pour supprimer le contenu qui n’est plus associé à un objet sur un point de distribution. Ce type de contenu est appelé contenu orphelin. Cet outil remplace les versions antérieures d’outils similaires publiés pour les produits Configuration Manager précédents.

L’outil affecte uniquement le contenu sur le point de distribution que vous spécifiez lors de l’exécution de l’outil. L’outil ne peut pas supprimer le contenu de la bibliothèque de contenu sur le serveur de site.

Si vous supprimez du contenu d’un point de distribution alors que le système de site est hors connexion, un enregistrement orphelin peut exister dans WMI. Au fil du temps, ce comportement peut éventuellement entraîner un état d’avertissement sur le point de distribution. Pour atténuer le problème dans les versions 2006 et antérieures, vous avez dû supprimer manuellement les entrées orphelines de WMI. Une erreur au cours de ce processus peut entraîner des problèmes plus graves avec le serveur. À compter de la version 2010, l’outil peut également supprimer les enregistrements de contenu orphelins du fournisseur WMI sur un point de distribution.

RecherchezContentLibraryCleanup.exe sur CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup le serveur de site. Pour plus d’informations sur cet emplacement, consultez Le dossier CD.Latest.

Configuration requise

  • Exécutez l’outil uniquement sur un seul point de distribution à la fois.

  • Exécutez-la directement sur le serveur qui héberge le point de distribution à nettoyer, ou à distance à partir d’un autre ordinateur.

  • L’outil ne prend pas en charge la suppression de contenu du serveur de site, qui dispose d’une seule bibliothèque de contenu. Lorsque le serveur de site a également le rôle de point de distribution, si un package n’est pas ciblé sur le serveur, le package se trouve toujours dans la bibliothèque de contenu unique.

  • L’outil ne prend pas en charge une passerelle de gestion cloud prenant en charge le contenu.

  • Le compte d’utilisateur qui exécute l’outil doit disposer des mêmes autorisations que le rôle de sécurité Administrateur complet dans Configuration Manager.

Modes de fonctionnement

Exécutez l’outil dans les deux modes suivants : What-if et Delete.

Conseil

Commencez par le mode what-if . Lorsque vous êtes satisfait des résultats, exécutez l’outil en mode suppression .

Mode what-if

Si vous ne spécifiez pas le /delete paramètre, l’outil s’exécute en mode scénario. Ce mode identifie le contenu qui serait supprimé du point de distribution.

  • Lorsqu’il est exécuté dans ce mode, l’outil ne supprime aucune donnée.

  • L’outil écrit dans le fichier journal des informations sur le contenu qu’il supprimerait. Vous n’êtes pas invité à confirmer chaque suppression potentielle.

Mode De suppression

Lorsque vous exécutez l’outil avec le /delete paramètre , l’outil s’exécute en mode suppression.

  • Lorsqu’il est exécuté dans ce mode, le contenu orphelin trouvé sur le point de distribution spécifié peut être supprimé de la bibliothèque de contenu du point de distribution.

  • À compter de la version 2010, il peut également supprimer les enregistrements de contenu orphelins du fournisseur WMI sur le point de distribution.

  • Avant de supprimer chaque fichier, vérifiez que l’outil doit le supprimer. Sélectionnez Y pour oui, N pour non ou Oui pour tout pour ignorer les autres invites et supprimer tout le contenu orphelin.

Fichier journal

Lorsque l’outil s’exécute dans l’un ou l’autre mode, il crée automatiquement un fichier journal. Il nomme le fichier avec les informations suivantes :

  • Mode dans lequel l’outil s’exécute
  • Nom du point de distribution
  • Date et heure de l’opération

Une fois l’outil terminé, il ouvre automatiquement le fichier journal dans Windows.

Par défaut, l’outil écrit le fichier journal dans le dossier temporaire du compte d’utilisateur qui exécute l’outil. Cet emplacement se trouve sur l’ordinateur sur lequel vous exécutez l’outil, qui n’est pas toujours la cible de l’outil. Utilisez le /log paramètre pour rediriger le fichier journal vers un autre emplacement, y compris un partage réseau.

Exécuter l’outil

Pour exécuter l’outil :

  1. Ouvrez une invite de commandes en tant qu’administrateur. Remplacez le répertoire par le dossier qui contient ContentLibraryCleanup.exe.

  2. Entrez une ligne de commande qui inclut les paramètres de ligne de commande requis et tous les paramètres facultatifs que vous souhaitez utiliser.

Paramètres de ligne de commande

Utilisez ces paramètres de ligne de commande dans n’importe quel ordre.

Paramètres requis

Paramètre Détails
/dp <distribution point FQDN> Spécifiez le nom de domaine complet (FQDN) du point de distribution à nettoyer.
/ps <primary site FQDN> Obligatoire uniquement lors du nettoyage du contenu à partir d’un point de distribution sur un site secondaire. L’outil se connecte au site principal parent pour exécuter des requêtes sur le fournisseur SMS. Ces requêtes permettent à l’outil de déterminer le contenu qui doit se trouver sur le point de distribution. Il peut ensuite identifier le contenu orphelin à supprimer. Cette connexion au site principal parent doit être établie pour les points de distribution d’un site secondaire, car les détails requis ne sont pas disponibles directement à partir du site secondaire.
/sc <primary site code> Obligatoire uniquement lors du nettoyage du contenu à partir d’un point de distribution sur un site secondaire. Spécifiez le code de site du site principal parent.

Exemple : Analyser et journaliser le contenu qu’il supprimerait (scénario)

ContentLibraryCleanup.exe /dp server1.contoso.com

Exemple : Analyser et journaliser le contenu d’un dp sur un site secondaire

ContentLibraryCleanup.exe /dp server1.contoso.com /ps siteserver1.contoso.com /sc ABC

Paramètres facultatifs

Paramètre Détails
/delete Utilisez ce paramètre lorsque vous êtes prêt à supprimer du contenu du point de distribution. Il vous invite avant de supprimer du contenu.

Lorsque vous n’utilisez pas ce paramètre, l’outil journalise les résultats sur le contenu qu’il supprimerait. Sans ce paramètre, il ne supprime pas réellement de contenu du point de distribution.
/q Ce paramètre exécute l’outil en mode silencieux qui supprime toutes les invites. Ces invites incluent le moment où il supprime du contenu. Il n’ouvre pas non plus automatiquement le fichier journal.
/ps <primary site FQDN> Facultatif uniquement lors du nettoyage du contenu d’un point de distribution sur un site principal. Spécifiez le nom de domaine complet du site principal auquel appartient le point de distribution.
/sc <primary site code> Facultatif uniquement lors du nettoyage du contenu d’un point de distribution sur un site principal. Spécifiez le code du site principal auquel appartient le point de distribution.
/log <log file directory> Spécifiez l’emplacement où l’outil écrit le fichier journal. Cet emplacement peut être un lecteur local ou un partage réseau.

Lorsque vous n’utilisez pas ce paramètre, l’outil place le fichier journal dans le répertoire temporaire de l’utilisateur sur l’ordinateur sur lequel l’outil s’exécute.

Exemple : Supprimer du contenu

ContentLibraryCleanup.exe /dp server1.contoso.com /delete

Exemple : Supprimer du contenu sans invite

ContentLibraryCleanup.exe /q /dp server1.contoso.com /delete

Exemple : Journaliser sur le lecteur local

ContentLibraryCleanup.exe /dp server1.contoso.com /log C:\Users\Administrator\Desktop

Exemple : Se connecter au partage réseau

ContentLibraryCleanup.exe /dp server1.contoso.com /log \\server\share

Problème connu

Dans les versions 2103 et antérieures, lorsqu’un package ou un déploiement a échoué ou est en cours, l’outil peut retourner l’erreur suivante :

System.InvalidOperationException: This content library cannot be cleaned up right now because package <packageID> is not fully installed.

Pour contourner ce problème, mettez à jour le site vers la version 2107. L’outil ne peut pas identifier de manière fiable les fichiers orphelins, mais affiche un avertissement et continue.