A ferramenta de limpeza da 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 longo não associados a qualquer pacote ou aplicação a partir de um ponto de distribuição (órfão 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 denomina-se a ferramenta de limpeza da biblioteca de conteúdos e substitui as versões anteriores das 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 só pode executar em relação a um único ponto de distribuição de cada vez.The tool can only run against a single distribution point at a time.

  • Pode ser executado diretamente no computador que aloja o ponto de distribuição que pretende apagar 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 igual 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 um 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 no seguintes dois modos.You can run the tool in the following two modes. Recomendamos que execute a ferramenta numa investiguem modo, pelo que pode rever os resultados antes de executar a ferramenta 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 investiguem:What-If mode:
    Se não especificar o /eliminar comutador, a ferramenta é executado no modo de investiguem e identifica os conteúdos que serão eliminados 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 executado no modo a ferramenta não elimina quaisquer dados.When run in this mode the tool does not delete any data.
    • Informações sobre o conteúdo que será eliminado são escritas no ficheiro de registo de ferramentas e não lhe para confirmar eliminação cada 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 o /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 são executados neste modo, o 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 para todas as para ignorar avisos adicionais e eliminar todos os órfão conteúdo.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 em qualquer modo, cria automaticamente um registo com um nome que inclui o modo da que ferramenta é executada, o 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 abre automaticamente quando a ferramenta estiver concluída.The log file automatically opens when the tool finishes.

Por predefinição, o ficheiro de registo é escrito na 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 /iniciar sessão 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 comutadores de linha de comandos necessário e comutadores opcionais que pretende utilizar.Next, enter a command line that includes the required command line switches, and optional switches you want to use.

Problema de conhecido 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: Nesta biblioteca de conteúdos não é possível limpar neste momento porque o pacote não é 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 a implementação.The tool cannot reliable identify orphaned files when content is in progress or has failed to deploy. Por conseguinte, a ferramenta não permitirá a limpar conteúdo até que este problema seja resolvido.Therefore, the tool will not allow you to clean-up content until that issue is resolved.

Parâmetros da 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 se pretender eliminar o conteúdo do ponto de distribuição.Use this switch when you want to delete content from the distribution point. Lhe for pedido antes do conteúdo é eliminado.You are prompted before content is deleted.

Quando este parâmetro não for utilizado, a ferramenta regista resultados sobre o conteúdo que será 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 comutador este último executa a ferramenta de um modo silencioso que suprime todos os avisos (como os pedidos para eliminar conteúdo) e não automaticamente a abrir 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 apagar.Specify the fully qualified domain name (FQDN) of the distribution point that you want to clean.

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

A ferramenta estabelece ligação ao 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 o conteúdo que deve estar 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 tem 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 pertence o ponto de distribuição ou de principal primário principal quando o ponto de distribuição 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 o conteúdo a partir de um ponto de distribuição num site primário de limpeza.Optional when cleaning content from a distribution point at a primary site.
Necessário quando o conteúdo a partir de um ponto de distribuição num site secundário de limpeza.Required when cleaning content from a distribution point at a secondary site.

Especifique o código do site do site primário que pertence o ponto de distribuição ou do site primário principal quando o ponto de distribuição 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 uma unidade local ou numa rede de partilha.This can be a local drive or on a network share.

Quando este parâmetro não for utilizado, o ficheiro de registo é colocado na pasta temporária 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>