A ferramenta de limpeza de biblioteca de conteúdos para o System Center Configuration ManagerThe Content library cleanup tool for System Center Configuration Manager

Aplica-se a: O System Center Configuration Manager (ramo atual)Applies to: System Center Configuration Manager (Current Branch)

A partir da versão 1702, pode utilizar uma ferramenta de linha de comandos (ContentLibraryCleanup.exe) remover o conteúdo que é mais longa não associados a qualquer pacote ou aplicação a partir de um ponto de distribuição (órfãos conteúdo).Beginning with version 1702, you can use a command line tool (ContentLibraryCleanup.exe) to remove content that is no-longer associated with any package or application from a distribution point (orphaned content). Esta ferramenta chama-se a ferramenta de limpeza da biblioteca de conteúdos e substitui versões mais antigas do ferramentas semelhantes lançadas para produtos anteriores do Configuration Manager.This tool is called the content library cleanup tool, and replaces older versions of similar tools released for past Configuration Manager products.

A ferramenta afeta apenas o conteúdo no ponto de distribuição que especificou quando executa a ferramenta.The tool only affects the content on the distribution point that you specify when you run the tool. A ferramenta não é possível remover o conteúdo da biblioteca de conteúdos no servidor do site.The tool cannot remove content from the content library on the site server.

Pode encontrar ContentLibraryCleanup.exe no %CM_Installation_Path%\cd.latest\SMSSETUP\TOOLS\ContentLibraryCleanup\ pasta no servidor do site num site de administração central ou site primário.You can find ContentLibraryCleanup.exe in the %CM_Installation_Path%\cd.latest\SMSSETUP\TOOLS\ContentLibraryCleanup\ folder on the site server at a central administration site or primary site.

RequisitosRequirements

A ferramenta apenas pode ser executadas em relação a um único ponto de distribuição cada vez.The tool can only run against a single distribution point at a time.

  • -Pode executar diretamente no computador que aloja o ponto de distribuição que pretende limpar ou remotamente a partir de outro servidor.It can run directly on the computer that hosts the distribution point you want to clean, or remotely from another server.
  • A conta de utilizador que executa a ferramenta tem de ter permissões de administração baseada em funções direta iguais a um administrador total na hierarquia do Configuration Manager.The user account that runs the tool must have direct role-based administration permissions that are equal to a Full Administrator on the Configuration Manager hierarchy. A ferramenta não funciona quando a conta recebe estas permissões como membro de um grupo de segurança do Windows que tem as permissões de administrador global.The tool does not work when the account receives these permissions as a member of a Windows security group that has the Full Administrator permissions.

Modos de funcionamentoModes of operation

Pode executar a ferramenta nos seguintes dois modos.You can run the tool in the following two modes. Recomendamos que execute a ferramenta hipóteses modo de modo a poder rever os resultados antes de executar a ferramenta no eliminar modo:We recommend you run the tool in What-If mode so you can review the results before you run the tool in delete mode:

  1. Modo de hipóteses:What-If mode:
    Se não especificar o /eliminar comutador, a ferramenta é executada no modo de hipóteses e identifica o conteúdo que seria eliminado do ponto de distribuição.If you do not specify the /delete switch, the tool runs in What-If mode and identifies the content that would be deleted from the distribution point.

    • Quando executar neste modo a ferramenta não elimina quaisquer dados.When run in this mode the tool does not delete any data.
    • As informações sobre o conteúdo que seria eliminado são escritas para o ficheiro de registo de ferramentas e não-á pedido para confirmar cada eliminação potencial.Information about the content that would be deleted is written to the tools log file, and you are not prompted to confirm each potential deletion.
  2. Eliminar modo:Delete mode:
    Quando executa a ferramenta com a /eliminar comutador, a ferramenta é executada no modo de eliminação.When you run the tool with the /delete switch, the tool runs in delete mode.

    • Quando executar neste modo, conteúdo órfão que se encontra no ponto de distribuição especificado pode ser eliminado da biblioteca de conteúdos do ponto de distribuição.When run in this mode, orphaned content that is found on the specified distribution point can be deleted from the distribution point’s content library.
    • Antes de eliminar cada ficheiro, tem de confirmar que o ficheiro deve ser eliminado.Before deleting each file, you must confirm that the file should be deleted. Pode selecionar, Y para Sim, N para não, ou Sim a todos os para ignorar avisos adicionais e eliminar conteúdo órfão tudo.You can select, Y for yes, N for no, or Yes to all to skip further prompts and delete all orphaned content.

Quando a ferramenta é executada no modo de ambos, cria automaticamente um registo com um nome que inclua o modo da que ferramenta é executada no nome do ponto de distribuição e a data e hora da operação.When the tool runs in either mode, it automatically creates a log with a name that includes the mode the tool runs in, the name of the distribution point, and the date and time of operation. O ficheiro de registo aberto automaticamente quando a ferramenta de conclusão.The log file automatically opens when the tool finishes.

Por predefinição, o ficheiro de registo é escrito para a pasta temporária da conta de utilizador que executa a ferramenta, no computador onde a ferramenta é executada.By default, the log file is written to the temp folder of the user account that runs the tool, on the computer where the tool is run. Pode utilizar o /registo comutador para redirecionar o ficheiro de registo para outra localização, incluindo uma partilha de rede.You can use the /log switch to redirect the log file to another location, including a network share.

Execute a ferramentaRun the tool

Para executar a ferramenta:To run the tool:

  1. Abra uma linha de comandos administrativa para uma pasta que contém ContentLibraryCleanup.exe.Open an administrative command prompt to a folder that contains ContentLibraryCleanup.exe.
  2. Em seguida, introduza uma linha de comandos que inclui os parâmetros de linha de comandos necessário e parâmetros opcionais que pretende utilizar.Next, enter a command line that includes the required command line switches, and optional switches you want to use.

Conhecido problema quando a ferramenta é executada, poderá ser devolvido um erro semelhante ao seguinte quando qualquer pacote de implementação falhou ou está em curso:Known issue When the tool is run, an error like the following might be returned when any package or deployment has failed, or is in progress:

  • System.InvalidOperationException: Esta biblioteca de conteúdos não é possível limpar neste momento porque o pacote não está completamente instalado.System.InvalidOperationException: This content library cannot be cleaned up right now because package is not fully installed.

Solução: Nenhuma.Workaround: None. A ferramenta não é possível fiável identificar ficheiros órfãos quando o conteúdo está em curso ou falhou implementar.The tool cannot reliable identify orphaned files when content is in progress or has failed to deploy. Por conseguinte, a ferramenta não permitirá ao conteúdo de limpeza até que esse problema seja resolvido.Therefore, the tool will not allow you to clean-up content until that issue is resolved.

Parâmetros de linha de comandosCommand line switches

Os seguintes parâmetros de linha de comandos podem ser utilizados por qualquer ordem.The following command line switches can be used in any order.

ParâmetroSwitch DetalhesDetails
/DELETE/delete OpcionalOptional
Utilize este parâmetro quando pretender eliminar o conteúdo do ponto de distribuição.Use this switch when you want to delete content from the distribution point. -Á antes do conteúdo é eliminado.You are prompted before content is deleted.

Quando este comutador não é utilizado, a ferramenta regista resultados sobre o conteúdo que seria eliminado, mas não eliminar o conteúdo do ponto de distribuição.When this switch is not used, the tool logs results about what content would be deleted, but does not delete content from the distribution point.

Exemplo: ContentLibraryCleanup.exe /dp Server1. contoso.com /deleteExample: ContentLibraryCleanup.exe /dp server1.contoso.com /delete
/q/q OpcionalOptional
Este parâmetro é executada a ferramenta num modo sossegado que suprime todos os avisos (como os pedidos para eliminar conteúdo) e não abre automaticamente o ficheiro de registo.This switch runs the tool in a quiet mode that suppresses all prompts (like the prompts to delete content), and does not automatically open the log file.

Exemplo: ContentLibraryCleanup.exe /q /dp Server1. contoso.comExample: ContentLibraryCleanup.exe /q /dp server1.contoso.com
/dp <FQDN do ponto de distribuição >/dp <distribution point FQDN> NecessárioRequired
Especifique o nome de domínio completamente qualificado (FQDN) do ponto de distribuição que pretende limpar.Specify the fully qualified domain name (FQDN) of the distribution point that you want to clean.

Exemplo: /Dp de ContentLibraryCleanup.exe Server1. contoso.comExample: ContentLibraryCleanup.exe /dp server1.contoso.com
/PS <FQDN de site principal >/ps <primary site FQDN> Opcional quando limpar conteúdo a partir de um ponto de distribuição num site primário.Optional when cleaning content from a distribution point at a primary site.
Obrigatório quando limpar conteúdo a partir de um ponto de distribuição num site secundário.Required when cleaning content from a distribution point at a secondary site.

A ferramenta de suporte de dados liga-se para o site primário principal para executar consultas no SMS_Provider.The tool connects to the parent primary site to run queries against SMS_Provider. Estas permitem consultas a ferramenta de determinar que conteúdo deve ser no ponto de distribuição para que possa identificar o conteúdo que é órfã e pode ser removido.These queries let the tool determine what content should be on the distribution point so it can identify the content that is orphaned and can be removed. Esta ligação para o site primário principal têm de ser feita para pontos de distribuição num site secundário porque os detalhes necessários não estão disponíveis diretamente a partir do site secundário.This connection to the parent primary site must be made for distribution points at a secondary site because the required details are not available directly from the secondary site.

Especifique o FQDN do site primário que o ponto de distribuição pertence a ou do elemento principal primário principal quando o ponto de distribuição estiver num site secundário.Specify the FQDN of the primary site that the distribution point belongs to, or of the parent primary parent when the distribution point is at a secondary site.

Exemplo: ContentLibraryCleanup.exe /dp Server1. contoso.com /ps siteserver1.contoso.comExample: ContentLibraryCleanup.exe /dp server1.contoso.com /ps siteserver1.contoso.com
/sc <código do site principal >/sc <primary site code> Opcional quando limpar conteúdo a partir de um ponto de distribuição num site primário.Optional when cleaning content from a distribution point at a primary site.
Obrigatório quando limpar conteúdo a partir de um ponto de distribuição num site secundário.Required when cleaning content from a distribution point at a secondary site.

Especifique o código do site do site primário que o ponto de distribuição pertence a ou do site primário principal quando o ponto de distribuição estiver num site secundário.Specify the site code of the primary site that the distribution point belongs to, or of the parent primary site when the distribution point is at a secondary site.

Exemplo: ContentLibraryCleanup.exe /dp Server1. contoso.com /sc ABCExample: ContentLibraryCleanup.exe /dp server1.contoso.com /sc ABC
/log/log OpcionalOptional
Especifique a localização onde a ferramenta escreve o ficheiro de registo.Specify the location where the tool writes the log file. Isto pode ser numa unidade local ou numa rede de partilhar.This can be a local drive or on a network share.

Quando este comutador não é utilizado, o ficheiro de registo é colocado na pasta temp do utilizador, no computador onde a ferramenta é executada.When this switch is not used, the log file is placed in the temp folder of the user, on the computer where the tool runs.

Exemplo de unidade local: ContentLibraryCleanup.exe /dp Server1. contoso.com /log C:\Users\Administrator\DesktopExample of local drive: ContentLibraryCleanup.exe /dp server1.contoso.com /log C:\Users\Administrator\Desktop

Exemplo de partilha de rede: ContentLibraryCleanup.exe /dp Server1. contoso.com /log \ <partilhar >&lt; pasta >Example of network share: ContentLibraryCleanup.exe /dp server1.contoso.com /log \<share>&lt;folder>