Importar contatos externos em massa para Exchange Online

  • Artigo

Este artigo é para administradores. Está tentando importar contatos para sua própria caixa de correio? Consulte Importar contatos para o Outlook

Sua empresa tem muitos contatos comerciais existentes que você deseja incluir no catálogo de endereços compartilhados (também chamado de lista de endereços global) no Exchange Online? Deseja adicionar contatos externos como membros de grupos de distribuição, assim como pode com usuários dentro de sua empresa? Nesse caso, você pode usar Exchange Online PowerShell e um arquivo CSV (valor separado por vírgula) para importar em massa contatos externos para Exchange Online. É um processo de três etapas:

Etapa 1: criar um arquivo CSV que contenha informações sobre os contatos externos

Etapa 2: criar os contatos externos com o PowerShell

Etapa 3: adicionar informações às propriedades dos contatos externos

Depois de concluir estas etapas para importar contatos, você poderá executar estas tarefas adicionais:

Dica

Se você não for um cliente E5, use a avaliação de soluções do Microsoft Purview de 90 dias para explorar como recursos adicionais do Purview podem ajudar sua organização a gerenciar as necessidades de segurança e conformidade de dados. Comece agora no hub de avaliações portal de conformidade do Microsoft Purview. Saiba mais sobre os termos de inscrição e avaliação.

Etapa 1: criar um arquivo CSV que contenha informações sobre os contatos externos

A primeira etapa é criar um arquivo CSV que contenha informações sobre cada contato externo que você deseja importar para Exchange Online.

  1. Copie o texto a seguir para um arquivo de texto no NotePad e salve-o em sua área de trabalho como um arquivo CSV usando um sufixo de nome de arquivo de .csv; por exemplo, ExternalContacts.csv.

    Dica

    Se o idioma contiver caracteres especiais (como å, ä e ö em sueco) salve o arquivo CSV com UTF-8 ou outra codificação Unicode ao salvar o arquivo no NotePad.

    ExternalEmailAddress,Name,FirstName,LastName,StreetAddress,City,StateorProvince,PostalCode,Phone,MobilePhone,Pager,HomePhone,Company,Title,OtherTelephone,Department,CountryOrRegion,Fax,Initials,Notes,Office,Manager
danp@fabrikam.com,Dan Park,Dan,Park,1234 23rd Ave,Golden,CO,80215,206-111-1234,303-900-1234,555-1212,123-456-7890,Fabrikam,Shipping clerk,555-5555,Shipping,US,123-4567,R.,Good worker,31/1663,Dan Park
pilar@contoso.com,Pilar Pinilla,Pilar,Pinilla,1234 Main St.,Seattle,WA,98017,206-555-0100,206-555-0101,206-555-0102,206-555-1234,Contoso,HR Manager,206-555-0104,Executive,US,206-555-0105,P.,Technical decision maker,31/1000,Dan Park

    A primeira linha, ou linha de cabeçalho, do arquivo CSV lista as propriedades dos contatos que podem ser usados ao importá-los para Exchange Online. Cada nome da propriedade é separado por uma vírgula. Cada linha sob a linha de cabeçalho representa os valores da propriedade para importar um único contato externo.

    Observação

    Este texto inclui dados de exemplo, que você pode excluir. Mas não exclua ou altere a primeira linha (cabeçalho). Ele contém todas as propriedades para os contatos externos.

  2. Abra o arquivo CSV no Microsoft Excel para editar o arquivo CSV porque é muito mais fácil usar o Excel para editar o arquivo CSV.

  3. Crie uma linha para cada contato que você deseja importar para Exchange Online. Preencha o maior número possível de células. Essas informações serão exibidas no catálogo de endereços compartilhado para cada contato.

    Importante

    As propriedades a seguir (que são os quatro primeiros itens na linha de cabeçalho) são necessárias para criar um contato externo e devem ser preenchidas no arquivo CSV: ExternalEmailAddress, Name, FirstName, LastName. O comando do PowerShell executado na Etapa 2 usará os valores dessas propriedades para criar os contatos.

Etapa 2: criar os contatos externos com o PowerShell

A próxima etapa é usar o arquivo CSV que você criou na Etapa 1 e no PowerShell para importar em massa os contatos externos listados no arquivo CSV para Exchange Online.

  1. Conecte o PowerShell à sua organização Exchange Online. Para obter instruções passo a passo, confira Conectar-se ao Exchange Online Windows PowerShell. Use o nome de usuário e a senha para sua conta de administrador global ao se conectar ao Exchange Online PowerShell.

  2. Depois de conectar o PowerShell ao Exchange Online, acesse a pasta da área de trabalho em que você salvou o arquivo CSV na Etapa 1; por exemploC:\Users\Administrator\desktop.

  3. Execute o seguinte comando para criar os contatos externos:

    Import-Csv .\ExternalContacts.csv|%{New-MailContact -Name $_.Name -DisplayName $_.Name -ExternalEmailAddress $_.ExternalEmailAddress -FirstName $_.FirstName -LastName $_.LastName}

    Pode levar um tempo para criar os novos contatos, dependendo de quantos você está importando. Quando o comando é concluído em execução, o PowerShell exibe uma lista dos novos contatos que foram criados.

  4. Para exibir os novos contatos externos, acesse o Centro de administração do Exchange (EAC) e clique em Contatos de Destinatários>.

    Dica

    Para obter instruções para se conectar ao EAC, consulte Centro de administração do Exchange em Exchange Online.

  5. Se necessário, clique em Atualizar para atualizar a lista e veja os contatos externos importados.

    Os contatos importados serão exibidos no catálogo de endereços compartilhados no Outlook e Outlook na Web.

    Observação

    Você também pode exibir os contatos no Centro de administração do Microsoft 365 acessandocontatos de usuários>.

Etapa 3: adicionar informações às propriedades dos contatos externos

Depois de executar o comando na Etapa 2, os contatos externos são criados, mas eles não contêm nenhuma das informações de contato ou organização, que são as informações da maioria das células no arquivo CSV. Isso ocorre porque, quando você cria novos contatos externos, apenas as propriedades necessárias são preenchidas. Não se preocupe se você não tiver todas as informações preenchidas no arquivo CSV. Se não estiver lá, não será adicionado.

  1. Conecte o PowerShell à sua organização Exchange Online. Para obter instruções passo a passo, confira Conectar-se ao Exchange Online Windows PowerShell.

  2. Vá para a pasta da área de trabalho em que você salvou o arquivo CSV na Etapa 1; por exemplo, C:\Users\Administrator\desktop.

  3. Execute o comando a seguir para adicionar as outras propriedades do arquivo CSV aos contatos externos que você criou na Etapa 2.

     Import-Csv .\ExternalContacts.csv|%{Set-Contact -Identity $_.Name -StreetAddress $_.StreetAddress -City $_.City -StateorProvince $_.StateorProvince -PostalCode $_.PostalCode -Phone $_.Phone -MobilePhone $_.MobilePhone -Pager $_.Pager -HomePhone $_.HomePhone -Company $_.Company -Title $_.Title -OtherTelephone $_.OtherTelephone -Department $_.Department -Fax $_.Fax -Initials $_.Initials -Notes  $_.Notes -Office $_.Office -Manager $_.Manager}

    Observação

    O parâmetro Manager pode ser problemático. Se a célula estiver em branco no arquivo CSV, você receberá um erro e nenhuma das informações de propriedade será adicionada ao contato. Se você não precisar especificar um gerenciador, basta excluir -Manager $_.Manager do comando anterior do PowerShell.

    Novamente, pode levar um tempo para atualizar os contatos, dependendo de quantos você importou na Etapa 1.

  4. Para verificar se as propriedades foram adicionadas aos contatos:

  5. No centro de administração do Exchange, acesse Contatos de Destinatários>.

  6. Clique em um contato e clique em Editarícone. Para exibir as propriedades do contato.

Isso é tudo. Os usuários podem ver os contatos e as informações adicionais no catálogo de endereços Outlook e Outlook na Web.

Adicionar mais contatos externos

Você pode repetir as Etapas 1 a Etapa 3 para adicionar novos contatos externos no Exchange Online. Você ou usuários da sua empresa podem apenas adicionar uma nova linha no arquivo CSV para o novo contato. Em seguida, você pode executar os comandos do PowerShell da Etapa 2 e da Etapa 3 para criar e adicionar informações aos novos contatos.

Observação

Ao executar o comando para criar novos contatos, você pode receber um erro dizendo que os contatos criados anteriormente já existem. Mas qualquer novo contato adicionado ao arquivo CSV é criado.

Ocultar contatos externos do catálogo de endereços compartilhados

Algumas empresas só podem usar contatos externos para que possam ser adicionadas como membros de grupos de distribuição. Nesse cenário, eles podem querer ocultar contatos externos do catálogo de endereços compartilhados. Veja como:

  1. Conecte o PowerShell à sua organização Exchange Online. Para obter instruções passo a passo, confira Conectar-se ao Exchange Online Windows PowerShell.

  2. Para ocultar um único contato externo, execute o comando a seguir.

    Set-MailContact <external contact> -HiddenFromAddressListsEnabled $true

    Por exemplo, para ocultar Pilar Pinilla do catálogo de endereços compartilhado, execute este comando:

    Set-MailContact "Pilar Pinilla" -HiddenFromAddressListsEnabled $true

  3. Para ocultar todos os contatos externos do catálogo de endereços compartilhados, execute este comando:

    Get-Contact -ResultSize unlimited -Filter {(RecipientTypeDetails -eq 'MailContact')} | Set-MailContact -HiddenFromAddressListsEnabled $true

Depois de escondê-los, os contatos externos não são exibidos no catálogo de endereços compartilhados, mas você ainda pode adicioná-los como membros de um grupo de distribuição.