Tool zum Bereinigen der Inhaltsbibliothek
Gilt für: Configuration Manager (Current Branch)
Verwenden Sie das Befehlszeilentool zur Inhaltsbibliotheksbereinigung, um Inhalte zu entfernen, die nicht mehr einem Objekt auf einem Verteilungspunkt zugeordnet sind. Dieser Inhaltstyp wird als verwaister Inhalt bezeichnet. Dieses Tool ersetzt ältere Versionen ähnlicher Tools, die für frühere Configuration Manager Produkte veröffentlicht wurden.
Das Tool wirkt sich nur auf den Inhalt des Verteilungspunkts aus, den Sie beim Ausführen des Tools angeben. Das Tool kann keine Inhalte aus der Inhaltsbibliothek auf dem Standortserver entfernen.
Wenn Sie Inhalte von einem Verteilungspunkt entfernen, während das Standortsystem offline ist, kann ein verwaister Datensatz in WMI vorhanden sein. Im Laufe der Zeit kann dieses Verhalten schließlich zu einem Warnstatus auf dem Verteilungspunkt führen. Um das Problem in Version 2006 und früher zu beheben, mussten Sie die verwaisten Einträge manuell aus WMI entfernen. Wenn Sie während dieses Prozesses einen Fehler machen, kann dies zu schwerwiegenderen Problemen mit dem Server führen. Ab Version 2010 kann das Tool auch verwaiste Inhaltsdatensätze aus dem WMI-Anbieter auf einem Verteilungspunkt entfernen.
Suchen Sie ContentLibraryCleanup.exeCD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup
auf dem Standortserver. Weitere Informationen zu diesem Speicherort finden Sie unter Der Ordner "CD.Latest".
Anforderungen
Führen Sie das Tool nur für einen einzelnen Verteilungspunkt gleichzeitig aus.
Führen Sie ihn direkt auf dem Server aus, auf dem der Verteilungspunkt zum Bereinigen gehostet wird, oder remote von einem anderen Computer aus.
Das Tool unterstützt nicht das Entfernen von Inhalten vom Standortserver, der über eine einzelne Inhaltsbibliothek verfügt. Wenn der Standortserver auch über die Verteilungspunktrolle verfügt und ein Paket nicht auf den Server ausgerichtet ist, befindet sich das Paket weiterhin in der einzelnen Inhaltsbibliothek.
Das Tool unterstützt kein inhaltsfähiges Cloudverwaltungsgateway.
Das Benutzerkonto, in dem das Tool ausgeführt wird, muss über die gleichen Berechtigungen wie die Sicherheitsrolle "Volladministrator" in Configuration Manager verfügen.
Betriebsmodi
Führen Sie das Tool in den folgenden beiden Modi aus: Was-wäre-wenn und Löschen.
Tipp
Beginnen Sie mit dem Was-wäre-wenn-Modus . Wenn Sie mit den Ergebnissen zufrieden sind, führen Sie das Tool im Löschmodus aus.
Was-wäre-wenn-Modus
Wenn Sie den /delete
Parameter nicht angeben, wird das Tool im Was-wäre-wenn-Modus ausgeführt. Dieser Modus identifiziert den Inhalt, der vom Verteilungspunkt gelöscht würde.
Bei Ausführung in diesem Modus löscht das Tool keine Daten.
Das Tool schreibt In die Protokolldatei Informationen über den Inhalt, den es löschen würde. Sie werden nicht aufgefordert, jede potenzielle Löschung zu bestätigen.
Löschmodus
Wenn Sie das Tool mit dem /delete
Parameter ausführen, wird das Tool im Löschmodus ausgeführt.
Bei Ausführung in diesem Modus können verwaiste Inhalte, die auf dem angegebenen Verteilungspunkt gefunden werden, aus der Inhaltsbibliothek des Verteilungspunkts gelöscht werden.
Ab Version 2010 können auch verwaiste Inhaltsdatensätze vom WMI-Anbieter auf dem Verteilungspunkt entfernt werden.
Vergewissern Sie sich vor dem Löschen jeder Datei, dass sie vom Tool gelöscht werden soll. Wählen Sie Y für Ja, N für Nein oder Ja für alle aus, um weitere Eingabeaufforderungen zu überspringen und alle verwaisten Inhalte zu löschen.
Protokolldatei
Wenn das Tool in einem der beiden Modi ausgeführt wird, wird automatisch eine Protokolldatei erstellt. Sie benennt die Datei mit den folgenden Informationen:
- Der Modus, in dem das Tool ausgeführt wird
- Der Name des Verteilungspunkts
- Datum und Uhrzeit des Vorgangs
Wenn das Tool abgeschlossen ist, wird die Protokolldatei in Windows automatisch geöffnet.
Standardmäßig schreibt das Tool die Protokolldatei in den temporären Ordner des Benutzerkontos, das das Tool ausführt. Dieser Speicherort befindet sich auf dem Computer, auf dem Sie das Tool ausführen, was nicht immer das Ziel des Tools ist. Verwenden Sie den /log
-Parameter, um die Protokolldatei an einen anderen Speicherort umzuleiten, einschließlich einer Netzwerkfreigabe.
Ausführen des Tools
So führen Sie das Tool aus:
Öffnen Sie eine Eingabeaufforderung als Administrator. Wechseln Sie in den Ordner, der ContentLibraryCleanup.exeenthält.
Geben Sie eine Befehlszeile ein, die die erforderlichen Befehlszeilenparameter und alle optionalen Parameter enthält, die Sie verwenden möchten.
Befehlszeilenparameter
Verwenden Sie diese Befehlszeilenparameter in beliebiger Reihenfolge.
Erforderliche Parameter
Parameter | Details |
---|---|
/dp <distribution point FQDN> |
Geben Sie den vollqualifizierten Domänennamen (FQDN) des zu bereinigenden Verteilungspunkts an. |
/ps <primary site FQDN> |
Nur beim Bereinigen von Inhalten von einem Verteilungspunkt an einem sekundären Standort erforderlich. Das Tool stellt eine Verbindung mit dem übergeordneten primären Standort her, um Abfragen für den SMS-Anbieter auszuführen. Mit diesen Abfragen kann das Tool bestimmen, welcher Inhalt auf dem Verteilungspunkt enthalten sein soll. Anschließend kann der zu entfernende verwaiste Inhalt identifiziert werden. Diese Verbindung mit dem übergeordneten primären Standort muss für Verteilungspunkte an einem sekundären Standort hergestellt werden, da die erforderlichen Details nicht direkt vom sekundären Standort aus verfügbar sind. |
/sc <primary site code> |
Nur beim Bereinigen von Inhalten von einem Verteilungspunkt an einem sekundären Standort erforderlich. Geben Sie den Standortcode des übergeordneten primären Standorts an. |
Beispiel: Scannen und Protokollieren, welche Inhalte gelöscht werden (Was-wäre-wenn)
ContentLibraryCleanup.exe /dp server1.contoso.com
Beispiel: Scannen und Protokollieren von Inhalten für einen Dp an einem sekundären Standort
ContentLibraryCleanup.exe /dp server1.contoso.com /ps siteserver1.contoso.com /sc ABC
Optionale Parameter
Parameter | Details |
---|---|
/delete |
Verwenden Sie diesen Parameter, wenn Sie bereit sind, Inhalte vom Verteilungspunkt zu löschen. Sie werden vor dem Löschen von Inhalten aufgefordert. Wenn Sie diesen Parameter nicht verwenden, protokolliert das Tool Ergebnisse darüber, welche Inhalte es löschen würde. Ohne diesen Parameter werden keine Inhalte vom Verteilungspunkt gelöscht. |
/q |
Dieser Parameter führt das Tool in einem ruhigen Modus aus, der alle Eingabeaufforderungen unterdrückt. Diese Eingabeaufforderungen schließen ein, wenn Inhalte gelöscht werden. Außerdem wird die Protokolldatei nicht automatisch geöffnet. |
/ps <primary site FQDN> |
Optional nur beim Bereinigen von Inhalten von einem Verteilungspunkt an einem primären Standort. Geben Sie den FQDN des primären Standorts an, zu dem der Verteilungspunkt gehört. |
/sc <primary site code> |
Optional nur beim Bereinigen von Inhalten von einem Verteilungspunkt an einem primären Standort. Geben Sie den Standortcode des primären Standorts an, zu dem der Verteilungspunkt gehört. |
/log <log file directory> |
Geben Sie den Speicherort an, an dem das Tool die Protokolldatei schreibt. Dieser Speicherort kann ein lokales Laufwerk oder eine Netzwerkfreigabe sein. Wenn Sie diesen Parameter nicht verwenden, platziert das Tool die Protokolldatei im temporären Verzeichnis des Benutzers auf dem Computer, auf dem das Tool ausgeführt wird. |
Beispiel: Löschen von Inhalten
ContentLibraryCleanup.exe /dp server1.contoso.com /delete
Beispiel: Löschen von Inhalten ohne Eingabeaufforderungen
ContentLibraryCleanup.exe /q /dp server1.contoso.com /delete
Beispiel: Protokollieren auf lokalem Laufwerk
ContentLibraryCleanup.exe /dp server1.contoso.com /log C:\Users\Administrator\Desktop
Beispiel: Protokollieren bei der Netzwerkfreigabe
ContentLibraryCleanup.exe /dp server1.contoso.com /log \\server\share
Bekanntes Problem
In Version 2103 und früher gibt das Tool möglicherweise den folgenden Fehler zurück, wenn ein Paket oder eine Bereitstellung fehlgeschlagen ist oder gerade ausgeführt wird:
System.InvalidOperationException: This content library cannot be cleaned up right now because package <packageID> is not fully installed.
Um dieses Problem zu umgehen, aktualisieren Sie die Website auf Version 2107. Das Tool kann verwaiste Dateien nicht zuverlässig identifizieren, zeigt jedoch eine Warnung an, und der Vorgang wird fortgesetzt.