Migrar dados usando a linha de comando

Além de usar o Google Workspace Migration for Microsoft Exchange (GWMME) na área de trabalho do Windows, você pode executar o GWMME na interface da linha de comando. 

Antes de começar

Abra um prompt de comando, digite cd e depois o local da instalação do GWMME entre aspas duplas. Exemplo: cd "C:\Arquivos de Programas\Google\Google Workspace Migration".

Os locais padrão são:

• C:\Arquivos de Programas\Google\Google Workspace Migration (sistema de 32 bits)
• C:\Arquivos de Programas (x86)\Google\Google Workspace Migration (sistema de 64 bits)

Você talvez receba uma solicitação para digitar seu nome de usuário e a senha de administrador do Exchange.

Comandos exigidos para a migração

Os comandos devem ser inseridos em uma linha única e contínua. As quebras de linha que aparecem aqui são somente para facilitar a leitura.

Abrir seção  |  Recolher tudo e voltar ao início

Migração do Exchange

Exemplo 1: migrar usando um perfil de administrador

ExchangeMigration.exe
--nouse_gui
--exchange_profile_name="Exchange admin profile"
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"

Exemplo 2: migrar usando detalhes do servidor e do administrador

ExchangeMigration.exe
--nouse_gui
--source_server="exchange-server hostname"
--exchange_admin_login="Exchange server admin account"
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"

Veja mais informações sobre como transferir dados do Exchange em Migrar dados do Exchange.

Migração de uma Conta do Google ou de um servidor IMAP

ExchangeMigration.exe
--nouse_gui
--enable_imap
--filename="filename containing user list"
--service_account_json_path="json file path"
--imap_security="security number"
--imap_port="port number"
--imap_path_prefix="path prefix"
--imap_server_type="server type"
--source_server="IMAP server hostname"
--google_admin="admin email address"
--google_domain="Google domain name"

Para migrações no modo administrador a partir do Cyrus, use também:

--imap_admin_id="Cyrus IMAP admin"
--imap_admin_password="Cyrus admin password"

Veja mais informações sobre como transferir dados de e-mail de Contas do Google ou IMAP em Migrar o e-mail de Contas do Google ou IMAP.

Migração de arquivos PST

Exemplo 1: migrar mensagens para o Gmail

ExchangeMigration.exe
--nouse_gui
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--pst_base_folder="PST folder name"

Exemplo 2: migrar mensagens para o Google Vault

ExchangeMigration.exe
--nouse_gui
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--pst_base_folder="PST folder name"
--migrate_to_vault

Veja mais informações sobre a transferência de arquivos PST em Migrar dados de arquivos PST.

Migração de pastas públicas

Exemplo 1: usar o modo de mapeamento para migrar pastas públicas (recomendado). Esse modo usa um arquivo de mapeamento para mapear a pasta pública para o grupo no Grupos. Como os endereços de e-mail de grupos geralmente são diferentes dos nomes de pastas públicas, a maioria das organizações usa o modo de mapeamento.

ExchangeMigration.exe
--nouse_gui
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--public_folder_mapping_file="path to mapping file"
--enable_public_folder_migration

Exemplo 2: usar o modo padrão para migrar pastas públicas. Nesse modo, você não precisa de um arquivo de mapeamento. Em vez disso, o GWMME compara os nomes de pastas e grupos. O mapeamento é estabelecido quando o nome da pasta pública é igual ao nome do grupo. Por exemplo, os relatórios TPS/tps mapeiam para o grupo [e-mail].

ExchangeMigration.exe
--nouse_gui
--exchange_profile_name="Exchange admin profile"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--enable_public_folder_migration

Veja mais informações sobre a transferência de pastas públicas em Migrar de pastas públicas.

Todos os argumentos do GWMME

Digite um argumento em uma única linha e adicione um traço duplo (--) antes do argumento. Alguns argumentos exigem parâmetros adicionais. Digite os parâmetros precedidos por um sinal de igual e entre aspas duplas. 

Abrir seção  |  Recolher tudo e voltar ao início

A—E

Argumento e descrição	Parâmetro
--calendar_migration_end_date Especifica a data de término de eventos da agenda que você quer migrar. Os eventos ocorridos após essa data não serão migrados. Exemplo: --calendar_migration_end_date="2020-01-01"	Data no formato AAAA-MM-DD
--calendar_migration_start_date Especifica a data de início dos eventos da agenda que você quer migrar. Os eventos da agenda anteriores a essa data não serão migrados. Exemplo: --calendar_migration_start_date="2018-01-01"	Data no formato AAAA-MM-DD
--custom_label_prefix Especifica o prefixo a ser anexado a todos os marcadores no Gmail. Exemplo: --custom_label_prefix="migrado-"	Prefixo personalizado anexado aos rótulos
--email_migration_end_date Especifica a data de término para as mensagens de e-mail que você quer migrar. As mensagens após essa data não serão migradas Exemplo: --email_migration_end_date="2020-01-01"	Data no formato AAAA-MM-DD
--email_migration_start_date Especifica a data de início das mensagens de e-mail que você quer migrar. As mensagens anteriores a essa data não serão migradas. Exemplo: --email_migration_start_date="2018-01-01"	Data no formato AAAA-MM-DD
--enable_calendar_fanout Ativa a distribuição de dados de eventos da agenda para uma migração da agenda.	Não é preciso usar parâmetros
--enable_hidden_folders_migration Permite a migração de pastas MAPI (Exchange ou PST) ocultas.	Não é preciso usar parâmetros
--enable_imap Permite a migração de um servidor IMAP em vez de um servidor Exchange.	Não é preciso usar parâmetros
--enable_mbox_logging Ativa a geração de registros mbox. As mensagens que não podem ser migradas devido a restrições de tamanho ou tipo de arquivo do Gmail são gravadas em um arquivo mbox específico do usuário. O arquivo mbox fica localizado no caminho da pasta do registro de rastreamento do GWMME (por exemplo, %localappdata%\Google\Google Apps Migration\Tracing\ExchangeMigration\mbox\[e-mail]). Veja mais detalhes sobre as restrições das mensagens do Gmail em Tipos de arquivo bloqueados no Gmail.	Não é preciso usar parâmetros
--enable_public_folder_migration Ativa a migração do GWMME de pastas públicas do Exchange para o Grupos do Google. Veja mais detalhes em Migrar pastas públicas.  Observação: não é possível migrar usuários e pastas públicas ao mesmo tempo.	Não é preciso usar parâmetros
--enable_resource_migration Permite a migração de recursos da agenda.	Não é preciso usar parâmetros
--exchange_admin_login Especifica o nome de login da conta de administrador do servidor Exchange. Use esse argumento com --source_server. Se você usar esse argumento, não use --exchange_profile_name. Exemplo: --exchange_admin_login="administrador"	Nome de login da conta de administrador do servidor Exchange
--exchange_profile_name Especifica o nome do perfil do Outlook que você quer usar para se conectar a seu servidor Exchange. Especifique um perfil de administrador no mesmo computador que executa o GWMME. Se usar esse argumento, não utilize: --source_server --pst_base_folder --exchange_admin_login Exemplo: --exchange_profile_name="exch_migration_admin"	Nome de um perfil do Outlook
--exclude_message_classes Exclui mensagens com base na classe da mensagem.  Esse argumento é útil ao excluir mensagens fragmentadas de uma solução de arquivamento. O GWMME não permite uma nova migração de mensagens não fragmentadas. A abordagem recomendada é excluir as mensagens fragmentadas e, quando elas forem totalmente reidratadas, migre-as em uma segunda execução do GWMME. Exemplo: --exclude_message_classes="ipm.note.eas,ipm.note.1"	Lista de classes excluídas separadas por vírgula (sem espaços entre os itens da lista)
--exclude_top_level_folders Exclui pastas de nível superior com base no nome da pasta.  Exemplo: --exclude_top_level_folders="Itens excluídos,Rascunhos"	Lista de pastas de nível superior separadas por vírgula (sem espaço entre os itens da lista)

F—M

Argumento e descrição	Parâmetro
--filename Inclui os dados que pertencem aos nomes de usuário especificados no arquivo CSV. Se usar esse argumento, não use --migration_usernames. Exemplo: --filename="C:\Documentos e Configurações\users.csv"	Caminho para os arquivos CSV de nomes de usuário
--force_clear_google_calendar_ids_on_remigration Limpa os IDs das agendas secundárias antes de você migrar os dados novamente. Ao migrar novamente os dados da agenda, o GWMME cria novas agendas secundárias com IDs exclusivos. Isso evita conflitos de eventos. Observação: use esse argumento antes de migrar os dados novamente. Veja mais detalhes em Migrar conteúdo novamente.	Não é preciso usar parâmetros
--force_restart Executa novamente a migração de todos os itens, não apenas a dos itens que não foram migrados. Por padrão, se uma migração tiver sido interrompida, a próxima migração iniciará no ponto em que a anterior parou. Você pode usar esse parâmetro para fazer a migração novamente desde o começo. Ao usar essa opção, os e-mails duplicados serão filtrados, os eventos da agenda migrados antes serão ignorados (mas poderão ser duplicados em alguns casos) e os contatos migrados antes serão duplicados.	Não é preciso usar parâmetros
--google_admin Define o proprietário do evento para recursos da agenda. Se um evento não tiver um proprietário, o GWMME definirá o administrador indicado como o proprietário do evento. Esse usuário precisa ter acesso total às agendas de recursos. Exemplo: --google_admin="[e-mail]"	Endereço de e-mail do proprietário do evento indicado para agendas de recursos
--google_domain Especifica o domínio do Google Workspace para onde você está migrando dados. Exemplo: --google_domain="example.com"	Domínio do Google Workspace
--help Exibe uma lista de argumentos para ExchangeMigration.exe.	Não é preciso usar parâmetros
--id_mapping_file Especifica o nome do arquivo que tem uma lista de mapeamento completa. Use o arquivo de mapeamento CSV que contém os mapeamentos dos usuários e dos endereços da agenda. Veja mais detalhes em Criar arquivos CSV para sua migração. Exemplos: --id_mapping_file="recursos.csv"	Nome do arquivo
--imap_admin_id Especifica o administrador de IMAP do Cyrus que tem acesso a todas as contas de IMAP no servidor. Use com --imap_admin_password. Exemplo: --imap_admin_id="[e-mail]"	Endereço de e-mail do administrador do Cyrus
--imap_admin_password Especifica a senha do administrador do IMAP do Cyrus. Use com --imap_admin_id. Exemplo: --imap_admin_password="senha"	Senha do administrador do Cyrus
--imap_path_prefix Especifica o prefixo do caminho das pastas do usuário em um servidor IMAP. Digite o prefixo do caminho das pastas do IMAP que é comum a todas as pastas. O prefixo do caminho é geralmente o namespace do IMAP dos nomes das pastas. Por exemplo, se a listagem de pastas do IMAP de um usuário for INBOX, INBOX.Enviados e INBOX.Rascunhos, INBOX será o prefixo do caminho. Os valores típicos de prefixo de caminho são INBOX para Cyrus e Courier ou nenhum (deixar o campo em branco) para o IMAP do GroupWise, Gmail e Dovecot. Exemplo: --imap_path_prefix="INBOX"	Prefixo do caminho das pastas do usuário
--imap_port Especifica o número da porta do servidor IMAP. Exemplo: --imap_port="143"	Número da porta
--imap_security Especifica a opção de segurança que você quer usar. Use um dos seguintes códigos: 0 (sem segurança) 1 (SSL) 2 (STARTTLS) Exemplo: --imap_security="1"	Código de um dígito
--imap_server_type Especifica o tipo de servidor IMAP de onde você está migrando. Os tipos de servidor são: Exchange, GroupWise, Gmail, Cyrus, Courier, Dovecot, Zimbra e não compatível. O padrão é não compatível. Observação: se você especificar um tipo de servidor incorreto, o desempenho da migração poderá ser afetado. Exemplo: --imap_server_type="Gmail"	Tipo de servidor IMAP
--migrate_to_vault Migra o e-mail para o Google Vault. Mensagens são enviadas para a conta do usuário e marcadas como excluídas. Marcadores não são criados na Caixa de entrada do usuário. Observe as seguintes restrições: As regras de retenção do Google Vault determinam por quanto tempo a mensagem é retida no Vault. Se você estiver migrando para o Vault, o Gmail precisará estar ativado no Admin Console. Se o Gmail estiver desativado, você verá erros 403.  A migração de usuários com a licença Vault para ex-funcionários (VFE) não será concluída porque o Gmail não está ativado para esses usuários.	Não é preciso usar parâmetros
--migration_usernames Especifica a lista de usuários para migração. Se você usar esse argumento, não use --filename. Exemplo: --migration_usernames="usuário1,usuário2,usuário3"	Lista de usuários separada por vírgulas (sem espaço entre os itens)

N—Z

Argumento e descrição	Parâmetro
--noenable_calendar_migration Executa a migração sem incluir dados de agenda.	Não é preciso usar parâmetros
--noenable_contact_migration Executa a migração sem incluir dados de contato.	Não é preciso usar parâmetros
--noenable_email_migration Executa a migração sem incluir dados de e-mail.	Não é preciso usar parâmetros
--noenable_error_reports Impede que o GWMME gere relatórios de migração que mostram mensagens de erros que ocorrem durante a migração. Pular os relatórios de migração pode melhorar o desempenho dela. Para mais informações sobre os relatórios de migração, acesse a seção "Reviewing migration reports" no Guia de administração do GWMME.	Não é preciso usar parâmetros
--noenable_id_mapping Executa a migração sem a necessidade de um arquivo de mapeamento. Todos os dados de mapeamento serão definidos na lista de usuários ao usar o argumento --id_mapping_file.	Não é preciso usar parâmetros
--noenable_label_prefix Especifica que um prefixo não será adicionado aos marcadores ao migrar de arquivos PST. Por padrão, o nome do arquivo PST é adicionado como um prefixo a marcadores e agendas criados durante a migração.	Não é preciso usar parâmetros
--nouse_gui Executa o GWMME usando a linha de comando. O modo de interface gráfica do usuário (GUI, na sigla em inglês) é o padrão.	Não é preciso usar parâmetros
--nowait Fecha o GWMME sem que você precise pressionar a tecla Enter quando a migração é executada na linha de comando.	Não é preciso usar parâmetros
--num_threads Especifica o número de usuários que você quer migrar simultaneamente. Uma linha de execução separada é aberta para cada usuário. O padrão é 25 linhas de execução. Exemplo: --num_threads="20"	Número de usuários
--pst_base_folder Especifica o diretório que contém os arquivos PST para migração. O GWMME migra todos os arquivos PST nas subpastas da pasta especificada. Se usar esse argumento, não utilize: --source_server --exchange_profile_name Exemplo: --pst_base_folder="C:\pst"	Diretório que contém arquivos PST
--public_folder_mapping_file Especifica o nome do arquivo de mapeamento. O arquivo de mapeamento mapeia caminhos de pasta pública do Exchange para endereços de e-mail do Grupos do Google. Veja mais detalhes em Migrar pastas públicas. Exemplo: --public_folder_mapping_file="public_folder_mapping.csv"	Nome do arquivo de mapeamento no formato CSV
--retry_count Especifica o número de tentativas se ocorrer uma falha temporária, como o tempo limite de um servidor ocupado. O padrão é 10. Exemplo: --retry_count="5"	Número de novas tentativas
--run_diagnostics Executa o diagnóstico completo de pré-migração que valida a conectividade do servidor, a autenticação, o acesso a contas e a lista inteira de usuários.	Não é preciso usar parâmetros
--service_account_json_path Especifica o caminho do arquivo de credenciais da conta de serviço. Veja instruções sobre como acessar esse arquivo em Autorizar GWMME para sua conta.  Exemplo: --service_account_json_path ="C:\Usuários\admin\privatekey.json"	O caminho do arquivo de credenciais da conta de serviço.
--source_server Especifica o endereço IP do servidor Exchange ou IMAP ou o nome do domínio totalmente qualificado.  Nas migrações do Exchange, use essa opção com --exchange_admin_login. Ao usar esse argumento, não use --exchange_profile_name. Exemplo: --source_server="mailserver.example.com"	Endereço IP do servidor Exchange ou nome do domínio totalmente qualificado
--strip_user_labels Especifica que as mensagens são migradas sem marcadores.	Não é preciso usar parâmetros
--translate_conflicting_events Instrui o GWMME a identificar os eventos já migrados para o Google Agenda e modifica os eventos traduzindo o endereço de e-mail do recurso do Exchange para o do recurso do Google Workspace correspondente. Muitos administradores preferem migrar primeiro os usuários e depois os recursos da agenda. Se optar por migrar recursos da agenda depois, configure o GWMME para migrar novamente os dados dos usuários. Para fazer isso, use --translate_conflicting_events.	Não é preciso usar parâmetros

_{Google, Google Workspace e marcas e logotipos relacionados são marcas registradas da Google LLC. Todos os outros nomes de empresas e produtos são marcas registradas das empresas às quais eles estão associados.}