Herramienta de limpieza de la biblioteca de contenidoContent library cleanup tool

Se aplica a: Configuration Manager (rama actual)Applies to: Configuration Manager (current branch)

Use la herramienta de línea de comandos de limpieza de la biblioteca de contenido para quitar contenido que ya no esté asociado con ningún paquete o aplicación en un punto de distribución.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. Este tipo de contenido se denomina contenido huérfano.This type of content is called orphaned content. Esta herramienta sustituye a las versiones anteriores de herramientas similares publicadas para productos anteriores de Configuration Manager.This tool replaces older versions of similar tools released for past Configuration Manager products.

La herramienta solo afecta al contenido del punto de distribución que especifique al ejecutar la herramienta.The tool only affects the content on the distribution point that you specify when you run the tool. La herramienta no puede quitar el contenido de la biblioteca de contenido en el servidor de sitio.The tool can't remove content from the content library on the site server.

Busque ContentLibraryCleanup.exe en CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup en el servidor de sitio.Find ContentLibraryCleanup.exe in CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup on the site server.

RequisitosRequirements

  • La herramienta solo se puede ejecutar en un único punto de distribución a la vez.Only run the tool against a single distribution point at a time.

  • Ejecútela directamente en el equipo que hospeda el punto de distribución que se va a limpiar, o bien de manera remota desde otro equipo.Run it directly on the computer that hosts the distribution point to cleanup, or remotely from another computer.

  • La cuenta de usuario que ejecuta la herramienta debe tener los mismos permisos que el rol de seguridad Administrador total en Configuration Manager.The user account that runs the tool must have permissions the same as the Full Administrator security role in Configuration Manager.

Modos de operaciónModes of operation

Ejecute la herramienta en los dos modos siguientes: Hipótesis y Eliminación.Run the tool in the following two modes: What-if and Delete.

Sugerencia

Comience con el modo Hipótesis.Start with the what-if mode. Cuando esté satisfecho con los resultados, ejecute la herramienta en modo Eliminación.When you're satisfied with the results, then run the tool in delete mode.

Modo HipótesisWhat-if mode

Si no se especifica el parámetro /delete, la herramienta se ejecuta en modo de hipótesis.If you don't specify the /delete parameter, the tool runs in what-if mode. Este modo identifica el contenido que se podría eliminar del punto de distribución.This mode identifies the content that would be deleted from the distribution point.

  • Cuando se ejecuta en este modo, la herramienta no elimina ningún dato.When run in this mode, the tool doesn't delete any data.

  • La herramienta escribe en el archivo de registro información sobre el contenido que podría eliminar.The tool writes to the log file information about the content that it would delete. No se le solicita que confirme cada eliminación potencial.You're not prompted to confirm each potential deletion.

Modo de eliminaciónDelete mode

Cuando la herramienta se ejecuta con el parámetro /delete, se ejecuta en el modo de eliminación.When you run the tool with the /delete parameter, the tool runs in delete mode.

  • Cuando se ejecuta en este modo, el contenido huérfano que detecta en el punto de distribución especificado se puede eliminar de la biblioteca de contenido del punto de distribución.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.

  • Antes de eliminar cada archivo, confirme que la herramienta debe eliminarlo.Before deleting each file, confirm that the tool should delete it. Haga clic en S para sí, N para no o Sí a todo para omitir mensajes adicionales y eliminar todo el contenido huérfano.Select Y for yes, N for no, or Yes to all to skip further prompts and delete all orphaned content.

Archivo de registroLog file

Al ejecutar la herramienta en cualquiera de los modos, crea un registro de forma automática.When the tool runs in either mode, it automatically creates a log. Asigna un nombre al archivo de registro con la información siguiente:It names the log file with the following information:

  • El modo en que se ejecuta la herramientaThe mode the tool runs in
  • El nombre del punto de distribuciónThe name of the distribution point
  • La fecha y hora de la operaciónThe date and time of operation

Cuando la herramienta termina, abre automáticamente el archivo de registro en Windows.When the tool finishes, it automatically opens the log file in Windows.

De forma predeterminada, la herramienta escribe el archivo de registro en la carpeta temporal de la cuenta de usuario que ejecuta la herramienta.By default, the tool writes the log file to the temp folder of the user account that runs the tool. Esta ubicación se encuentra en el equipo donde se ejecuta la herramienta, que no siempre es el destino de la herramienta.This location is on the computer where you run the tool, which isn't always the target of the tool. Use el parámetro /log para redirigir el archivo de registro a otra ubicación, incluido un recurso compartido de red.Use the /log parameter to redirect the log file to another location, including a network share.

Ejecutar la herramientaRun the tool

Para ejecutar la herramienta:To run the tool:

  1. Abra un símbolo del sistema como administrador.Open a command prompt as an administrator. Cambie el directorio a la carpeta que contiene ContentLibraryCleanup.exe.Change directory to the folder that contains ContentLibraryCleanup.exe.

  2. Escriba una línea de comandos que incluya los parámetros de línea de comandos necesarios y cualquier parámetro opcional que quiera usar.Enter a command line that includes the required command-line parameters, and any optional parameters you want to use.

Parámetros de línea de comandosCommand-line parameters

Use estos parámetros de línea de comandos en cualquier orden.Use these command-line parameters in any order.

Parámetros requeridosRequired parameters

ParámetroParameter DetallesDetails
/dp <distribution point FQDN> Especifique el nombre de dominio completo (FQDN) del punto de distribución que se va a limpiar.Specify the fully qualified domain name (FQDN) of the distribution point to clean.
/ps <primary site FQDN> Solo es requerido al limpiar contenido de un punto de distribución en un sitio secundario.Required only when cleaning content from a distribution point at a secondary site. La herramienta se conecta al sitio primario principal para ejecutar consultas en el proveedor de SMS.The tool connects to the parent primary site to run queries against the SMS Provider. Estas consultas permiten que la herramienta determine qué contenido debe estar en el punto de distribución.These queries let the tool determine what content should be on the distribution point. Después puede identificar el contenido huérfano que se va a quitar.It can then identify the orphaned content to remove. Esta conexión con el sitio primario principal se debe realizar para los puntos de distribución de un sitio secundario, ya que los detalles necesarios no están disponibles directamente en el sitio secundario.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> Solo es requerido al limpiar contenido de un punto de distribución en un sitio secundario.Required only when cleaning content from a distribution point at a secondary site. Especifique el código de sitio del sitio primario principal.Specify the site code of the parent primary site.

Ejemplo: Análisis y registro del contenido que se podría eliminar (hipótesis)Example: Scan and log what content it would delete (what-if)

ContentLibraryCleanup.exe /dp server1.contoso.com

Ejemplo: Análisis y registro del contenido de un punto de distribución en un sitio secundarioExample: Scan and log content for a DP at a secondary site

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

Parámetros opcionalesOptional parameters

ParámetroParameter DetallesDetails
/delete Use este parámetro cuando esté listo para eliminar contenido del punto de distribución.Use this parameter when you're ready to delete content from the distribution point. Antes de eliminar el contenido le pedirá que lo confirme.It prompts you before it deletes content.

Si no se usa este parámetro, la herramienta registra los resultados sobre el contenido que podría eliminar.When you don't use this parameter, the tool logs results about what content it would delete. Sin este parámetro, en realidad no elimina ningún contenido del punto de distribución.Without this parameter, it doesn't actually delete any content from the distribution point.
/q Este parámetro ejecuta la herramienta en un modo silencioso que suprime todos los mensajes.This parameter runs the tool in a quiet mode that suppresses all prompts. Estos mensajes incluyen cuándo elimina el contenido.These prompts include when it deletes content. Tampoco abre el archivo de registro de forma automática.It also doesn't automatically open the log file.
/ps <primary site FQDN> Opcional solo al limpiar contenido de un punto de distribución en un sitio primario.Optional only when cleaning content from a distribution point at a primary site. Especifique el FQDN del sitio primario al que pertenece el punto de distribución.Specify the FQDN of the primary site that the distribution point belongs to.
/sc <primary site code> Opcional solo al limpiar contenido de un punto de distribución en un sitio primario.Optional only when cleaning content from a distribution point at a primary site. Especifique el código de sitio del sitio primario al que pertenece el punto de distribución.Specify the site code of the primary site that the distribution point belongs to.
/log <log file directory> Especifique la ubicación donde la herramienta escribe el archivo de registro.Specify the location where the tool writes the log file. Esta ubicación puede ser una unidad local o un recurso compartido de red.This location can be a local drive or a network share.

Si no se usa este parámetro, la herramienta coloca el archivo de registro en el directorio temporal del usuario en el equipo donde se ejecuta la herramienta.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.

Ejemplo: Eliminar contenidoExample: Delete content

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

Ejemplo: Eliminar contenido sin pedir confirmaciónExample: Delete content without prompts

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

Ejemplo: Registro en la unidad localExample: Log to local drive

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

Ejemplo: Registro en un recurso compartido de redExample: Log to network share

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

Problema conocidoKnown issue

Cuando se produce un error en un paquete o una implementación, o bien está en curso, es posible que la herramienta devuelva el error siguiente: 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.

No hay ninguna solución para este problema.There's no workaround for this issue. La herramienta no puede identificar de manera confiable archivos huérfanos cuando el contenido está en curso o si se ha producido un error en la implementación.The tool can't reliably identify orphaned files when content is in progress or has failed to deploy. La herramienta no permitirá que el contenido se limpie hasta que este problema se resuelva.The tool won't allow you to clean up content until you resolve that issue.