Nástroj pro vyčištění knihovny obsahu
Platí pro: Configuration Manager (Current Branch)
Pomocí nástroje příkazového řádku pro vyčištění knihovny obsahu odeberte obsah, který už není přidružený k objektu v distribučním bodě. Tento typ obsahu se nazývá osamocený obsah. Tento nástroj nahrazuje starší verze podobných nástrojů vydaných pro předchozí produkty Configuration Manager.
Nástroj má vliv pouze na obsah distribučního bodu, který zadáte při spuštění nástroje. Nástroj nemůže odebrat obsah z knihovny obsahu na serveru lokality.
Pokud odeberete obsah z distribučního bodu v době, kdy je systém lokality offline, může ve službě WMI existovat osamocený záznam. V průběhu času může toto chování nakonec vést ke stavu upozornění v distribučním bodě. Pokud chcete tento problém zmírnit ve verzi 2006 a starších verzích, museli jste ručně odebrat osamocené položky z rozhraní WMI. Chyba během tohoto procesu může způsobit vážnější problémy se serverem. Od verze 2010 může nástroj také odebrat záznamy o osamoceném obsahu od poskytovatele rozhraní WMI v distribučním bodě.
Vyhledejte ContentLibraryCleanup.exe na CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup serveru lokality. Další informace o tomto umístění najdete ve složce CD.Latest.
Požadavky
Spusťte nástroj pouze proti jednomu distribučnímu bodu najednou.
Spusťte ho přímo na serveru, který je hostitelem distribučního bodu, abyste ho mohli vyčistit, nebo vzdáleně z jiného počítače.
Nástroj nepodporuje odebrání obsahu ze serveru lokality, který má jednu knihovnu obsahu. Pokud má server lokality také roli distribučního bodu, je balíček stále v jedné knihovně obsahu, pokud balíček není cílený na server.
Nástroj nepodporuje bránu pro správu cloudu s podporou obsahu.
Uživatelský účet, který nástroj spouští, musí mít stejná oprávnění jako role zabezpečení Úplný správce v Configuration Manager.
Režimy operací
Spusťte nástroj v následujících dvou režimech: What-if (Citlivostní analýzy ) a Delete (Odstranit).
Tip
Začněte režimem citlivostní analýzy . Až budete s výsledky spokojeni, spusťte nástroj v režimu odstranění .
Režim citlivostní analýzy
Pokud parametr nezadáte /delete , nástroj se spustí v režimu citlivostní analýzy. Tento režim identifikuje obsah, který by byl odstraněn z distribučního bodu.
Při spuštění v tomto režimu nástroj neodstraní žádná data.
Nástroj zapisuje do souboru protokolu informace o obsahu, který by odstranil. Nebudete vyzváni k potvrzení každého možného odstranění.
Režim odstranění
Když nástroj spustíte s parametrem /delete , nástroj se spustí v režimu odstranění.
Při spuštění v tomto režimu může být osamocený obsah, který najde v zadaném distribučním bodu, odstraněn z knihovny obsahu distribučního bodu.
Od verze 2010 může také odebrat záznamy osamoceného obsahu od poskytovatele rozhraní WMI v distribučním bodě.
Před odstraněním jednotlivých souborů ověřte, že nástroj by ho měl odstranit. Pokud chcete přeskočit další výzvy a odstranit veškerý osamocený obsah, vyberte Y pro ano, N pro ne nebo Ano všem .
Soubor protokolu
Když nástroj běží v obou režimech, automaticky vytvoří soubor protokolu. Soubor pojmenuje následujícími informacemi:
- Režim, ve kterém nástroj běží
- Název distribučního bodu
- Datum a čas operace
Po dokončení nástroje se soubor protokolu automaticky otevře ve Windows.
Ve výchozím nastavení nástroj zapisuje soubor protokolu do dočasné složky uživatelského účtu, na kterém je nástroj spuštěný. Toto umístění je v počítači, na kterém nástroj spouštíte, což není vždy cílem nástroje. Pomocí parametru /log přesměrujte soubor protokolu do jiného umístění, včetně sdílené síťové složky.
Spuštění nástroje
Spuštění nástroje:
Otevřete příkazový řádek jako správce. Změňte adresář na složku, která obsahuje ContentLibraryCleanup.exe.
Zadejte příkazový řádek, který obsahuje požadované parametry příkazového řádku a všechny volitelné parametry, které chcete použít.
Parametry příkazového řádku
Tyto parametry příkazového řádku používejte v libovolném pořadí.
Požadované parametry
| Parametr | Podrobnosti |
|---|---|
/dp <distribution point FQDN> |
Zadejte plně kvalifikovaný název domény (FQDN) distribučního bodu, který chcete vyčistit. |
/ps <primary site FQDN> |
Vyžaduje se pouze při čištění obsahu z distribučního bodu v sekundární lokalitě. Nástroj se připojí k nadřazené primární lokalitě a spustí dotazy na poskytovatele serveru SMS. Tyto dotazy umožňují nástroji určit, jaký obsah by měl být v distribučním bodě. Pak může identifikovat osamocený obsah, který se má odebrat. Toto připojení k nadřazené primární lokalitě musí být provedeno pro distribuční body v sekundární lokalitě, protože požadované podrobnosti nejsou k dispozici přímo ze sekundární lokality. |
/sc <primary site code> |
Vyžaduje se pouze při čištění obsahu z distribučního bodu v sekundární lokalitě. Zadejte kód lokality nadřazené primární lokality. |
Příklad: Kontrola a protokolování obsahu, který by se odstranil (what-if)
ContentLibraryCleanup.exe /dp server1.contoso.com
Příklad: Prohledávání a protokolování obsahu dp v sekundární lokalitě
ContentLibraryCleanup.exe /dp server1.contoso.com /ps siteserver1.contoso.com /sc ABC
Volitelné parametry
| Parametr | Podrobnosti |
|---|---|
/delete |
Tento parametr použijte, když jste připraveni odstranit obsah z distribučního bodu. Před odstraněním obsahu se zobrazí výzva.
Pokud tento parametr nepoužijete, nástroj zaznamená výsledky o tom, jaký obsah by odstranil. Bez tohoto parametru se ve skutečnosti neodstraní žádný obsah z distribučního bodu. |
/q |
Tento parametr spustí nástroj v tichém režimu, který potlačí všechny výzvy. Tyto výzvy zahrnují odstranění obsahu. Také se automaticky neotevře soubor protokolu. |
/ps <primary site FQDN> |
Volitelné pouze při čištění obsahu z distribučního bodu v primární lokalitě. Zadejte plně kvalifikovaný název domény primární lokality, do které distribuční bod patří. |
/sc <primary site code> |
Volitelné pouze při čištění obsahu z distribučního bodu v primární lokalitě. Zadejte kód lokality primární lokality, do které distribuční bod patří. |
/log <log file directory> |
Zadejte umístění, kam nástroj zapisuje soubor protokolu. Tímto umístěním může být místní jednotka nebo síťová sdílená složka.
Pokud tento parametr nepoužijete, nástroj umístí soubor protokolu do dočasného adresáře uživatele v počítači, na kterém je nástroj spuštěný. |
Příklad: Odstranění obsahu
ContentLibraryCleanup.exe /dp server1.contoso.com /delete
Příklad: Odstranění obsahu bez výzev
ContentLibraryCleanup.exe /q /dp server1.contoso.com /delete
Příklad: Přihlášení k místnímu disku
ContentLibraryCleanup.exe /dp server1.contoso.com /log C:\Users\Administrator\Desktop
Příklad: Přihlášení do sdílené síťové složky
ContentLibraryCleanup.exe /dp server1.contoso.com /log \\server\share
Známý problém
Ve verzi 2103 a starších může nástroj vrátit následující chybu, pokud jakýkoli balíček nebo nasazení selhalo nebo probíhá:
System.InvalidOperationException: This content library cannot be cleaned up right now because package <packageID> is not fully installed.
Chcete-li tento problém vyřešit, aktualizujte web na verzi 2107. Nástroj nedokáže spolehlivě identifikovat osamocené soubory, ale zobrazí upozornění a bude pokračovat.