Ferramenta de limpeza da biblioteca de conteúdo

Aplica-se a: Gerenciador de Configurações (branch atual)

Use a ferramenta de linha de comando de limpeza da biblioteca de conteúdo para remover conteúdo que não está mais associado a um objeto em um ponto de distribuição. Esse tipo de conteúdo é chamado de conteúdo órfão. Essa ferramenta substitui versões mais antigas de ferramentas semelhantes lançadas para produtos Configuration Manager anteriores.

A ferramenta afeta apenas o conteúdo no ponto de distribuição que você especifica ao executar a ferramenta. A ferramenta não pode remover conteúdo da biblioteca de conteúdo no servidor do site.

Se você remover conteúdo de um ponto de distribuição enquanto o sistema de sites estiver offline, um registro órfão poderá existir na WMI. Com o tempo, esse comportamento pode eventualmente levar a um status de aviso no ponto de distribuição. Para atenuar o problema na versão 2006 e anterior, você precisou remover manualmente as entradas órfãs da WMI. Cometer um erro durante esse processo pode causar problemas mais graves com o servidor. A partir da versão 2010, a ferramenta também pode remover registros de conteúdo órfãos do provedor WMI em um ponto de distribuição.

Encontre ContentLibraryCleanup.exe no CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup servidor do site. Para obter mais informações sobre esse local, consulte A pasta CD.Latest.

Requisitos

• Execute a ferramenta somente em um único ponto de distribuição por vez.

• Execute-o diretamente no servidor que hospeda o ponto de distribuição para limpar ou remotamente de outro computador.

• A ferramenta não dá suporte à remoção de conteúdo do servidor do site, que tem uma única biblioteca de conteúdo. Quando o servidor do site também tem a função de ponto de distribuição, se um pacote não for direcionado ao servidor, o pacote ainda estará na biblioteca de conteúdo único.

• A ferramenta não dá suporte a um gateway de gerenciamento de nuvem habilitado para conteúdo.

• A conta de usuário que executa a ferramenta deve ter permissões iguais à função de segurança do Administrador Completo em Configuration Manager.

Modos de operação

Execute a ferramenta nos dois modos a seguir: E-se e Excluir.

Dica

Comece com o modo what-if . Quando você estiver satisfeito com os resultados, execute a ferramenta no modo de exclusão .

Modo what-if

Se você não especificar o /delete parâmetro, a ferramenta será executada no modo what-if. Esse modo identifica o conteúdo que seria excluído do ponto de distribuição.

• Quando executada nesse modo, a ferramenta não exclui nenhum dado.

• A ferramenta grava no arquivo de log informações sobre o conteúdo que ele excluiria. Você não foi solicitado a confirmar cada exclusão em potencial.

Modo Excluir

Quando você executa a ferramenta com o /delete parâmetro, a ferramenta é executada no modo de exclusão.

• Quando executado nesse modo, o conteúdo órfão encontrado no ponto de distribuição especificado pode ser excluído da biblioteca de conteúdo do ponto de distribuição.

• A partir da versão 2010, ele também pode remover registros de conteúdo órfãos do provedor WMI no ponto de distribuição.

• Antes de excluir cada arquivo, confirme se a ferramenta deve excluí-lo. Selecione Y para sim, N para não ou Sim para todos para ignorar novas solicitações e excluir todo o conteúdo órfão.

Arquivo de log

Quando a ferramenta é executada em qualquer modo, ela cria automaticamente um arquivo de log. Ele nomeia o arquivo com as seguintes informações:

• O modo em que a ferramenta é executada
• O nome do ponto de distribuição
• A data e a hora da operação

Quando a ferramenta for concluída, ela abre automaticamente o arquivo de log no Windows.

Por padrão, a ferramenta grava o arquivo de log na pasta temporária da conta de usuário que executa a ferramenta. Esse local está no computador em que você executa a ferramenta, que nem sempre é o destino da ferramenta. Use o /log parâmetro para redirecionar o arquivo de log para outro local, incluindo um compartilhamento de rede.

Executar a ferramenta

Para executar a ferramenta:

1. Abra um prompt de comando como administrador. Altere o diretório para a pasta que contém ContentLibraryCleanup.exe.

2. Insira uma linha de comando que inclua os parâmetros de linha de comando necessários e todos os parâmetros opcionais que você deseja usar.

Parâmetros de linha de comando

Use esses parâmetros de linha de comando em qualquer ordem.

Parâmetros obrigatórios

Parâmetro	Detalhes
/dp <distribution point FQDN>	Especifique o FQDN (nome de domínio totalmente qualificado) do ponto de distribuição a ser limpo.
/ps <primary site FQDN>	Necessário somente ao limpar conteúdo de um ponto de distribuição em um site secundário. A ferramenta se conecta ao site primário pai para executar consultas no Provedor de SMS. Essas consultas permitem que a ferramenta determine qual conteúdo deve estar no ponto de distribuição. Em seguida, ele pode identificar o conteúdo órfão a ser removido. Essa conexão com o site primário pai deve ser feita para pontos de distribuição em um site secundário porque os detalhes necessários não estão disponíveis diretamente do site secundário.
/sc <primary site code>	Necessário somente ao limpar conteúdo de um ponto de distribuição em um site secundário. Especifique o código do site primário pai.

Exemplo: verificar e registrar o conteúdo que ele excluiria (e se)

ContentLibraryCleanup.exe /dp server1.contoso.com

Exemplo: verificar e registrar conteúdo de um DP em um site secundário

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

Parâmetros opcionais

Parâmetro	Detalhes
/delete	Use esse parâmetro quando estiver pronto para excluir o conteúdo do ponto de distribuição. Ele solicita que você exclua o conteúdo. Quando você não usa esse parâmetro, a ferramenta registra resultados sobre qual conteúdo ele excluiria. Sem esse parâmetro, ele não exclui nenhum conteúdo do ponto de distribuição.
/q	Esse parâmetro executa a ferramenta em um modo silencioso que suprime todos os prompts. Esses prompts incluem quando ele exclui o conteúdo. Ele também não abre automaticamente o arquivo de log.
/ps <primary site FQDN>	Opcional somente ao limpar conteúdo de um ponto de distribuição em um site primário. Especifique o FQDN do site primário ao qual o ponto de distribuição pertence.
/sc <primary site code>	Opcional somente ao limpar conteúdo de um ponto de distribuição em um site primário. Especifique o código do site primário ao qual o ponto de distribuição pertence.
/log <log file directory>	Especifique o local em que a ferramenta grava o arquivo de log. Esse local pode ser uma unidade local ou um compartilhamento de rede. Quando você não usa esse parâmetro, a ferramenta coloca o arquivo de log no diretório temporário do usuário no computador em que a ferramenta é executada.

Exemplo: excluir conteúdo

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

Exemplo: excluir conteúdo sem prompts

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

Exemplo: Fazer logon na unidade local

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

Exemplo: Log para compartilhamento de rede

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

Problema conhecido

Na versão 2103 e anterior, quando qualquer pacote ou implantação tiver falhado ou estiver em andamento, a ferramenta poderá retornar o seguinte erro:

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

Para contornar esse problema, atualize o site para a versão 2107. A ferramenta não pode identificar arquivos órfãos de maneira confiável, mas exibirá um aviso e continuará.