Partilhar via


Ferramenta de limpeza da biblioteca de conteúdos

Aplica-se a: Configuration Manager (ramo atual)

Utilize a ferramenta de linha de comando de limpeza da biblioteca de conteúdos para remover conteúdos que já não estão associados a um objeto num ponto de distribuição. Este tipo de conteúdo é chamado de conteúdo órfão. Esta ferramenta substitui versões mais antigas de ferramentas similares lançadas para produtos anteriores do Gestor de Configuração.

A ferramenta apenas afeta o conteúdo do ponto de distribuição que especifica quando executa a ferramenta. A ferramenta não pode remover o conteúdo da biblioteca de conteúdos no servidor do site.

Se remover o conteúdo de um ponto de distribuição enquanto o sistema do site estiver offline, pode existir um registo órfão no WMI. Com o tempo, este comportamento pode eventualmente levar a um estado de aviso no ponto de distribuição. Para atenuar o problema na versão de 2006 e mais cedo, teve de remover manualmente as entradas órfãs do WMI. Cometer um erro durante este processo pode causar problemas mais graves com o servidor. A partir da versão 2010, a ferramenta também pode remover registos de conteúdo órfão do fornecedor de WMI num ponto de distribuição.

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

Requisitos

  • Apenas faça a ferramenta contra um único ponto de distribuição de cada vez.

  • Executá-lo diretamente no servidor que hospeda o ponto de distribuição para limpar, ou remotamente a partir de outro computador.

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

  • A ferramenta não suporta uma porta de gestão de nuvem ativada por conteúdos.

  • A conta de utilizador que executa a ferramenta deve ter permissões iguais à função de segurança full Administrator no Gestor de Configuração.

Modos de funcionamento

Executar a ferramenta nos dois modos seguintes: E se e Eliminar.

Dica

Comece com o modo "e se". Quando estiver satisfeito com os resultados, em seguida, executar a ferramenta no modo de exclusão.

E se o modo

Se não especificar o /delete parâmetro, a ferramenta funciona no modo "e se". Este modo identifica o conteúdo que seria eliminado do ponto de distribuição.

  • Quando é executada neste modo, a ferramenta não apaga quaisquer dados.

  • A ferramenta escreve para a informação do ficheiro de registo sobre o conteúdo que iria eliminar. Não é solicitado que confirme cada possível supressão.

Eliminar o modo

Quando executa a ferramenta com o /delete parâmetro, a ferramenta funciona no modo de exclusão.

  • Quando executado neste modo, o conteúdo órfão que encontra no ponto de distribuição especificado pode ser eliminado da biblioteca de conteúdos do ponto de distribuição.

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

  • Antes de eliminar cada ficheiro, confirme que a ferramenta deve eliminá-la. Selecione Y para sim, N para não, ou Sim a todos para saltar mais pedidos e apagar todos os conteúdos órfãos.

Ficheiro de registo

Quando a ferramenta funciona em ambos os modos, cria automaticamente um ficheiro de registo. Ele nomeia o ficheiro com as seguintes informações:

  • O modo em que a ferramenta funciona
  • O nome do ponto de distribuição
  • A data e hora de funcionamento

Quando a ferramenta termina, abre automaticamente o ficheiro de registo Windows.

Por predefinição, a ferramenta escreve o ficheiro de registo na pasta temporária da conta de utilizador que executa a ferramenta. Esta localização está no computador onde executa a ferramenta, que nem sempre é o alvo da ferramenta. Utilize o /log parâmetro para redirecionar o ficheiro de registo para outro local, incluindo uma partilha de rede.

Executar a ferramenta

Para executar a ferramenta:

  1. Abra uma linha de comandos como administrador. Altere o diretório para a pasta que contém ContentLibraryCleanup.exe.

  2. Introduza uma linha de comando que inclua os parâmetros de linha de comando necessáriose quaisquer parâmetros opcionais que pretenda utilizar.

Parâmetros da linha de comandos

Utilize estes parâmetros de linha de comando em qualquer ordem.

Parâmetros necessários

Parâmetro Detalhes
/dp <distribution point FQDN> Especifique o nome de domínio totalmente qualificado (FQDN) do ponto de distribuição para limpar.
/ps <primary site FQDN> Só é necessário para a limpeza do conteúdo de um ponto de distribuição num local secundário. A ferramenta liga-se ao local principal dos pais para executar consultas contra o Fornecedor DE SMS. Estas consultas permitem que a ferramenta determine o conteúdo que deve estar no ponto de distribuição. Pode então identificar o conteúdo órfão para remover. Esta ligação ao local principal dos pais deve ser feita para pontos de distribuição num site secundário porque os dados necessários não estão disponíveis diretamente a partir do site secundário.
/sc <primary site code> Só é necessário para a limpeza do conteúdo de um ponto de distribuição num local secundário. Especifique o código do site do local principal dos pais.

Exemplo: Digitalizar e registar o conteúdo que eliminaria (e se)

ContentLibraryCleanup.exe /dp server1.contoso.com

Exemplo: Digitalizar e registar conteúdo para um DP num site secundário

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

Parâmetros opcionais

Parâmetro Detalhes
/delete Utilize este parâmetro quando estiver pronto para eliminar o conteúdo do ponto de distribuição. Solicita-lhe antes de apagar o conteúdo.

Quando não utiliza este parâmetro, a ferramenta regista os resultados sobre o conteúdo que eliminaria. Sem este parâmetro, na verdade não apaga qualquer conteúdo do ponto de distribuição.
/q Este parâmetro executa a ferramenta num modo silencioso que suprime todas as solicitações. Estas indicações incluem quando elimina o conteúdo. Também não abre automaticamente o ficheiro de registo.
/ps <primary site FQDN> Opcional apenas para limpar o conteúdo de um ponto de distribuição num local primário. Especificar o FQDN do local primário a que pertence o ponto de distribuição.
/sc <primary site code> Opcional apenas para limpar o conteúdo de um ponto de distribuição num local primário. Especifique o código do site do local primário a que pertence o ponto de distribuição.
/log <log file directory> Especifique o local onde a ferramenta escreve o ficheiro de registo. Esta localização pode ser uma unidade local ou uma partilha de rede.

Quando não utiliza este parâmetro, a ferramenta coloca o ficheiro de registo no diretório temporário do utilizador no computador onde a ferramenta funciona.

Exemplo: Eliminar conteúdo

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

Exemplo: Eliminar conteúdo sem solicitações

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

Exemplo: Faça login na unidade local

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

Exemplo: Registar para a partilha de rede

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

Problema conhecido

Na versão 2103 e antes, quando qualquer pacote ou implantação falhou, ou está em curso, a ferramenta pode devolver o seguinte erro:

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

Para contornar este problema, atualize o site para a versão 2107. A ferramenta não pode identificar de forma fiável ficheiros órfãos, mas irá apresentar um aviso e continuar.