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:
Otwórz okno wiersza polecenia jako administrator. Zmień katalog na folder zawierający ContentLibraryCleanup.exe.
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ć.