Rensningsverktyg för innehållsbibliotek
Gäller för: Konfigurationshanteraren (current branch)
Använd kommandoradsverktyget för rensning av innehållsbibliotek för att ta bort innehåll som inte längre är associerat med ett objekt på en distributionsplats. Den här typen av innehåll kallas för överblivet innehåll. Det här verktyget ersätter äldre versioner av liknande verktyg som släppts för tidigare Configuration Manager produkter.
Verktyget påverkar bara innehållet på den distributionsplats som du anger när du kör verktyget. Verktyget kan inte ta bort innehåll från innehållsbiblioteket på platsservern.
Om du tar bort innehåll från en distributionsplats medan platssystemet är offline kan det finnas en överbliven post i WMI. Med tiden kan det här beteendet så småningom leda till en varningsstatus på distributionsplatsen. För att åtgärda problemet i version 2006 och tidigare var du tvungen att manuellt ta bort de överblivna posterna från WMI. Att göra ett misstag under den här processen kan orsaka allvarligare problem med servern. Från och med version 2010 kan verktyget även ta bort överblivna innehållsposter från WMI-providern på en distributionsplats.
Hitta ContentLibraryCleanup.exe på CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup platsservern. Mer information om den här platsen finns i mappen CD.Latest.
Krav
Kör endast verktyget mot en enda distributionsplats i taget.
Kör den direkt på den server som är värd för distributionsplatsen för att rensa eller fjärransluta från en annan dator.
Verktyget stöder inte borttagning av innehåll från platsservern, som har ett enda innehållsbibliotek. När platsservern också har distributionsplatsrollen finns paketet fortfarande i det enda innehållsbiblioteket om ett paket inte är riktat till servern.
Verktyget stöder inte en innehållsaktiverad molnhanteringsgateway.
Användarkontot som kör verktyget måste ha samma behörigheter som säkerhetsrollen Fullständig administratör i Configuration Manager.
Driftlägen
Kör verktyget i följande två lägen: What-if och Delete.
Tips
Börja med what-if-läget . När du är nöjd med resultatet kör du verktyget i borttagningsläge .
Konsekvensläge
Om du inte anger parametern /delete körs verktyget i konsekvensläge. Det här läget identifierar det innehåll som skulle tas bort från distributionsplatsen.
När du kör i det här läget tar verktyget inte bort några data.
Verktyget skriver till loggfilsinformationen om innehållet som det skulle ta bort. Du uppmanas inte att bekräfta varje potentiell borttagning.
Ta bort läge
När du kör verktyget med parametern /delete körs verktyget i borttagningsläge.
När det körs i det här läget kan överblivet innehåll som hittas på den angivna distributionsplatsen tas bort från distributionsplatsens innehållsbibliotek.
Från och med version 2010 kan den även ta bort överblivna innehållsposter från WMI-providern på distributionsplatsen.
Innan du tar bort varje fil kontrollerar du att verktyget ska ta bort den. Välj Y för ja, N för nej eller Ja till alla för att hoppa över ytterligare frågor och ta bort allt överblivet innehåll.
Loggfil
När verktyget körs i båda lägena skapas automatiskt en loggfil. Filen namnges med följande information:
- Läget som verktyget körs i
- Namnet på distributionsplatsen
- Datum och tid för åtgärden
När verktyget är klart öppnas loggfilen automatiskt i Windows.
Som standard skriver verktyget loggfilen till temp-mappen för det användarkonto som kör verktyget. Den här platsen finns på den dator där du kör verktyget, som inte alltid är målet för verktyget. Använd parametern /log för att omdirigera loggfilen till en annan plats, inklusive en nätverksresurs.
Kör verktyget
Så här kör du verktyget:
Öppna en kommandotolk som administratör. Ändra katalogen till mappen som innehåller ContentLibraryCleanup.exe.
Ange en kommandorad som innehåller nödvändiga kommandoradsparametrar och valfria parametrar som du vill använda.
Kommandoradsparametrar
Använd dessa kommandoradsparametrar i valfri ordning.
Obligatoriska parametrar
| Parameter | Information |
|---|---|
/dp <distribution point FQDN> |
Ange det fullständigt kvalificerade domännamnet (FQDN) för distributionsplatsen som ska rensas. |
/ps <primary site FQDN> |
Krävs endast vid rensning av innehåll från en distributionsplats på en sekundär plats. Verktyget ansluter till den överordnade primära platsen för att köra frågor mot SMS-providern. Med de här frågorna kan verktyget avgöra vilket innehåll som ska finnas på distributionsplatsen. Den kan sedan identifiera det överblivna innehållet som ska tas bort. Den här anslutningen till den överordnade primära platsen måste göras för distributionsplatser på en sekundär plats eftersom nödvändig information inte är tillgänglig direkt från den sekundära platsen. |
/sc <primary site code> |
Krävs endast vid rensning av innehåll från en distributionsplats på en sekundär plats. Ange platskoden för den överordnade primära platsen. |
Exempel: Skanna och logga vilket innehåll det skulle ta bort (konsekvensanalys)
ContentLibraryCleanup.exe /dp server1.contoso.com
Exempel: Skanna och logga innehåll för en DP på en sekundär plats
ContentLibraryCleanup.exe /dp server1.contoso.com /ps siteserver1.contoso.com /sc ABC
Valfria parametrar
| Parameter | Information |
|---|---|
/delete |
Använd den här parametern när du är redo att ta bort innehåll från distributionsplatsen. Du uppmanas att göra det innan innehållet tas bort.
När du inte använder den här parametern loggar verktyget resultat om vilket innehåll det skulle ta bort. Utan den här parametern tar den inte bort något innehåll från distributionsplatsen. |
/q |
Den här parametern kör verktyget i ett tyst läge som undertrycker alla frågor. Dessa uppmaningar inkluderar när det tar bort innehåll. Loggfilen öppnas inte heller automatiskt. |
/ps <primary site FQDN> |
Valfritt endast vid rensning av innehåll från en distributionsplats på en primär plats. Ange FQDN för den primära plats som distributionsplatsen tillhör. |
/sc <primary site code> |
Valfritt endast vid rensning av innehåll från en distributionsplats på en primär plats. Ange platskoden för den primära platsen som distributionsplatsen tillhör. |
/log <log file directory> |
Ange den plats där verktyget skriver loggfilen. Den här platsen kan vara en lokal enhet eller en nätverksresurs.
När du inte använder den här parametern placerar verktyget loggfilen i användarens temp-katalog på den dator där verktyget körs. |
Exempel: Ta bort innehåll
ContentLibraryCleanup.exe /dp server1.contoso.com /delete
Exempel: Ta bort innehåll utan frågor
ContentLibraryCleanup.exe /q /dp server1.contoso.com /delete
Exempel: Logga till lokal enhet
ContentLibraryCleanup.exe /dp server1.contoso.com /log C:\Users\Administrator\Desktop
Exempel: Logga till nätverksresurs
ContentLibraryCleanup.exe /dp server1.contoso.com /log \\server\share
Känt problem
I version 2103 och tidigare, när ett paket eller en distribution har misslyckats eller pågår, kan verktyget returnera följande fel:
System.InvalidOperationException: This content library cannot be cleaned up right now because package <packageID> is not fully installed.
Du kan lösa det här problemet genom att uppdatera webbplatsen till version 2107. Verktyget kan inte identifiera överblivna filer på ett tillförlitligt sätt, men visar en varning och fortsätter.