Hulpprogramma voor het opschonen van inhoudsbibliotheek
Van toepassing op: Configuration Manager (current branch)
Gebruik het opdrachtregelprogramma voor het opschonen van inhoudsbibliotheek om inhoud te verwijderen die niet meer is gekoppeld aan een object op een distributiepunt. Dit type inhoud wordt zwevende inhoud genoemd. Dit hulpprogramma vervangt oudere versies van vergelijkbare hulpprogramma's die zijn uitgebracht voor eerdere Configuration Manager producten.
Het hulpprogramma is alleen van invloed op de inhoud op het distributiepunt die u opgeeft wanneer u het hulpprogramma uitvoert. Met het hulpprogramma kan geen inhoud worden verwijderd uit de inhoudsbibliotheek op de siteserver.
Als u inhoud van een distributiepunt verwijdert terwijl het sitesysteem offline is, kan er een zwevende record in WMI bestaan. Na verloop van tijd kan dit gedrag uiteindelijk leiden tot een waarschuwingsstatus op het distributiepunt. Om het probleem in versie 2006 en eerder te verhelpen, moest u de zwevende vermeldingen handmatig verwijderen uit WMI. Het maken van een fout tijdens dit proces kan leiden tot ernstigere problemen met de server. Vanaf versie 2010 kan het hulpprogramma ook zwevende inhoudsrecords verwijderen van de WMI-provider op een distributiepunt.
Zoek ContentLibraryCleanup.exe in CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup op de siteserver. Zie De map CD.Latest voor meer informatie over deze locatie.
Vereisten
Voer het hulpprogramma alleen uit op één distributiepunt tegelijk.
Voer het rechtstreeks uit op de server waarop het distributiepunt wordt gehost om op te schonen, of op afstand vanaf een andere computer.
Het hulpprogramma biedt geen ondersteuning voor het verwijderen van inhoud van de siteserver, die één inhoudsbibliotheek heeft. Wanneer de siteserver ook de distributiepuntrol heeft en een pakket niet is gericht op de server, bevindt het pakket zich nog steeds in de enkele inhoudsbibliotheek.
Het hulpprogramma biedt geen ondersteuning voor een gateway voor cloudbeheer met inhoud.
Het gebruikersaccount waarop het hulpprogramma wordt uitgevoerd, moet dezelfde machtigingen hebben als de beveiligingsrol Volledige beheerder in Configuration Manager.
Werkingsmodi
Voer het hulpprogramma uit in de volgende twee modi: Wat-als en Verwijderen.
Tip
Begin met de what-if-modus . Wanneer u tevreden bent met de resultaten, voert u het hulpprogramma uit in de verwijdermodus .
Wat-als-modus
Als u de /delete parameter niet opgeeft, wordt het hulpprogramma uitgevoerd in de what-if-modus. Deze modus identificeert de inhoud die van het distributiepunt wordt verwijderd.
Wanneer het hulpprogramma in deze modus wordt uitgevoerd, worden er geen gegevens verwijderd.
Het hulpprogramma schrijft naar het logboekbestand informatie over de inhoud die wordt verwijderd. U wordt niet gevraagd om elke mogelijke verwijdering te bevestigen.
Modus Verwijderen
Wanneer u het hulpprogramma uitvoert met de /delete parameter, wordt het hulpprogramma uitgevoerd in de verwijdermodus.
Wanneer deze modus wordt uitgevoerd, kan zwevende inhoud die op het opgegeven distributiepunt wordt gevonden, worden verwijderd uit de inhoudsbibliotheek van het distributiepunt.
Vanaf versie 2010 kunnen ook zwevende inhoudsrecords van de WMI-provider op het distributiepunt worden verwijderd.
Voordat u elk bestand verwijdert, controleert u of het door het hulpprogramma moet worden verwijderd. Selecteer Y voor Ja, N voor nee of Ja voor alles om verdere prompts over te slaan en alle zwevende inhoud te verwijderen.
Logboekbestand
Wanneer het hulpprogramma in een van beide modus wordt uitgevoerd, wordt er automatisch een logboekbestand gemaakt. Het bestand wordt een naam met de volgende informatie:
- De modus waarin het hulpprogramma wordt uitgevoerd
- De naam van het distributiepunt
- De datum en tijd van de bewerking
Wanneer het hulpprogramma is voltooid, wordt het logboekbestand automatisch geopend in Windows.
Standaard schrijft het hulpprogramma het logboekbestand naar de tijdelijke map van het gebruikersaccount waarop het hulpprogramma wordt uitgevoerd. Deze locatie bevindt zich op de computer waarop u het hulpprogramma uitvoert. Dit is niet altijd het doel van het hulpprogramma. Gebruik de /log parameter om het logboekbestand om te leiden naar een andere locatie, inclusief een netwerkshare.
Het hulpprogramma uitvoeren
Ga als volgende te werk om het hulpprogramma uit te voeren:
Open een opdrachtprompt-venster als beheerder. Wijzig de map in de map die ContentLibraryCleanup.exebevat.
Voer een opdrachtregel in met de vereiste opdrachtregelparameters en eventuele optionele parameters die u wilt gebruiken.
Opdrachtregelparameters
Gebruik deze opdrachtregelparameters in een willekeurige volgorde.
Vereiste parameters
| Parameter | Details |
|---|---|
/dp <distribution point FQDN> |
Geef de FQDN (Fully Qualified Domain Name) op van het distributiepunt dat u wilt opschonen. |
/ps <primary site FQDN> |
Alleen vereist bij het opschonen van inhoud vanaf een distributiepunt op een secundaire site. Het hulpprogramma maakt verbinding met de bovenliggende primaire site om query's uit te voeren op de SMS-provider. Met deze query's kan het hulpprogramma bepalen welke inhoud op het distributiepunt moet worden weergegeven. Vervolgens kan de zwevende inhoud worden geïdentificeerd die moet worden verwijderd. Deze verbinding met de bovenliggende primaire site moet worden gemaakt voor distributiepunten op een secundaire site, omdat de vereiste gegevens niet rechtstreeks vanaf de secundaire site beschikbaar zijn. |
/sc <primary site code> |
Alleen vereist bij het opschonen van inhoud vanaf een distributiepunt op een secundaire site. Geef de sitecode van de bovenliggende primaire site op. |
Voorbeeld: Scannen en registreren welke inhoud wordt verwijderd (what-if)
ContentLibraryCleanup.exe /dp server1.contoso.com
Voorbeeld: Inhoud scannen en registreren voor een DP op een secundaire site
ContentLibraryCleanup.exe /dp server1.contoso.com /ps siteserver1.contoso.com /sc ABC
Optionele parameters
| Parameter | Details |
|---|---|
/delete |
Gebruik deze parameter wanneer u klaar bent om inhoud van het distributiepunt te verwijderen. U wordt gevraagd om inhoud te verwijderen.
Wanneer u deze parameter niet gebruikt, registreert het hulpprogramma resultaten over welke inhoud het zou verwijderen. Zonder deze parameter wordt er geen inhoud van het distributiepunt verwijderd. |
/q |
Met deze parameter wordt het hulpprogramma uitgevoerd in een stille modus die alle prompts onderdrukt. Deze prompts omvatten wanneer inhoud wordt verwijderd. Het logboekbestand wordt ook niet automatisch geopend. |
/ps <primary site FQDN> |
Alleen optioneel bij het opschonen van inhoud vanaf een distributiepunt op een primaire site. Geef de FQDN op van de primaire site waartoe het distributiepunt behoort. |
/sc <primary site code> |
Alleen optioneel bij het opschonen van inhoud vanaf een distributiepunt op een primaire site. Geef de sitecode op van de primaire site waartoe het distributiepunt behoort. |
/log <log file directory> |
Geef de locatie op waar het hulpprogramma het logboekbestand schrijft. Deze locatie kan een lokaal station of een netwerkshare zijn.
Wanneer u deze parameter niet gebruikt, plaatst het hulpprogramma het logboekbestand in de tijdelijke map van de gebruiker op de computer waarop het hulpprogramma wordt uitgevoerd. |
Voorbeeld: Inhoud verwijderen
ContentLibraryCleanup.exe /dp server1.contoso.com /delete
Voorbeeld: Inhoud verwijderen zonder prompts
ContentLibraryCleanup.exe /q /dp server1.contoso.com /delete
Voorbeeld: Aanmelden bij lokaal station
ContentLibraryCleanup.exe /dp server1.contoso.com /log C:\Users\Administrator\Desktop
Voorbeeld: Aanmelden bij netwerkshare
ContentLibraryCleanup.exe /dp server1.contoso.com /log \\server\share
Bekend probleem
In versie 2103 en eerder kan het hulpprogramma de volgende fout retourneren wanneer een pakket of implementatie is mislukt of wordt uitgevoerd:
System.InvalidOperationException: This content library cannot be cleaned up right now because package <packageID> is not fully installed.
U kunt dit probleem omzeilen door de site bij te werken naar versie 2107. Het hulpprogramma kan zwevende bestanden niet betrouwbaar identificeren, maar geeft een waarschuwing weer en gaat door.