Narzędzie do oczyszczania biblioteki zawartościContent library cleanup tool

Dotyczy: Configuration Manager (Current Branch)Applies to: Configuration Manager (current branch)

Za pomocą narzędzia wiersza polecenia Oczyść bibliotekę zawartości można usunąć zawartość, która nie jest już skojarzona z żadnym pakietem lub aplikacją w punkcie dystrybucji.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. Ten typ zawartości nazywa się zawartością oddzieloną.This type of content is called orphaned content. To narzędzie zastępuje starsze wersje podobnych narzędzi, które zostały wydane dla wcześniejszych Configuration Manager produktów.This tool replaces older versions of similar tools released for past Configuration Manager products.

Narzędzie ma wpływ tylko na zawartość w punkcie dystrybucji określonym podczas uruchamiania narzędzia.The tool only affects the content on the distribution point that you specify when you run the tool. Narzędzie nie może usunąć zawartości z biblioteki zawartości na serwerze lokacji.The tool can't remove content from the content library on the site server.

Na serwerze lokacji Znajdź ContentLibraryCleanup. exe. CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanupFind ContentLibraryCleanup.exe in CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup on the site server.

WymaganiaRequirements

  • Narzędzie należy uruchomić tylko w jednym punkcie dystrybucji w danym momencie.Only run the tool against a single distribution point at a time.

  • Uruchom go bezpośrednio na komputerze hostującym punkt dystrybucji do oczyszczenia lub zdalnie z innego komputera.Run it directly on the computer that hosts the distribution point to cleanup, or remotely from another computer.

  • Konto użytkownika, na którym jest uruchamiane narzędzie, musi mieć uprawnienia takie same jak rola zabezpieczeń Pełny administrator w Configuration Manager.The user account that runs the tool must have permissions the same as the Full Administrator security role in Configuration Manager.

Tryby operacyjneModes of operation

Uruchom narzędzie w następujących dwóch trybach: co to jest i Usuń.Run the tool in the following two modes: What-if and Delete.

Porada

Zacznij od trybu warunkowego .Start with the what-if mode. Gdy wyniki są zadowalające, uruchom narzędzie w trybie usuwania .When you're satisfied with the results, then run the tool in delete mode.

Tryb działania warunkowegoWhat-if mode

Jeśli /delete parametr nie zostanie określony, narzędzie działa w trybie warunkowym.If you don't specify the /delete parameter, the tool runs in what-if mode. Ten tryb identyfikuje zawartość, która zostanie usunięta z punktu dystrybucji.This mode identifies the content that would be deleted from the distribution point.

  • Po uruchomieniu w tym trybie narzędzie nie usuwa żadnych danych.When run in this mode, the tool doesn't delete any data.

  • Narzędzie zapisuje w pliku dziennika informacje o zawartości, która mogłaby zostać usunięta.The tool writes to the log file information about the content that it would delete. Nie zostanie wyświetlony monit o potwierdzenie wszystkich potencjalnych operacji usuwania.You're not prompted to confirm each potential deletion.

Tryb usuwaniaDelete mode

Po uruchomieniu narzędzia z /delete parametrem narzędzie jest uruchamiane w trybie usuwania.When you run the tool with the /delete parameter, the tool runs in delete mode.

  • Po uruchomieniu w tym trybie zawartość oddzielona znaleziona w określonym punkcie dystrybucji może zostać usunięta z biblioteki zawartości punktu dystrybucji.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.

  • Przed usunięciem każdego pliku upewnij się, że narzędzie powinno je usunąć.Before deleting each file, confirm that the tool should delete it. Wybierz pozycję Y dla opcji tak, N dla elementu nie lub tak, aby pominąć dalsze polecenia i usunąć całą oddzieloną zawartość.Select Y for yes, N for no, or Yes to all to skip further prompts and delete all orphaned content.

Plik dziennikaLog file

Gdy narzędzie działa w dowolnym trybie, automatycznie tworzy dziennik.When the tool runs in either mode, it automatically creates a log. Nazwa pliku dziennika ma następujące informacje:It names the log file with the following information:

  • Tryb, w którym działa narzędzieThe mode the tool runs in
  • Nazwa punktu dystrybucjiThe name of the distribution point
  • Data i godzina operacjiThe date and time of operation

Po zakończeniu działania narzędzia automatycznie otwiera plik dziennika w systemie Windows.When the tool finishes, it automatically opens the log file in Windows.

Domyślnie narzędzie zapisuje plik dziennika w folderze tymczasowym konta użytkownika, na którym jest uruchamiane narzędzie.By default, the tool writes the log file to the temp folder of the user account that runs the tool. Ta lokalizacja znajduje się na komputerze, na którym jest uruchamiane narzędzie, które nie jest zawsze miejscem docelowym narzędzia.This location is on the computer where you run the tool, which isn't always the target of the tool. Użyj /log parametru, aby przekierować plik dziennika do innej lokalizacji, w tym udziału sieciowego.Use the /log parameter to redirect the log file to another location, including a network share.

Uruchamianie narzędziaRun the tool

Aby uruchomić narzędzie:To run the tool:

  1. Otwórz wiersz polecenia jako administrator.Open a command prompt as an administrator. Zmień katalog na folder, który zawiera ContentLibraryCleanup. exe.Change directory to the folder that contains ContentLibraryCleanup.exe.

  2. Wprowadź wiersz polecenia, który zawiera wymagane Parametry wiersza poleceniai wszystkie parametry opcjonalne, które mają być używane.Enter a command line that includes the required command-line parameters, and any optional parameters you want to use.

Parametry wiersza poleceniaCommand-line parameters

Użyj tych parametrów wiersza polecenia w dowolnej kolejności.Use these command-line parameters in any order.

Wymagane parametryRequired parameters

ParametrParameter SzczegółyDetails
/dp <distribution point FQDN> Określ w pełni kwalifikowaną nazwę domeny (FQDN) punktu dystrybucji do oczyszczenia.Specify the fully qualified domain name (FQDN) of the distribution point to clean.
/ps <primary site FQDN> Wymagane tylko w przypadku czyszczenia zawartości z punktu dystrybucji w lokacji dodatkowej.Required only when cleaning content from a distribution point at a secondary site. Narzędzie łączy się z nadrzędną lokacją główną w celu uruchamiania zapytań względem dostawcy programu SMS.The tool connects to the parent primary site to run queries against the SMS Provider. Te zapytania pozwalają narzędziu określić, jaka zawartość powinna znajdować się w punkcie dystrybucji.These queries let the tool determine what content should be on the distribution point. Następnie może zidentyfikować oddzieloną zawartość do usunięcia.It can then identify the orphaned content to remove. To połączenie z nadrzędną lokacją główną należy ustanowić dla punktów dystrybucji w lokacji dodatkowej, ponieważ wymagane szczegóły nie są dostępne bezpośrednio z lokacji dodatkowej.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> Wymagane tylko w przypadku czyszczenia zawartości z punktu dystrybucji w lokacji dodatkowej.Required only when cleaning content from a distribution point at a secondary site. Określ kod lokacji nadrzędnej lokacji głównej.Specify the site code of the parent primary site.

Przykład: Skanuj i Rejestruj zawartość, którą mógłby usunąć (co to jest)Example: Scan and log what content it would delete (what-if)

ContentLibraryCleanup.exe /dp server1.contoso.com

Przykład: Skanuj i Rejestruj zawartość dla punktu dystrybucji w lokacji dodatkowejExample: Scan and log content for a DP at a secondary site

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

Parametry opcjonalneOptional parameters

ParametrParameter SzczegółyDetails
/delete Użyj tego parametru, gdy wszystko jest gotowe do usunięcia zawartości z punktu dystrybucji.Use this parameter when you're ready to delete content from the distribution point. Zostanie wyświetlony komunikat z prośbą o usunięcie zawartości.It prompts you before it deletes content.

Jeśli ten parametr nie jest używany, narzędzie rejestruje wyniki, które zostałyby usunięte.When you don't use this parameter, the tool logs results about what content it would delete. Bez tego parametru nie usuwa żadnej zawartości z punktu dystrybucji.Without this parameter, it doesn't actually delete any content from the distribution point.
/q Ten parametr uruchamia narzędzie w trybie cichym, który pomija wszystkie monity.This parameter runs the tool in a quiet mode that suppresses all prompts. Te informacje są uwzględniane po usunięciu zawartości.These prompts include when it deletes content. Plik dziennika nie jest również automatycznie otwierany.It also doesn't automatically open the log file.
/ps <primary site FQDN> Opcjonalne tylko w przypadku czyszczenia zawartości z punktu dystrybucji w lokacji głównej.Optional only when cleaning content from a distribution point at a primary site. Określ nazwę FQDN lokacji głównej, do której należy punkt dystrybucji.Specify the FQDN of the primary site that the distribution point belongs to.
/sc <primary site code> Opcjonalne tylko w przypadku czyszczenia zawartości z punktu dystrybucji w lokacji głównej.Optional only when cleaning content from a distribution point at a primary site. Określ kod lokacji głównej, do której należy punkt dystrybucji.Specify the site code of the primary site that the distribution point belongs to.
/log <log file directory> Określ lokalizację, w której narzędzie zapisuje plik dziennika.Specify the location where the tool writes the log file. Ta lokalizacja może być dyskiem lokalnym lub udziałem sieciowym.This location can be a local drive or a network share.

Jeśli ten parametr nie jest używany, Narzędzie umieści plik dziennika w katalogu Temp użytkownika na komputerze, na którym działa narzędzie.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.

Przykład: usuwanie zawartościExample: Delete content

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

Przykład: usuwanie zawartości bez wyświetlania wierszyExample: Delete content without prompts

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

Przykład: Logowanie do dysku lokalnegoExample: Log to local drive

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

Przykład: Logowanie do udziału sieciowegoExample: Log to network share

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

Znany problemKnown issue

Gdy którykolwiek pakiet lub wdrożenie zakończyło się niepowodzeniem 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.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.

Nie ma obejścia tego problemu.There's no workaround for this issue. Narzędzie nie może niezawodnie identyfikować plików oddzielonych, gdy zawartość jest w toku lub nie można jej wdrożyć.The tool can't reliably identify orphaned files when content is in progress or has failed to deploy. Narzędzie nie pozwala na czyszczenie zawartości, dopóki ten problem nie zostanie rozwiązany.The tool won't allow you to clean up content until you resolve that issue.