Strumento di pulizia della raccolta contenuto

Si applica a: Configuration Manager (Current Branch)

Usare lo strumento da riga di comando di pulizia della libreria di contenuto per rimuovere il contenuto non più associato a un oggetto in un punto di distribuzione. Questo tipo di contenuto è denominato contenuto orfano. Questo strumento sostituisce le versioni precedenti di strumenti simili rilasciati per i prodotti Configuration Manager precedenti.

Lo strumento influisce solo sul contenuto del punto di distribuzione specificato quando si esegue lo strumento. Lo strumento non può rimuovere il contenuto dalla raccolta contenuto nel server del sito.

Se si rimuove il contenuto da un punto di distribuzione mentre il sistema del sito è offline, in WMI può esistere un record orfano. Nel corso del tempo, questo comportamento può portare a uno stato di avviso nel punto di distribuzione. Per attenuare il problema nella versione 2006 e precedenti, è stato necessario rimuovere manualmente le voci orfane da WMI. L'errore durante questo processo potrebbe causare problemi più gravi con il server. A partire dalla versione 2010, lo strumento può anche rimuovere i record di contenuto orfani dal provider WMI in un punto di distribuzione.

Trovare ContentLibraryCleanup.exe nel CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup server del sito. Per altre informazioni su questo percorso, vedere La cartella CD.Latest.

Requisiti

  • Eseguire lo strumento solo su un singolo punto di distribuzione alla volta.

  • Eseguirlo direttamente nel server che ospita il punto di distribuzione per eseguire la pulizia o in remoto da un altro computer.

  • Lo strumento non supporta la rimozione di contenuto dal server del sito, che dispone di una singola raccolta contenuto. Quando il server del sito ha anche il ruolo del punto di distribuzione, se un pacchetto non è destinato al server, il pacchetto è ancora nella singola raccolta contenuto.

  • Lo strumento non supporta un gateway di gestione cloud abilitato per il contenuto.

  • L'account utente che esegue lo strumento deve avere autorizzazioni uguali al ruolo di sicurezza Amministratore completo in Configuration Manager.

Modalità di funzionamento

Eseguire lo strumento nelle due modalità seguenti: What-if ed Delete.

Consiglio

Iniziare con la modalità simulazione . Quando si è soddisfatti dei risultati, eseguire lo strumento in modalità di eliminazione .

Modalità di simulazione

Se non si specifica il /delete parametro , lo strumento viene eseguito in modalità simulazione. Questa modalità identifica il contenuto che verrebbe eliminato dal punto di distribuzione.

  • Quando viene eseguito in questa modalità, lo strumento non elimina dati.

  • Lo strumento scrive nel file di log informazioni sul contenuto che eliminerebbe. Non viene richiesto di confermare ogni potenziale eliminazione.

Modalità di eliminazione

Quando si esegue lo strumento con il /delete parametro , lo strumento viene eseguito in modalità di eliminazione.

  • Quando viene eseguito in questa modalità, il contenuto orfano trovato nel punto di distribuzione specificato può essere eliminato dalla raccolta contenuto del punto di distribuzione.

  • A partire dalla versione 2010, può anche rimuovere i record di contenuto orfani dal provider WMI nel punto di distribuzione.

  • Prima di eliminare ogni file, verificare che lo strumento debba eliminarlo. Selezionare Y per sì, N per no o Sì a tutti per ignorare ulteriori richieste ed eliminare tutto il contenuto orfano.

File di log

Quando lo strumento viene eseguito in entrambe le modalità, crea automaticamente un file di log. Assegna al file il nome con le informazioni seguenti:

  • Modalità in cui viene eseguito lo strumento
  • Nome del punto di distribuzione
  • Data e ora dell'operazione

Al termine, lo strumento apre automaticamente il file di log in Windows.

Per impostazione predefinita, lo strumento scrive il file di log nella cartella temporanea dell'account utente che esegue lo strumento. Questa posizione si trova nel computer in cui si esegue lo strumento, che non è sempre la destinazione dello strumento. Usare il /log parametro per reindirizzare il file di log a un altro percorso, inclusa una condivisione di rete.

Eseguire lo strumento

Per lanciare lo strumento:

  1. Aprire una finestra del prompt dei comandi come amministratore. Modificare la directory nella cartella che contiene ContentLibraryCleanup.exe.

  2. Immettere una riga di comando che includa i parametri della riga di comando necessari e tutti i parametri facoltativi che si desidera usare.

Parametri della riga di comando

Usare questi parametri della riga di comando in qualsiasi ordine.

Parametri obbligatori

Parametro Dettagli
/dp <distribution point FQDN> Specificare il nome di dominio completo (FQDN) del punto di distribuzione da pulire.
/ps <primary site FQDN> Obbligatorio solo quando si pulisce il contenuto da un punto di distribuzione in un sito secondario. Lo strumento si connette al sito primario padre per eseguire query sul provider SMS. Queste query consentono allo strumento di determinare quale contenuto deve trovarsi nel punto di distribuzione. Può quindi identificare il contenuto orfano da rimuovere. Questa connessione al sito primario padre deve essere eseguita per i punti di distribuzione in un sito secondario perché i dettagli richiesti non sono disponibili direttamente dal sito secondario.
/sc <primary site code> Obbligatorio solo quando si pulisce il contenuto da un punto di distribuzione in un sito secondario. Specificare il codice del sito primario padre.

Esempio: analizzare e registrare il contenuto che eliminerebbe (what-if)

ContentLibraryCleanup.exe /dp server1.contoso.com

Esempio: Analizzare e registrare il contenuto di un DP in un sito secondario

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

Parametri facoltativi

Parametro Dettagli
/delete Usare questo parametro quando si è pronti per eliminare il contenuto dal punto di distribuzione. Viene richiesto prima di eliminare il contenuto.

Quando non si usa questo parametro, lo strumento registra i risultati sul contenuto che eliminerebbe. Senza questo parametro, in realtà non elimina alcun contenuto dal punto di distribuzione.
/q Questo parametro esegue lo strumento in modalità non interattiva che elimina tutte le richieste. Queste richieste includono quando elimina il contenuto. Inoltre, non apre automaticamente il file di log.
/ps <primary site FQDN> Facoltativo solo quando si pulisce il contenuto da un punto di distribuzione in un sito primario. Specificare il nome di dominio completo del sito primario a cui appartiene il punto di distribuzione.
/sc <primary site code> Facoltativo solo quando si pulisce il contenuto da un punto di distribuzione in un sito primario. Specificare il codice del sito primario a cui appartiene il punto di distribuzione.
/log <log file directory> Specificare il percorso in cui lo strumento scrive il file di log. Questo percorso può essere un'unità locale o una condivisione di rete.

Quando non si usa questo parametro, lo strumento inserisce il file di log nella directory temporanea dell'utente nel computer in cui viene eseguito lo strumento.

Esempio: Eliminare il contenuto

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

Esempio: Eliminare il contenuto senza richieste

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

Esempio: Accedere all'unità locale

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

Esempio: Accedere alla condivisione di rete

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

Problema noto

Nella versione 2103 e versioni precedenti, quando un pacchetto o una distribuzione non è riuscita o è in corso, lo strumento potrebbe restituire l'errore seguente:

System.InvalidOperationException: This content library cannot be cleaned up right now because package <packageID> is not fully installed.

Per risolvere questo problema, aggiornare il sito alla versione 2107. Lo strumento non è in grado di identificare in modo affidabile i file orfani, ma visualizza un avviso e continua.