Ferramenta de reposição de atualizaçãoUpdate reset tool

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

Início com versão 1706, sites de administração central e sites primários do Configuration Manager, incluir a atualização de reposição de ferramenta do Configuration Manager, CMUpdateReset.exe.Beginning with version 1706, Configuration Manager primary sites, and central administration sites include the Configuration Manager Update Reset Tool, CMUpdateReset.exe. Utilize a ferramenta para corrigir os problemas quando as atualizações na consola tem problemas de transferir ou a replicar.Use the tool to fix issues when in-console updates have problems downloading or replicating. A ferramenta se encontra no \cd.latest\SMSSETUP\TOOLS pasta do servidor do site.The tool is found in the \cd.latest\SMSSETUP\TOOLS folder of the site server.

Pode utilizar esta ferramenta com qualquer versão do ramo atual, que permanece no suporte.You can use this tool with any version of the current branch that remains in support.

Utilize esta ferramenta quando um atualização na consola ainda não instalou e está no estado de falha.Use this tool when an in-console update has not yet installed and is in a failed state. Estado de falha significa que a transferência da atualização está em progresso mas bloqueados ou tendo um período de tempo excessivamente longo.A failed state means that the update download is in progress but stuck or taking an excessively long time. Muito tempo é considerado horas mais do que as suas expectativas histórico para os pacotes de atualização do tamanho semelhante.A long time is considered to be hours longer than your historical expectations for update packages of similar size. Também pode ser uma falha ao replicar a atualização para sites primários subordinados.It can also be a failure to replicate the update to child primary sites.

Quando executar a ferramenta, é executada relativamente a atualização que especificou.When you run the tool, it runs against the update that you specify. Por predefinição, a ferramenta não elimina atualizações instaladas ou transferidas com êxito.By default, the tool does not delete successfully installed or downloaded updates.

Pré-requisitosPrerequisites

A conta que utiliza para executar a ferramenta requer as seguintes permissões:The account you use to run the tool requires the following permissions:

  • Leitura e escrever permissões para a base de dados do site de administração central e cada site primário na sua hierarquia.Read and Write permissions to the site database of the central administration site and to each primary site in your hierarchy. Para definir estas permissões, pode adicionar a conta de utilizador como membro do db_datawriter e db_datareader fixo funções de base de dados na base de dados do Configuration Manager de cada site.To set these permissions, you can add the user account as a member of the db_datawriter and db_datareader fixed database roles on the Configuration Manager database of each site. A ferramenta não interage com os sites secundários.The tool does not interact with secondary sites.
  • Administrador local no site de nível superior da hierarquia.Local Administrator on the top-level site of your hierarchy.
  • Administrador local no computador que aloja o ponto de ligação de serviço.Local Administrator on the computer that hosts the service connection point.

É necessário o GUID do pacote de atualização que pretende repor.You need the GUID of the update package that you want to reset. Para obter o GUID:To get the GUID:

  1. Na consola, aceda a administração > atualizações e manutenção.In the console, go to Administration > Updates and Servicing.
  2. No painel de visualização, faça duplo clique no cabeçalho de uma das colunas (como estado), em seguida, selecione Guid de pacote adicionar essa coluna à apresentação de.In the display pane, right-click the heading of one of the columns (like State), then select Package Guid to add that column to the display.
  3. A coluna mostra agora o GUID do pacote de atualização.The column now shows the update package GUID.

Dica

Para copiar o GUID, selecione a linha para o pacote de atualização que pretende repor e, em seguida, utilize CTRL + C para copiar nessa linha.To copy the GUID, select the row for the update package you want to reset, and then use CTRL+C to copy that row. Se colar a seleção copiada para um editor de texto, em seguida, pode copiar apenas o GUID para utilização como um parâmetro de linha de comandos quando executar a ferramenta.If you paste your copied selection into a text editor, you can then copy only the GUID for use as a command-line parameter when you run the tool.

Execute a ferramentaRun the tool

A ferramenta tem de ser executada no site de nível superior da hierarquia.The tool must be run on the top-level site of the hierarchy.

Quando executar a ferramenta, utilize os parâmetros da linha de comandos para especificar:When you run the tool, use command-line parameters to specify:

  • O SQL Server no site de nível superior da hierarquia.The SQL Server at the top-tier site of the hierarchy.
  • O nome de base de dados do site no site de nível superior.The site database name at the top-tier site.
  • O GUID do pacote de atualização que pretende repor.The GUID of the update package you want to reset.

Com base no estado da atualização, a ferramenta identifica os servidores adicionais, tem de aceder.Based on the status of the update, the tool identifies the additional servers it needs to access.

Se o pacote de atualização está a ser um após a transferência Estado, a ferramenta de limpeza não configurar o pacote.If the update package is in a post download state, the tool does not clean up the package. Como opção, pode forçar a remoção de uma atualização transferida com êxito utilizando o parâmetro de eliminação de imposição (consulte os parâmetros da linha de comandos posteriormente neste tópico).As an option, you can force the removal of a successfully downloaded update by using the force delete parameter (See command-line parameters later in this topic).

Depois da ferramenta é executada:After the tool runs:

  • Se um pacote foi eliminado, reinicie o serviço SMS_Executive no site de nível superior.If a package was deleted, restart the SMS_Executive service at the top-tier site. Em seguida, verifique a existência de atualizações, pelo que pode transferir o pacote novamente.Then, check for updates so you can download the package again.
  • Se um pacote não foi eliminado, não terá de efetuar qualquer ação.If a package was not deleted, you do not need to take any action. A atualização reinicializa e, em seguida, reinicia a instalação ou a replicação.The update reinitializes and then restarts replication or installation.

Parâmetros da linha de comandos:Command-line parameters:

ParâmetroParameter DescriçãoDescription
-S <FQDN do SQL Server do seu site de nível superior >-S <FQDN of the SQL Server of your top-tier site> NecessárioRequired
Especifique o FQDN do SQL Server que aloja a base de dados do site para o site de nível superior da hierarquia.Specify the FQDN of the SQL Server that hosts the site database for the top-tier site of your hierarchy.
-D <nome de base de dados >-D <Database name> NecessárioRequired
Especifique o nome da base de dados no site de nível superior.Specify the name of the database at the top-tier site.
-P <GUID do pacote >-P <Package GUID> NecessárioRequired
Especifique o GUID para o pacote de atualização que pretende repor.Specify the GUID for the update package you want to reset.
-I <nome de instância do SQL Server >-I <SQL Server instance name> OpcionalOptional
Identifica a instância do SQL Server que aloja a base de dados do site.Identify the instance of SQL Server that hosts the site database.
-FDELETE-FDELETE OpcionalOptional
Forçar a eliminação de um pacote de atualização transferido com êxito.Force deletion of a successfully downloaded update package.

Exemplos:Examples:
Um cenário típico, que pretende repor uma atualização que tem problemas de transferência.In a typical scenario, you want to reset an update that has download problems. O FQDN de servidores SQL é server1.fabrikam.com, a base de dados do site CM_XYZe o pacote GUID é 61F16B3C-F1F6-4F9F-8647-2A524B0C802C.Your SQL Servers FQDN is server1.fabrikam.com, the site database is CM_XYZ, and the package GUID is 61F16B3C-F1F6-4F9F-8647-2A524B0C802C. Execute: CMUpdateReset.exe -S server1.fabrikam.com -D CM_XYZ 61F16B3C-F1F6-4F9F-8647-2A524B0C802C -PYou run: CMUpdateReset.exe -S server1.fabrikam.com -D CM_XYZ -P 61F16B3C-F1F6-4F9F-8647-2A524B0C802C

Num cenário mais extremos, pretender forçar a eliminação do pacote de atualização problemáticas.In a more extreme scenario, you want to force deletion of problematic update package. O FQDN de servidores SQL é server1.fabrikam.com, a base de dados do site CM_XYZe o pacote GUID é 61F16B3C-F1F6-4F9F-8647-2A524B0C802C.Your SQL Servers FQDN is server1.fabrikam.com, the site database is CM_XYZ, and the package GUID is 61F16B3C-F1F6-4F9F-8647-2A524B0C802C. Execute: CMUpdateReset.exe - FDELETE -S server1.fabrikam.com -D CM_XYZ 61F16B3C-F1F6-4F9F-8647-2A524B0C802C -PYou run: CMUpdateReset.exe -FDELETE -S server1.fabrikam.com -D CM_XYZ -P 61F16B3C-F1F6-4F9F-8647-2A524B0C802C