Você tem um conjunto de regras do Outlook que processam e-mails recebidos, movem mensagens para pastas ou encaminham itens para sua equipe. Ao migrar para uma nova caixa de correio ou ambiente Exchange, essas regras não são transferidas automaticamente. Recriar dezenas de regras manualmente é lento e sujeito a erros.
O cmdlet Export-InboxRule no Exchange Management Shell lê as regras diretamente do servidor usando Exchange Web Services (EWS). Ele exporta cada regra para um arquivo CSV, que você pode importar para outra caixa de correio com Import-InboxRule.
Este artigo explica como fazer backup das regras do lado do servidor do Outlook com Export-InboxRule, migrá-las para uma nova caixa de correio e lidar com erros comuns durante o processo.
Principais conclusões: Exportar e importar regras do Outlook via PowerShell do Exchange
- Export-InboxRule -Mailbox usuario@dominio.com | Export-CSV regras.csv: Exporta todas as regras do lado do servidor da caixa de correio especificada para um arquivo CSV para backup ou migração.
- Import-InboxRule -Mailbox novousuario@dominio.com -CSVData (Get-Content regras.csv -Encoding Byte): Importa as regras salvas para a caixa de correio de destino, recriando cada regra com suas condições e ações originais.
- Get-InboxRule -Mailbox usuario@dominio.com: Lista todas as regras existentes em uma caixa de correio para verificar a exportação ou conferir conflitos antes de importar.
Como as Regras do Lado do Servidor do Exchange Funcionam com EWS
As regras do Outlook podem ser do lado do cliente ou do lado do servidor. As regras do lado do cliente são executadas apenas quando o Outlook está aberto. As regras do lado do servidor são executadas no servidor Exchange independentemente de o Outlook estar em execução. O Exchange Web Services (EWS) é a API que cmdlets do Exchange PowerShell, como Export-InboxRule, usam para ler e gravar essas regras do lado do servidor.
O cmdlet Export-InboxRule se conecta ao servidor Exchange via EWS e recupera a coleção de regras da caixa de correio. Ele não depende de o Outlook estar instalado ou em execução na máquina onde você executa o comando. O cmdlet gera um conjunto de objetos de regra que você pode canalizar para Export-CSV para criar um arquivo de backup portátil.
O cmdlet Import-InboxRule lê o arquivo CSV e cria regras na caixa de correio de destino usando os mesmos endpoints EWS. A caixa de correio de destino deve estar em um servidor Exchange que suporte EWS. O Exchange Online e o Exchange Server 2013 e versões posteriores suportam esses cmdlets.
Pré-requisitos
Antes de executar Export-InboxRule ou Import-InboxRule, verifique estes requisitos:
- O Exchange Management Shell está instalado. Para Exchange Online, instale o módulo Exchange Online PowerShell V2.
- Você tem a função Mail Recipients ou permissões equivalentes nas caixas de correio de origem e destino.
- A caixa de correio de destino deve existir e estar acessível a partir do servidor Exchange ou Exchange Online.
- Ambas as caixas de correio devem estar na mesma organização Exchange ou no Exchange Online. A migração entre locatários requer etapas adicionais.
- Regras que usam condições ou ações não suportadas no servidor de destino falharão na importação.
Passos para Fazer Backup e Migrar Regras do Outlook
Siga os passos abaixo para exportar regras de uma caixa de correio de origem e importá-las para uma caixa de correio de destino. Todos os comandos são executados no Exchange Management Shell ou no Exchange Online PowerShell.
- Abra o Exchange Management Shell
Em uma máquina com as Ferramentas de Gerenciamento do Exchange, clique em Iniciar e digite Exchange Management Shell. Clique com o botão direito no resultado e selecione Executar como Administrador. Para Exchange Online, abra o Windows PowerShell e execute Connect-ExchangeOnline com suas credenciais de administrador. - Verifique as regras existentes na caixa de correio de origem
Execute Get-InboxRule -Mailbox origem@contoso.com | Format-Table Name,Priority. Isso lista todas as regras do lado do servidor. Anote os nomes e a contagem total para confirmar que a exportação capturou tudo. - Exporte as regras para um arquivo CSV
Execute Export-InboxRule -Mailbox origem@contoso.com | Export-CSV -Path “C:\Backup\RegrasOutlook.csv” -NoTypeInformation. O parâmetro -NoTypeInformation remove a linha de cabeçalho que marca o tipo de objeto. O arquivo é salvo no caminho especificado. - Abra o arquivo CSV para inspecionar as regras
Abra o arquivo CSV no Bloco de Notas ou Excel. Cada linha é uma regra. As colunas incluem Name, Description, Enabled, Priority, From, SentTo, SubjectContains, MoveToFolder e outras. Verifique se as regras esperadas aparecem no arquivo. Se houver erros sobre condições não suportadas, pule ou remova essas linhas antes de importar. - Importe as regras para a caixa de correio de destino
Execute Import-InboxRule -Mailbox destino@contoso.com -CSVData (Get-Content “C:\Backup\RegrasOutlook.csv” -Encoding Byte). O parâmetro -CSVData espera o conteúdo do arquivo como um array de bytes. O argumento -Encoding Byte garante que o arquivo seja lido corretamente. Este comando cria as regras na caixa de correio de destino. - Verifique as regras importadas
Execute Get-InboxRule -Mailbox destino@contoso.com | Format-Table Name,Enabled,Priority. Compare a lista com a lista da caixa de correio de origem. Todas as regras devem aparecer com os mesmos nomes e prioridades. - Teste uma regra na caixa de correio de destino
Envie um e-mail de teste de uma conta externa que corresponda a uma das condições da regra importada. Por exemplo, se uma regra move mensagens de um remetente específico para uma pasta, verifique se o e-mail aparece na pasta correta em alguns minutos.
Falhas Comuns na Importação e Como Lidar com Elas
Importar regras de uma caixa de correio para outra pode falhar por vários motivos. Abaixo estão os problemas mais frequentes e suas soluções.
A regra usa uma condição ou ação não suportada no destino
Algumas condições de regra, como formulários ou classificações de mensagem, podem não existir no servidor de destino. Abra o arquivo CSV no Excel. Exclua a linha inteira de qualquer regra que use condições não suportadas. Salve o arquivo e execute a importação novamente.
A caixa de correio de destino já tem o número máximo de regras
O Exchange Online permite até 256 regras por caixa de correio. O Exchange Server 2016 e 2019 permitem até 256 regras. Se a caixa de correio de destino já tiver 256 regras, a importação falha. Execute Get-InboxRule -Mailbox destino@contoso.com | Measure-Object para contar as regras existentes. Exclua regras desnecessárias do destino antes de importar.
A ação MoveToFolder referencia uma pasta que não existe
Se uma regra move mensagens para uma pasta chamada “Projeto X” mas essa pasta não existe na caixa de correio de destino, a regra é criada, mas a ação falha silenciosamente. Crie as pastas ausentes na caixa de correio de destino antes de importar as regras. Alternativamente, edite o arquivo CSV e altere o nome da pasta para uma pasta existente.
A importação falha com erro de acesso negado
A conta que executa Import-InboxRule deve ter permissão de Acesso Total na caixa de correio de destino. Se você receber um erro de acesso negado, adicione a permissão de Acesso Total com Add-MailboxPermission -Identity destino@contoso.com -User admin@contoso.com -AccessRights FullAccess. Em seguida, execute a importação novamente.
Export-InboxRule vs Recriação Manual de Regras: Principais Diferenças
| Item | Export-InboxRule via EWS | Recriação Manual no Outlook |
|---|---|---|
| Tempo necessário para 20 regras | Menos de 5 minutos | 30 a 60 minutos |
| Risco de erro | Baixo se o CSV for inspecionado antes da importação | Alto devido a erros de digitação e condições ausentes |
| Requer instalação do Outlook | Não | Sim |
| Lida com todas as condições do lado do servidor | Sim, exporta todas as condições suportadas | Sim, mas cada regra deve ser recriada do zero |
| Suporta migração em lote | Sim, um arquivo CSV para todas as regras | Não, cada regra é criada individualmente |
| Funciona entre locatários do Exchange Online | Não, requer o mesmo locatário ou on-premises para on-premises | Sim, mas manual |
Export-InboxRule é o método mais rápido e preciso quando ambas as caixas de correio estão na mesma organização Exchange ou locatário. A recriação manual é a alternativa quando há restrições entre locatários.
Agora você pode fazer backup das regras do lado do servidor do Outlook em um arquivo CSV e migrá-las para uma nova caixa de correio usando Export-InboxRule e Import-InboxRule. Todo o processo leva alguns minutos e preserva nomes, condições e ações das regras exatamente como estavam na origem. Para manutenção regular, execute Export-InboxRule mensalmente e armazene o arquivo CSV em um local seguro. Se precisar auditar regras em várias caixas de correio, combine Get-InboxRule com um script que exiba a contagem de regras e a data da última modificação de cada caixa de correio.