Outil de nettoyage de la bibliothèque de contenuContent library cleanup tool

S’applique à : Configuration Manager (Current Branch)Applies to: Configuration Manager (current branch)

Utilisez l’outil en ligne de commande de nettoyage de la bibliothèque de contenu pour supprimer du contenu qui n’est plus associé à aucun package ou application sur un point de distribution.Use the content library cleanup command-line tool to remove content that's no longer associated with any package or application on a distribution point. Ce type de contenu est appelé contenu orphelin.This type of content is called orphaned content. Cet outil remplace les versions plus anciennes des outils similaires distribuées pour les produits Configuration Manager antérieurs.This tool replaces older versions of similar tools released for past Configuration Manager products.

L’outil affecte uniquement le contenu du point de distribution spécifié à l’exécution de l’outil.The tool only affects the content on the distribution point that you specify when you run the tool. L’outil ne peut pas supprimer du de la bibliothèque de contenu sur le serveur de site.The tool can't remove content from the content library on the site server.

Recherchez ContentLibraryCleanup.exe dans CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup sur le serveur de site.Find ContentLibraryCleanup.exe in CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup on the site server.

Configuration requiseRequirements

  • Exécutez l’outil sur un seul point de distribution à la fois.Only run the tool against a single distribution point at a time.

  • Exécutez-le directement sur l’ordinateur qui héberge le point de distribution à nettoyer ou à distance à partir d’un autre ordinateur.Run it directly on the computer that hosts the distribution point to cleanup, or remotely from another computer.

  • Le compte d’utilisateur qui exécute l’outil doit avoir des autorisations identiques à celles du rôle de sécurité Administrateur complet dans Configuration Manager.The user account that runs the tool must have permissions the same as the Full Administrator security role in Configuration Manager.

Modes opératoiresModes of operation

Exécutez l’outil dans les deux modes suivants : Scénario et Suppression.Run the tool in the following two modes: What-if and Delete.

Conseil

Démarrez avec le mode Scénario.Start with the what-if mode. Quand vous êtes satisfait des résultats, exécutez l’outil en mode Suppression.When you're satisfied with the results, then run the tool in delete mode.

Mode ScénarioWhat-if mode

Si vous ne spécifiez pas le paramètre /delete, l’outil s’exécute en mode Scénario.If you don't specify the /delete parameter, the tool runs in what-if mode. Ce mode identifie le contenu qui serait supprimé du point de distribution.This mode identifies the content that would be deleted from the distribution point.

  • Dans ce mode, l’outil ne supprime aucune donnée.When run in this mode, the tool doesn't delete any data.

  • L’outil écrit dans le fichier journal des informations sur le contenu qui serait supprimé.The tool writes to the log file information about the content that it would delete. Vous n’êtes pas invité à confirmer chaque suppression potentielle.You're not prompted to confirm each potential deletion.

Mode SuppressionDelete mode

Quand vous exécutez l’outil avec le paramètre /delete, l’outil s’exécute en mode Suppression.When you run the tool with the /delete parameter, the tool runs in delete mode.

  • 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.When run in this mode, orphaned content that it finds on the specified distribution point can be deleted from the distribution point's content library.

  • Avant de supprimer chaque fichier, confirmez que l’outil doit le supprimer.Before deleting each file, confirm that the tool should delete it. Sélectionnez O pour Oui, N pour Non ou Oui pour tout pour ignorer les autres invites et supprimer tout le contenu orphelin.Select Y for yes, N for no, or Yes to all to skip further prompts and delete all orphaned content.

Fichier journalLog file

Quand l’outil s’exécute dans l’un ou l’autre mode, il crée automatiquement un journal.When the tool runs in either mode, it automatically creates a log. Il nomme le fichier journal avec les informations suivantes :It names the log file with the following information:

  • Le mode dans lequel l’outil s’exécuteThe mode the tool runs in
  • Le nom du point de distributionThe name of the distribution point
  • La date et l’heure de l’opérationThe date and time of operation

Quand l’exécution de l’outil est terminée, celui-ci ouvre automatiquement le fichier journal dans Windows.When the tool finishes, it automatically opens the log file in Windows.

Par défaut, l’outil écrit le fichier journal dans le dossier temporaire du compte d’utilisateur qui exécute l’outil.By default, the tool writes the log file to the temp folder of the user account that runs the tool. Cet emplacement se trouve sur l’ordinateur où vous exécutez l’outil, qui n’est pas toujours la cible de l’outil.This location is on the computer where you run the tool, which isn't always the target of the tool. Utilisez le commutateur /log pour rediriger le fichier journal vers un autre emplacement, y compris un partage réseau.Use the /log parameter to redirect the log file to another location, including a network share.

Exécution de l'outilRun the tool

Pour exécuter l’outil :To run the tool:

  1. Ouvrez une invite de commandes en tant qu’administrateur.Open a command prompt as an administrator. Accédez au répertoire du dossier qui contient ContentLibraryCleanup.exe.Change directory to the folder that contains ContentLibraryCleanup.exe.

  2. Entrez une ligne de commande qui inclut les paramètres de ligne de commande obligatoires, ainsi que les paramètres facultatifs que vous voulez utiliser.Enter a command line that includes the required command-line parameters, and any optional parameters you want to use.

Paramètres de ligne de commandeCommand-line parameters

Utilisez ces paramètres de ligne de commande dans n’importe quel ordre.Use these command-line parameters in any order.

Paramètres obligatoiresRequired parameters

ParamètreParameter DétailsDetails
/dp <distribution point FQDN> Spécifiez le nom de domaine complet du point de distribution à nettoyer.Specify the fully qualified domain name (FQDN) of the distribution point to clean.
/ps <primary site FQDN> Obligatoire seulement lors du nettoyage du contenu d’un point de distribution sur un site secondaire.Required only when cleaning content from a distribution point at a secondary site. L’outil se connecte au site parent principal pour exécuter des requêtes sur le fournisseur SMS.The tool connects to the parent primary site to run queries against the SMS Provider. Ces requêtes permettent à l’outil de déterminer quel contenu doit se trouver sur le point de distribution.These queries let the tool determine what content should be on the distribution point. Il peut alors identifier le contenu orphelin à supprimer.It can then identify the orphaned content to remove. Cette connexion au site parent principal doit être établie pour les points de distribution sur un site secondaire, car les détails nécessaires ne sont pas accessibles directement à partir du site secondaire.This connection to the parent primary site must be made for distribution points at a secondary site because the required details aren't available directly from the secondary site.
/sc <primary site code> Obligatoire seulement lors du nettoyage du contenu d’un point de distribution sur un site secondaire.Required only when cleaning content from a distribution point at a secondary site. Spécifiez le code de site du site principal parent.Specify the site code of the parent primary site.

Exemple : Analyse et journalisation du contenu qu’il supprimerait (Scénario)Example: Scan and log what content it would delete (what-if)

ContentLibraryCleanup.exe /dp server1.contoso.com

Exemple : Analyse et journalisation du contenu pour un point de distribution sur un site secondaireExample: Scan and log content for a DP at a secondary site

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

Paramètres facultatifsOptional parameters

ParamètreParameter DétailsDetails
/delete Utilisez ce paramètre quand vous êtes prêt à supprimer du contenu du point de distribution.Use this parameter when you're ready to delete content from the distribution point. Il vous demande confirmation avant de supprimer du contenu.It prompts you before it deletes content.

Si vous n’utilisez pas ce paramètre, l’outil consigne les résultats sur le contenu qu’il supprimerait.When you don't use this parameter, the tool logs results about what content it would delete. Sans ce paramètre, il ne supprime aucun contenu du point de distribution.Without this parameter, it doesn't actually delete any content from the distribution point.
/q Ce paramètre fait que l’outil s’exécute en mode silencieux et supprime toutes les invites.This parameter runs the tool in a quiet mode that suppresses all prompts. Ces invites portent notamment sur la suppression de contenu.These prompts include when it deletes content. Il n’ouvre pas non plus automatiquement le fichier journal.It also doesn't automatically open the log file.
/ps <primary site FQDN> Facultatif seulement lors du nettoyage du contenu d’un point de distribution sur un site principal.Optional only when cleaning content from a distribution point at a primary site. Spécifiez le nom de domaine complet du site principal auquel appartient le point de distribution.Specify the FQDN of the primary site that the distribution point belongs to.
/sc <primary site code> Facultatif seulement lors du nettoyage du contenu d’un point de distribution sur un site principal.Optional only when cleaning content from a distribution point at a primary site. Spécifiez le code de site du site principal auquel appartient le point de distribution.Specify the site code of the primary site that the distribution point belongs to.
/log <log file directory> Spécifiez l’emplacement d’écriture du fichier journal par l’outil.Specify the location where the tool writes the log file. Cet emplacement peut être un lecteur local ou un partage réseau.This location can be a local drive or a network share.

Si vous n’utilisez pas ce paramètre, l’outil place le fichier journal dans le répertoire temp de l’utilisateur sur l’ordinateur où l’outil s’exécute.When you don't use this parameter, the tool places the log file in the user's temp directory on the computer where the tool runs.

Exemple : Suppression du contenuExample: Delete content

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

Exemple : Suppression de contenu sans inviteExample: Delete content without prompts

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

Exemple : Journalisation sur le disque localExample: Log to local drive

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

Exemple : Journalisation sur un partage réseauExample: Log to network share

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

Problème connuKnown issue

Quand un package ou un déploiement a échoué, ou s’il 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.When any package or deployment has failed, or is in progress, the tool might return the following error: System.InvalidOperationException: This content library cannot be cleaned up right now because package <packageID> is not fully installed.

Aucune solution de contournement n’est disponible pour ce problème.There's no workaround for this issue. L’outil ne peut pas identifier de façon fiable les fichiers orphelins quand du contenu est en cours de déploiement ou n’a pas pu être déployé.The tool can't reliably identify orphaned files when content is in progress or has failed to deploy. L’outil ne vous permet pas de nettoyer du contenu tant que vous n’avez pas résolu ce problème.The tool won't allow you to clean up content until you resolve that issue.