Herramienta de limpieza de biblioteca de contenido
Se aplica a: Configuration Manager (rama actual)
Use la herramienta de línea de comandos de limpieza de biblioteca de contenido para quitar el contenido que ya no está asociado a un objeto en un punto de distribución. Este tipo de contenido se denomina contenido huérfano. Esta herramienta reemplaza las versiones anteriores de herramientas similares publicadas para productos Configuration Manager anteriores.
La herramienta solo afecta al contenido del punto de distribución que especifique al ejecutar la herramienta. La herramienta no puede quitar contenido de la biblioteca de contenido en el servidor de sitio.
Si quita contenido de un punto de distribución mientras el sistema de sitio está sin conexión, puede existir un registro huérfano en WMI. Con el tiempo, este comportamiento puede dar lugar finalmente a un estado de advertencia en el punto de distribución. Para mitigar el problema en la versión 2006 y versiones anteriores, tuvo que quitar manualmente las entradas huérfanas de WMI. Cometer un error durante este proceso podría causar problemas más graves con el servidor. A partir de la versión 2010, la herramienta también puede quitar registros de contenido huérfanos del proveedor WMI en un punto de distribución.
Busque ContentLibraryCleanup.exe en CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup en el servidor de sitio. Para obtener más información sobre esta ubicación, consulte la carpeta CD.Latest.
Requisitos
Ejecute solo la herramienta en un único punto de distribución a la vez.
Ejecútelo directamente en el servidor que hospeda el punto de distribución que se va a limpiar o de forma remota desde otro equipo.
La herramienta no admite la eliminación de contenido del servidor de sitio, que tiene una sola biblioteca de contenido. Cuando el servidor de sitio también tiene el rol de punto de distribución, si un paquete no está destinado al servidor, el paquete sigue estando en la biblioteca de contenido única.
La herramienta no admite una puerta de enlace de administración en la nube habilitada para contenido.
La cuenta de usuario que ejecuta la herramienta debe tener los mismos permisos que el rol de seguridad Administrador total en Configuration Manager.
Modos de operación
Ejecute la herramienta en los dos modos siguientes: What-if y Delete.
Sugerencia
Comience con el modo what-if . Cuando esté satisfecho con los resultados, ejecute la herramienta en modo de eliminación .
Modo what-if
Si no especifica el /delete parámetro , la herramienta se ejecuta en modo what-if. Este modo identifica el contenido que se eliminaría del punto de distribución.
Cuando se ejecuta en este modo, la herramienta no elimina ningún dato.
La herramienta escribe en el archivo de registro información sobre el contenido que eliminaría. No se le pedirá que confirme cada posible eliminación.
Modo de eliminación
Al ejecutar la herramienta con el /delete parámetro , la herramienta se ejecuta en modo de eliminación.
Cuando se ejecuta en este modo, el contenido huérfano que encuentra en el punto de distribución especificado se puede eliminar de la biblioteca de contenido del punto de distribución.
A partir de la versión 2010, también puede quitar registros de contenido huérfanos del proveedor WMI en el punto de distribución.
Antes de eliminar cada archivo, confirme que la herramienta debe eliminarlo. Seleccione Y para sí, N para no o Sí a todos para omitir más mensajes y eliminar todo el contenido huérfano.
Archivo de registro
Cuando la herramienta se ejecuta en cualquiera de los modos, crea automáticamente un archivo de registro. Asigna el nombre al archivo con la siguiente información:
- Modo en el que se ejecuta la herramienta
- Nombre del punto de distribución
- Fecha y hora de la operación
Cuando finaliza la herramienta, se abre automáticamente el archivo de registro en Windows.
De forma predeterminada, la herramienta escribe el archivo de registro en la carpeta temp de la cuenta de usuario que ejecuta la herramienta. Esta ubicación se encuentra en el equipo donde se ejecuta la herramienta, que no siempre es el destino de la herramienta. Use el /log parámetro para redirigir el archivo de registro a otra ubicación, incluido un recurso compartido de red.
Ejecución de la herramienta
Para ejecutar la herramienta:
Abra un símbolo del sistema como administrador. Cambie el directorio a la carpeta que contiene ContentLibraryCleanup.exe.
Escriba una línea de comandos que incluya los parámetros de línea de comandos necesarios y los parámetros opcionales que quiera usar.
Parámetros de línea de comandos
Use estos parámetros de línea de comandos en cualquier orden.
Parámetros necesarios
| Parámetro | Detalles |
|---|---|
/dp <distribution point FQDN> |
Especifique el nombre de dominio completo (FQDN) del punto de distribución que se va a limpiar. |
/ps <primary site FQDN> |
Solo se requiere cuando se limpia el contenido de un punto de distribución en un sitio secundario. La herramienta se conecta al sitio primario primario para ejecutar consultas en el proveedor de SMS. Estas consultas permiten que la herramienta determine qué contenido debe estar en el punto de distribución. A continuación, puede identificar el contenido huérfano que se va a quitar. Esta conexión con el sitio primario primario debe realizarse para los puntos de distribución en un sitio secundario porque los detalles necesarios no están disponibles directamente desde el sitio secundario. |
/sc <primary site code> |
Solo se requiere cuando se limpia el contenido de un punto de distribución en un sitio secundario. Especifique el código de sitio del sitio primario primario. |
Ejemplo: Examinar y registrar el contenido que eliminaría (what-if)
ContentLibraryCleanup.exe /dp server1.contoso.com
Ejemplo: Examen y registro del contenido de un dp en un sitio secundario
ContentLibraryCleanup.exe /dp server1.contoso.com /ps siteserver1.contoso.com /sc ABC
Parámetros opcionales
| Parámetro | Detalles |
|---|---|
/delete |
Use este parámetro cuando esté listo para eliminar contenido del punto de distribución. Se le pide antes de que elimine el contenido.
Cuando no se usa este parámetro, la herramienta registra los resultados sobre el contenido que eliminaría. Sin este parámetro, en realidad no elimina ningún contenido del punto de distribución. |
/q |
Este parámetro ejecuta la herramienta en un modo silencioso que suprime todas las solicitudes. Estas solicitudes incluyen cuándo elimina el contenido. Tampoco abre automáticamente el archivo de registro. |
/ps <primary site FQDN> |
Opcional solo cuando se limpia el contenido de un punto de distribución en un sitio primario. Especifique el FQDN del sitio primario al que pertenece el punto de distribución. |
/sc <primary site code> |
Opcional solo cuando se limpia el contenido de un punto de distribución en un sitio primario. Especifique el código de sitio del sitio primario al que pertenece el punto de distribución. |
/log <log file directory> |
Especifique la ubicación donde la herramienta escribe el archivo de registro. Esta ubicación puede ser una unidad local o un recurso compartido de red.
Cuando 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. |
Ejemplo: Eliminación de contenido
ContentLibraryCleanup.exe /dp server1.contoso.com /delete
Ejemplo: Eliminación de contenido sin avisos
ContentLibraryCleanup.exe /q /dp server1.contoso.com /delete
Ejemplo: Registro en la unidad local
ContentLibraryCleanup.exe /dp server1.contoso.com /log C:\Users\Administrator\Desktop
Ejemplo: Registro en el recurso compartido de red
ContentLibraryCleanup.exe /dp server1.contoso.com /log \\server\share
Problema conocido
En la versión 2103 y versiones anteriores, cuando se produce un error en cualquier paquete o implementación, o está en curso, la herramienta podría devolver el siguiente error:
System.InvalidOperationException: This content library cannot be cleaned up right now because package <packageID> is not fully installed.
Para solucionar este problema, actualice el sitio a la versión 2107. La herramienta no puede identificar archivos huérfanos de forma confiable, pero mostrará una advertencia y continuará.