# KCS - Backup e Restauração de Identidade do Agente TiFlux (Windows)

## 💾 Backup e Restauração de Identidade do Agente TiFlux (Windows)

🕒 Tempo aproximado para leitura: 00:02:30 min

***

### ❓ Dúvida

Como realizar a formatação de uma máquina Windows e garantir que, após a reinstalação do sistema, o Agente Remoto do TiFlux mantenha o mesmo nome, ID e histórico gerado anteriormente?

***

### 🔎 Causa

O Agente TiFlux armazena chaves únicas no Registro do Windows (`HKEY_LOCAL_MACHINE\SOFTWARE\TiFlux`). Sem o backup dessas chaves, uma formatação resulta na criação de uma "nova" máquina no painel, gerando duplicidade e perda do histórico de inventário e auditoria da máquina original.

***

### ✅ Solução: 

#### Procedimento via Script (.BAT)

#### 1. Passo a Passo: Antes de Formatar (Exportação)

1. Utilize o script de automação fornecido abaixo e execute-o como Administrador.
2. Escolha a Opção \[1] - Exportar registro.
3. O arquivo `TiFlux_Backup.reg` será gerado. Guarde-o em um local seguro (Pen Drive ou Nuvem) junto com o arquivo `.bat`. O script abrirá a pasta automaticamente ao finalizar.

#### 2. Passo a Passo: Após Formatar (Importação)

1. Antes de instalar o Agente TiFlux, coloque o arquivo `TiFlux_Backup.reg` e o script `.bat` na mesma pasta no novo Windows.
2. Execute o script como Administrador e escolha a Opção \[2] - Importar registro.
3. Certifique-se de que a mensagem de sucesso apareça 
4. Certifique-se que a máquina esteja com o mesmo nome de antes da formatação
5. Estando de acordo os passos acima, então proceda com a instalação do Agente Remoto TiFlux.
6. Verificando no Tiflux, o Recurso ficara online novamente.

***

#### 💻 Script de Gestão (Copiar e salvar como .bat)

Snippet de código

```
@echo off
title Exportar ou Importar Registro do Agente do TiFlux
color 0A
set "REG_PATH=HKEY_LOCAL_MACHINE\SOFTWARE\TiFlux"
set "REG_FILE=%~dp0TiFlux_Backup.reg"

:MENU
cls
echo ===========================================
echo GERENCIADOR DE REGISTRO - TIFLUX
echo ===========================================
echo.
echo [1] Exportar registro (Salve o arquivo em local seguro)
echo [2] Importar registro (Arquivo e bat na mesma pasta)
echo [0] Sair
echo.
set /p opcao=Escolha uma opcao: 

if "%opcao%"=="1" goto EXPORTAR
if "%opcao%"=="2" goto IMPORTAR
if "%opcao%"=="0" exit
goto MENU

:EXPORTAR
echo Exportando registro...
reg export "%REG_PATH%" "%REG_FILE%" /y
if %errorlevel%==0 (
    echo Sucesso! Abrindo local do arquivo...
    explorer /select,"%REG_FILE%"
) else (
    echo ERRO. Execute como Administrador.
)
pause
goto MENU

:IMPORTAR
if not exist "%REG_FILE%" (
    echo Arquivo nao encontrado!
    pause
    goto MENU
)
reg import "%REG_FILE%"
if %errorlevel%==0 (
    echo Registro importado com sucesso!
) else (
    echo ERRO. Verifique permissoes.
)
pause
goto MENU
```

***

### 🔍 Palavras-chave para busca

```
backup de registro, 
agente remoto, 
formatar maquina, 
manter id tiflux, 
script exportar registro, 
migrar agente, 
identidade tiflux, 
hkey local machine tiflux
```

***

Se você quiser que salve ou exclua informações sobre você, ative essa opção na [página Informações salvas](https://gemini.google.com/saved-info).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/agente/kcs-backup-e-restauracao-de-identidade-do-agente-tiflux-windows.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.