Além de usar o Google Workspace Migration for Microsoft Exchange (GWMME) na área de trabalho do Windows, você pode executá-lo na interface de 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 necessários 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.
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"
Para mais informações sobre como transferir dados do Exchange, acesse 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"
Para mais informações sobre como transferir dados de e-mail de Contas do Google ou IMAP, acesse 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
Para mais informações sobre a transferência de arquivos PST, acesse 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 tps-reports@solarmora.com.
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
Para mais informações sobre a transferência de pastas públicas, acesse Migrar de pastas públicas.
Todos os argumentos do GWMME
Digite um argumento em uma única linha e adicione um traço duplo (--) antes dele. Alguns argumentos exigem parâmetros adicionais. Digite os parâmetros precedidos por um sinal de igual e entre aspas duplas.
A—E
| Argumento e descrição | Parâmetro |
|---|---|
|
Especifica a data de término dos 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 |
|
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 |
|
Especifica o prefixo a ser anexado a todos os marcadores no Gmail. Exemplo: --custom_label_prefix="migrated-" |
Prefixo personalizado anexado aos rótulos |
|
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 |
|
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 |
|
Ativa a distribuição de dados de eventos da agenda para uma migração da agenda. |
Não é preciso usar parâmetros |
|
Permite a migração de pastas MAPI (Exchange ou PST) ocultas. |
Não é preciso usar parâmetros |
|
Permite a migração de um servidor IMAP em vez de um servidor Exchange. |
Não é preciso usar parâmetros |
|
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\usuario@dominio.com.mbox). Veja mais detalhes sobre as restrições das mensagens do Gmail em Tipos de arquivo bloqueados no Gmail. |
Não é preciso usar parâmetros |
|
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 |
|
Permite a migração de recursos da agenda. |
Não é preciso usar parâmetros |
|
Especifica o nome de login da conta de administrador do servidor Exchange. Use esse argumento com --source_server. Exemplo: --exchange_admin_login="administrador" |
Nome de login da conta de administrador do servidor Exchange |
|
Especifica o nome do perfil do Outlook que você quer usar para se conectar ao servidor Exchange. Especifique um perfil de administrador no mesmo computador que executa o GWMME. Se usar esse argumento, não utilize:
Exemplo: --exchange_profile_name="exch_migration_admin" |
Nome de um perfil do Outlook |
|
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) |
|
Exclui pastas de nível superior com base no nome da pasta. Exemplo: --exclude_top_level_folders="Itens excluídos,Rascunhos" |
Lista separada por vírgulas de pastas de nível superior (sem espaço entre os itens da lista) |
F—M
| Argumento e descrição | Parâmetro |
|---|---|
|
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:\Documents and Settings\users.csv" |
Caminho para o arquivo CSV de nomes de usuário |
|
Limpa os IDs das agendas secundárias antes de você migrar os dados novamente. Quando você migra 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. Confira mais detalhes em Migrar conteúdo novamente. |
Não é preciso usar parâmetros |
|
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 vai começar 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 |
|
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="admin@example.com" |
Endereço de e-mail do proprietário do evento indicado para agendas de recursos |
|
Especifica o domínio do Google Workspace para onde você está migrando dados. Exemplo: --google_domain="example.com" |
Domínio do Google Workspace |
|
Mostra uma lista de argumentos para ExchangeMigration.exe. |
Não é preciso usar parâmetros |
|
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. Confira mais detalhes em Criar arquivos CSV para sua migração. Exemplos: --id_mapping_file="recursos.csv" |
Nome do arquivo |
|
Especifica o administrador do IMAP do Cyrus que tem acesso a todas as contas de IMAP no servidor. Use com --imap_admin_password. Exemplo: --imap_admin_id="admin@example.com" |
Endereço de e-mail do administrador do Cyrus |
|
Especifica a senha do administrador do IMAP do Cyrus. Use com --imap_admin_id. Exemplo: --imap_admin_password="senha" |
Senha do administrador do Cyrus |
|
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 |
|
Especifica o número da porta do servidor IMAP. Exemplo: --imap_port="143" |
Número da porta |
|
Especifica a opção de segurança que você quer usar. Use um dos seguintes códigos:
Exemplo: --imap_security="1" |
Código de um dígito |
|
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 |
|
Migra o e-mail para o Google Vault. As 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. Atente-se às seguintes restrições:
|
Não é preciso usar parâmetros |
|
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 |
|---|---|
|
Executa a migração sem incluir dados de agenda. |
Não é preciso usar parâmetros |
|
Executa a migração sem incluir dados de contato. |
Não é preciso usar parâmetros |
|
Executa a migração sem incluir dados de e-mail. |
Não é preciso usar parâmetros |
|
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. |
Não é preciso usar parâmetros |
|
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 |
|
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 aos marcadores e às agendas criados durante a migração. |
Não é preciso usar parâmetros |
|
Executa o GWMME usando a linha de comando. O modo de interface gráfica do usuário (GUI) é o padrão. |
Não é preciso usar parâmetros |
|
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 |
|
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 |
|
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:
Exemplo: --pst_base_folder="C:\pst" |
Diretório que contém arquivos PST |
|
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 |
|
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 |
|
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 |
|
Especifica o caminho do arquivo de credenciais da conta de serviço. Veja instruções sobre como acessar esse arquivo em Autorizar o GWMME para sua conta. Exemplo: --service_account_json_path ="C:\Users\admin\privatekey.json" |
Caminho para o arquivo de credenciais da conta de serviço |
|
Especifica o endereço IP do servidor Exchange ou IMAP ou o nome de domínio totalmente qualificado. Nas migrações do Exchange, use essa opção com --exchange_admin_login. Se você usar esse argumento, não use --exchange_profile_name. Exemplo: --source_server="mailserver.example.com" |
Endereço IP do servidor ou nome de domínio totalmente qualificado |
|
Especifica que as mensagens são migradas sem marcadores. |
Não é preciso usar parâmetros |
|
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 você 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 a que estão associados.