Narzędzie do czyszczenia biblioteki zawartości

Dotyczy: programu Configuration Manager (bieżąca gałąź)

Użyj narzędzia wiersza polecenia oczyszczania biblioteki zawartości, aby usunąć zawartość, która nie jest już skojarzona z obiektem w punkcie dystrybucji. Ten typ zawartości jest nazywany zawartością oddzieloną. To narzędzie zastępuje starsze wersje podobnych narzędzi wydanych dla poprzednich Configuration Manager produktów.

Narzędzie ma wpływ tylko na zawartość w punkcie dystrybucji określonym podczas uruchamiania narzędzia. Narzędzie nie może usunąć zawartości z biblioteki zawartości na serwerze lokacji.

Jeśli usuniesz zawartość z punktu dystrybucji, gdy system lokacji jest w trybie offline, w usłudze WMI może istnieć oddzielony rekord. Z biegiem czasu to zachowanie może ostatecznie prowadzić do stanu ostrzeżenia w punkcie dystrybucji. Aby rozwiązać problem w wersji 2006 i starszej, trzeba było ręcznie usunąć oddzielone wpisy z usługi WMI. Błąd podczas tego procesu może spowodować poważniejsze problemy z serwerem. Począwszy od wersji 2010, narzędzie może również usunąć oddzielone rekordy zawartości od dostawcy usługi WMI w punkcie dystrybucji.

Znajdź ContentLibraryCleanup.exe na CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup serwerze lokacji. Aby uzyskać więcej informacji na temat tej lokalizacji, zobacz Folder CD.Latest.

Wymagania

• Uruchom narzędzie tylko w jednym punkcie dystrybucji jednocześnie.

• Uruchom go bezpośrednio na serwerze hostującym punkt dystrybucji w celu oczyszczenia lub zdalnie z innego komputera.

• Narzędzie nie obsługuje usuwania zawartości z serwera lokacji, który ma pojedynczą bibliotekę zawartości. Jeśli serwer lokacji ma również rolę punktu dystrybucji, jeśli pakiet nie jest przeznaczony dla serwera, pakiet nadal znajduje się w jednej bibliotece zawartości.

• Narzędzie nie obsługuje bramy zarządzania chmurą z obsługą zawartości.

• Konto użytkownika, które uruchamia narzędzie, musi mieć uprawnienia takie same jak pełna rola zabezpieczeń administratora w Configuration Manager.

Tryby działania

Uruchom narzędzie w następujących dwóch trybach: What-if i Delete.

Porada

Zacznij od trybu analizy warunkowej . Gdy wyniki będą zadowalające, uruchom narzędzie w trybie usuwania .

Tryb analizy warunkowej

Jeśli nie określisz parametru /delete , narzędzie zostanie uruchomione w trybie analizy warunkowej. Ten tryb identyfikuje zawartość, która zostałaby usunięta z punktu dystrybucji.

• Po uruchomieniu w tym trybie narzędzie nie usuwa żadnych danych.

• Narzędzie zapisuje w pliku dziennika informacje o zawartości, która zostałaby usunięta. Nie zostanie wyświetlony monit o potwierdzenie każdego potencjalnego usunięcia.

Tryb usuwania

Po uruchomieniu narzędzia z parametrem /delete narzędzie jest uruchamiane w trybie usuwania.

• Po uruchomieniu w tym trybie oddzielona zawartość, która znajduje się w określonym punkcie dystrybucji, może zostać usunięta z biblioteki zawartości punktu dystrybucji.

• Począwszy od wersji 2010, można również usunąć oddzielone rekordy zawartości od dostawcy usługi WMI w punkcie dystrybucji.

• Przed usunięciem każdego pliku upewnij się, że narzędzie powinno go usunąć. Wybierz pozycję Y dla pozycji Tak, N dla nie lub Tak dla wszystkich, aby pominąć dalsze monity i usunąć całą oddzieloną zawartość.

Plik dziennika

Gdy narzędzie działa w obu trybach, automatycznie tworzy plik dziennika. Nada plikowi następujące informacje:

• Tryb, w który działa narzędzie
• Nazwa punktu dystrybucji
• Data i godzina operacji

Po zakończeniu działania narzędzia automatycznie otwiera plik dziennika w systemie Windows.

Domyślnie narzędzie zapisuje plik dziennika w folderze tymczasowym konta użytkownika, które uruchamia narzędzie. Ta lokalizacja znajduje się na komputerze, na którym jest uruchamiane narzędzie, które nie zawsze jest elementem docelowym narzędzia. Użyj parametru /log , aby przekierować plik dziennika do innej lokalizacji, w tym udziału sieciowego.

Uruchamianie narzędzia

Aby uruchomić narzędzie:

1. Otwórz okno wiersza polecenia jako administrator. Zmień katalog na folder zawierający ContentLibraryCleanup.exe.

2. Wprowadź wiersz polecenia zawierający wymagane parametry wiersza polecenia i wszystkie parametry opcjonalne, których chcesz użyć.

Parametry wiersza polecenia

Użyj tych parametrów wiersza polecenia w dowolnej kolejności.

Wymagane parametry

Parametr	Szczegóły
/dp <distribution point FQDN>	Określ w pełni kwalifikowaną nazwę domeny (FQDN) punktu dystrybucji do czyszczenia.
/ps <primary site FQDN>	Wymagane tylko podczas czyszczenia zawartości z punktu dystrybucji w lokacji dodatkowej. Narzędzie łączy się z nadrzędną lokacją główną w celu uruchamiania zapytań względem dostawcy programu SMS. Te zapytania pozwalają narzędziu określić, jaka zawartość powinna znajdować się w punkcie dystrybucji. Następnie można zidentyfikować oddzieloną zawartość do usunięcia. To połączenie z nadrzędną lokacją główną należy nawiązać dla punktów dystrybucji w lokacji dodatkowej, ponieważ wymagane szczegóły nie są dostępne bezpośrednio z lokacji dodatkowej.
/sc <primary site code>	Wymagane tylko podczas czyszczenia zawartości z punktu dystrybucji w lokacji dodatkowej. Określ kod witryny nadrzędnej lokacji głównej.

Przykład: Skanowanie i rejestrowanie zawartości, która zostałaby usunięta (co-jeśli)

ContentLibraryCleanup.exe /dp server1.contoso.com

Przykład: skanowanie i rejestrowanie zawartości dla dp w lokacji dodatkowej

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

Parametry opcjonalne

Parametr	Szczegóły
/delete	Użyj tego parametru, gdy wszystko będzie gotowe do usunięcia zawartości z punktu dystrybucji. Monituje o usunięcie zawartości. Jeśli nie używasz tego parametru, narzędzie rejestruje wyniki dotyczące zawartości, którą usunie. Bez tego parametru w rzeczywistości nie usuwa żadnej zawartości z punktu dystrybucji.
/q	Ten parametr uruchamia narzędzie w trybie cichym, które pomija wszystkie monity. Te monity obejmują usunięcie zawartości. Ponadto plik dziennika nie jest automatycznie otwierany.
/ps <primary site FQDN>	Opcjonalne tylko podczas czyszczenia zawartości z punktu dystrybucji w lokacji głównej. Określ nazwę FQDN lokacji głównej, do której należy punkt dystrybucji.
/sc <primary site code>	Opcjonalne tylko podczas czyszczenia zawartości z punktu dystrybucji w lokacji głównej. Określ kod lokacji głównej, do której należy punkt dystrybucji.
/log <log file directory>	Określ lokalizację, w której narzędzie zapisuje plik dziennika. Ta lokalizacja może być dyskiem lokalnym lub udziałem sieciowym. Jeśli nie używasz tego parametru, narzędzie umieszcza plik dziennika w katalogu tymczasowym użytkownika na komputerze, na którym działa narzędzie.

Przykład: Usuwanie zawartości

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

Przykład: Usuwanie zawartości bez monitów

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

Przykład: logowanie na dysku lokalnym

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

Przykład: logowanie do udziału sieciowego

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

Znany problem

W wersji 2103 lub starszej, gdy dowolny pakiet lub wdrożenie nie powiodło się lub jest w toku, narzędzie może zwrócić następujący błąd:

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

Aby obejść ten problem, zaktualizuj witrynę do wersji 2107. Narzędzie nie może niezawodnie zidentyfikować oddzielonych plików, ale wyświetli ostrzeżenie i będzie kontynuować.