---
title: "Comando do Amplia Reg: **backfill-holder-normalized-alternative-email**"
description: "Comando backfill-holder-normalized-alternative-email do Amplia Reg: preenche o e-mail alternativo normalizado dos titulares cadastrados antes da versão 8.4.0."
canonical: "https://docs.lacunasoftware.com/articles/amplia-reg/on-premises/tool/backfill-holder-normalized-alternative-email"
locale: "pt-BR"
product: "Amplia Reg"
last_updated: "2026-10-13"
---

# Comando do Amplia Reg: **backfill-holder-normalized-alternative-email**

## Nome

`backfill-holder-normalized-alternative-email` - Preenche o e-mail alternativo normalizado de titulares antigos

## Sintaxe

```sh
dotnet Lacuna.AmpliaRegNg.Site.dll [settings] -- backfill-holder-normalized-alternative-email [options]
```

Ou, no Docker:

```sh
docker run -i lacunasoftware/ampliareg:x.y.z [settings] -- backfill-holder-normalized-alternative-email [options]
```

> **Info**
>
> Substitua `x.y.z` acima pela versão desejada

Os argumentos `settings` são configurações adicionais para sobrescrever configurações dos arquivos de configuração e variáveis de ambiente,
por exemplo `--Section1:Name1=value1 --Section2:Name2=value2`.

Opções:

* `--batchsize <batch-size>`: número de titulares a processar por lote. Padrão: 100
* `--logfrequency <log-frequency>`: frequência, em número de titulares processados, com que o progresso é exibido no log. Um valor menor ou igual a zero desativa esse log. Padrão: 5

## Descrição

A versão [8.4.0](https://docs.lacunasoftware.com/articles/amplia-reg/changelog#8.4.0) passou a armazenar, para cada titular, uma versão normalizada do e-mail alternativo, além do
e-mail alternativo como foi informado. Esse valor é preenchido automaticamente sempre que o e-mail alternativo de um titular é gravado,
mas fica vazio nos titulares cadastrados antes dessa versão.

O comando `backfill-holder-normalized-alternative-email` percorre todos os titulares que possuem e-mail alternativo e preenche o e-mail
alternativo normalizado a partir do valor já cadastrado. O e-mail alternativo em si não é alterado.

> **Info**
>
> Execute este comando uma única vez, após atualizar para a versão 8.4.0 ou superior. Titulares criados ou com o e-mail alternativo
> alterado a partir dessa versão já têm o valor normalizado preenchido, e executar o comando novamente não causa problemas.

Antes de processar, o comando exibe a quantidade de titulares encontrados e solicita confirmação (`Y`) antes de prosseguir.

## Veja também

* [Utilitário de linha de comando do Amplia Reg](https://docs.lacunasoftware.com/articles/amplia-reg/on-premises/tool)