Средство очистки библиотеки содержимого

Относится к Configuration Manager (Current Branch)

Используйте средство командной строки очистки библиотеки содержимого, чтобы удалить содержимое, которое больше не связано с объектом в точке распространения. Этот тип содержимого называется потерянным содержимым. Это средство заменяет более старые версии аналогичных средств, выпущенных для продуктов прошлых Configuration Manager.

Средство влияет только на содержимое в точке распространения, указанной при запуске средства. Средство не может удалить содержимое из библиотеки содержимого на сервере сайта.

Если удалить содержимое из точки распространения, пока система сайта находится в автономном режиме, в WMI может существовать потерянная запись. Со временем это поведение может в конечном итоге привести к состоянию предупреждения в точке распространения. Чтобы устранить проблему в версии 2006 и более ранних версиях, необходимо вручную удалить потерянные записи из WMI. Ошибка во время этого процесса может привести к более серьезным проблемам с сервером. Начиная с версии 2010, средство также может удалять потерянные записи содержимого из поставщика WMI в точке распространения.

Найдите ContentLibraryCleanup.exe на CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup сервере сайта. Дополнительные сведения об этом расположении см. в разделе Папка CD.Latest.

Требования

• Одновременно запустите средство только в одной точке распространения.

• Запустите ее непосредственно на сервере, на котором размещена точка распространения для очистки или удаленно с другого компьютера.

• Средство не поддерживает удаление содержимого с сервера сайта, имеющего одну библиотеку содержимого. Если сервер сайта также имеет роль точки распространения, если пакет не предназначен для сервера, пакет по-прежнему находится в одной библиотеке содержимого.

• Средство не поддерживает шлюз управления облачными клиентами с поддержкой содержимого.

• Учетная запись пользователя, которая запускает средство, должна иметь разрешения, аналогичные роли безопасности "Полный администратор" в Configuration Manager.

Режимы работы

Запустите средство в следующих двух режимах: What-if и Delete.

Совет

Начните с режима "что если ". Если вы удовлетворены результатами, запустите средство в режиме удаления .

Режим "что если"

Если параметр не указан /delete , средство запускается в режиме "что если". Этот режим определяет содержимое, которое будет удалено из точки распространения.

• При запуске в этом режиме средство не удаляет данные.

• Средство записывает в файл журнала сведения о содержимом, которое оно удаляет. Вам не будет предложено подтвердить каждое потенциальное удаление.

Режим удаления

При запуске средства с параметром /delete средство запускается в режиме удаления.

• При запуске в этом режиме потерянный контент, который он находит в указанной точке распространения, можно удалить из библиотеки содержимого точки распространения.

• Начиная с версии 2010, он также может удалять потерянные записи содержимого из поставщика WMI в точке распространения.

• Перед удалением каждого файла убедитесь, что средство должно удалить его. Выберите Y для параметра Да, N для нет или Да для всех , чтобы пропустить дальнейшие запросы и удалить все потерянное содержимое.

Файл журнала

При запуске средства в любом из режимов автоматически создается файл журнала. Он присваивает файлу следующие сведения:

• Режим, в котором запускается средство
• Имя точки распространения
• Дата и время операции

По завершении работы средство автоматически открывает файл журнала в Windows.

По умолчанию средство записывает файл журнала в временную папку учетной записи пользователя, в которой запускается средство. Это расположение находится на компьютере, где запускается средство, которое не всегда является целевым объектом средства. /log Используйте параметр для перенаправления файла журнала в другое расположение, включая сетевую папку.

Запуск средства

Чтобы запустить инструмент:

1. Откройте окно командной строки c правами администратора. Измените каталог на папку, содержащую ContentLibraryCleanup.exe.

2. Введите командную строку, содержащую необходимые параметры командной строки и все необязательные параметры, которые вы хотите использовать.

Параметры командной строки

Используйте эти параметры командной строки в любом порядке.

Обязательные параметры

Параметр	Details
/dp <distribution point FQDN>	Укажите полное доменное имя (FQDN) точки распространения для очистки.
/ps <primary site FQDN>	Требуется только при очистке содержимого из точки распространения на вторичном сайте. Средство подключается к родительскому первичному сайту для выполнения запросов к поставщику SMS. Эти запросы позволяют средству определить, какое содержимое должно находиться в точке распространения. Затем он может определить потерянное содержимое для удаления. Это подключение к родительскому первичному сайту должно быть установлено для точек распространения на вторичном сайте, так как необходимые сведения недоступны непосредственно с вторичного сайта.
/sc <primary site code>	Требуется только при очистке содержимого из точки распространения на вторичном сайте. Укажите код сайта родительского первичного сайта.

Пример. Сканируйте и записывая запись удаляемого содержимого (что если)

ContentLibraryCleanup.exe /dp server1.contoso.com

Пример. Сканирование содержимого dp и ведение журнала на дополнительном сайте

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

Необязательные параметры

Параметр	Details
/delete	Используйте этот параметр, когда будете готовы удалить содержимое из точки распространения. Перед удалением содержимого появится запрос. Если этот параметр не используется, средство регистрирует результаты о том, какое содержимое будет удалено. Без этого параметра он фактически не удаляет содержимое из точки распространения.
/q	Этот параметр запускает средство в тихом режиме, который подавляет все запросы. Эти запросы включают при удалении содержимого. Файл журнала также не открывается автоматически.
/ps <primary site FQDN>	Необязательный параметр только при очистке содержимого из точки распространения на первичном сайте. Укажите полное доменное имя первичного сайта, к которому принадлежит точка распространения.
/sc <primary site code>	Необязательный параметр только при очистке содержимого из точки распространения на первичном сайте. Укажите код сайта первичного сайта, к которому принадлежит точка распространения.
/log <log file directory>	Укажите расположение, в котором средство записывает файл журнала. Это может быть локальный диск или сетевая папка. Если этот параметр не используется, средство помещает файл журнала во временный каталог пользователя на компьютере, где запускается средство.

Пример. Удаление содержимого

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

Пример. Удаление содержимого без запросов

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

Пример. Ведение журнала на локальный диск

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

Пример. Вход в общую сетевую папку

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

Известная проблема

В версии 2103 и более ранних, когда какой-либо пакет или развертывание завершился сбоем или выполняется, средство может вернуть следующую ошибку:

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

Чтобы обойти эту проблему, обновите сайт до версии 2107. Средство не может надежно идентифицировать потерянные файлы, но отобразит предупреждение и продолжит работу.