> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/configuracoes/recursos/agente-remoto/kcs-backup-e-restauracao-de-identidade-do-agente-tiflux-windows.md).

# 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).