Importar contatos externos em massa para Exchange OnlineBulk import external contacts to Exchange Online

Este artigo é para administradores. Você está tentando importar contatos para sua própria caixa de correio? Consulte Importar contatos para OutlookThis article is for administrators. Are you trying to import contacts to your own mailbox? See Import contacts to Outlook

Sua empresa tem muitos contatos comerciais existentes que você deseja incluir no livro de endereços compartilhado (também chamado de lista de endereços global) no Exchange Online?Does your company have lots of existing business contacts that you want to include in the shared address book (also called the global address list) in Exchange Online? Deseja adicionar contatos externos como membros de grupos de distribuição, da mesma forma que você pode com usuários dentro da sua empresa?Do you want to add external contacts as members of distribution groups, just like you can with users inside your company? Em caso afirmativo, você pode usar Exchange Online PowerShell e um arquivo CSV (valor separado por vírgula) para importar em massa contatos externos para Exchange Online.If so, you can use Exchange Online PowerShell and a CSV (comma-separated value) file to bulk import external contacts into Exchange Online. É um processo de três etapas:It's a three-step process:

Etapa 1: Criar um arquivo CSV que contenha informações sobre os contatos externosStep 1: Create a CSV file that contains information about the external contacts

Etapa 2: Criar contatos externos com o PowerShellStep 2: Create the external contacts with PowerShell

Etapa 3: Adicionar informações às propriedades dos contatos externosStep 3: Add information to the properties of the external contacts

Depois de concluir essas etapas para importar contatos, você pode executar estas tarefas adicionais:After you complete these steps to import contacts, you can perform these additional tasks:

Etapa 1: Criar um arquivo CSV que contenha informações sobre os contatos externosStep 1: Create a CSV file that contains information about the external contacts

A primeira etapa é criar um arquivo CSV que contenha informações sobre cada contato externo que você deseja importar para Exchange Online.The first step is to create a CSV file that contains information about each external contact that you want to import to Exchange Online.

  1. Copie o texto a seguir para um arquivo de texto no Bloco de Notas 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.Copy the following text to a text file in NotePad, and save it on your desktop as a CSV file by using a filename suffix of .csv; for example, ExternalContacts.csv.

    Dica

    Se seu 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 Bloco de Notas.If your language contains special characters (such as å, ä, and ö in Swedish) save the CSV file with UTF-8 or other Unicode encoding when you save the file in 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 header, do arquivo CSV lista as propriedades dos contatos que podem ser usados quando você os importa para Exchange Online.The first row, or header row, of the CSV file lists the properties of contacts that can be used when you import them to Exchange Online. Cada nome da propriedade é separado por uma vírgula.Each property name is separated by a comma. Cada linha sob a linha de header representa os valores de propriedade para importar um único contato externo.Each row under the header row represents the property values for importing a single external contact.

    Observação

    Este texto inclui dados de exemplo, que você pode excluir.This text includes sample data, which you can delete. Mas não exclua ou altere a primeira linha (de header).But don't delete or change the first (header) row. Ele contém todas as propriedades dos contatos externos.It contains all of the properties for the external contacts.

  2. Abra o arquivo CSV Microsoft Excel editar o arquivo CSV porque é muito mais fácil usar Excel editar o arquivo CSV.Open the CSV file in Microsoft Excel to edit the CSV file because it's much easier to use Excel to edit the CSV file.

  3. Crie uma linha para cada contato que você deseja importar para Exchange Online.Create a row for each contact that you want to import to Exchange Online. Preencha o maior número possível de células.Populate as many of the cells as possible. Essas informações serão exibidas no livro de endereços compartilhado para cada contato.This information will be displayed in the shared address book for each contact.

    Importante

    As seguintes propriedades (que são os quatro primeiros itens na linha do header) são necessárias para criar um contato externo e devem ser preenchidas no arquivo CSV: ExternalEmailAddress, Name, FirstName, LastName.The following properties (which are the first four items in the header row) are required to create an external contact and must be populated in the CSV file: ExternalEmailAddress, Name, FirstName, LastName. O comando do PowerShell executado na Etapa 2 usará os valores dessas propriedades para criar os contatos.The PowerShell command that you run in Step 2 will use the values for these properties to create the contacts.

Etapa 2: Criar contatos externos com o PowerShellStep 2: Create the external contacts with 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.The next step is to use the CSV file that you created in Step 1 and PowerShell to bulk import the external contacts listed in the CSV file to Exchange Online.

  1. Conexão PowerShell para sua Exchange Online organização.Connect PowerShell to your Exchange Online organization. Para obter instruções passo a passo, confira Conectar-se ao Exchange Online Windows PowerShell.For step-by-step instructions, see Connect to Exchange Online PowerShell. Certifique-se de usar o nome de usuário e a senha da sua conta de administrador global quando você se conectar ao Exchange Online PowerShell.Be sure to use the user name and password for your global administrator account when you connect to Exchange Online PowerShell.

  2. Depois de conectar o PowerShell ao Exchange Online, vá para a pasta da área de trabalho onde você salvou o arquivo CSV na Etapa 1; por exemplo C:\Users\Administrator\desktop .After you connect PowerShell to Exchange Online, go to the desktop folder where you saved the CSV file in Step 1; for example C:\Users\Administrator\desktop.

  3. Execute o seguinte comando para criar os contatos externos:Run the following command to create the external contacts:

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

    Pode demorar um pouco para criar os novos contatos, dependendo de quantos você está importando.It might take a while to create the new contacts, depending on how many you're importing. Quando o comando é concluído em execução, o PowerShell exibe uma lista dos novos contatos que foram criados.When the command is finished running, PowerShell displays a list of the new contacts that were created.

  4. Para exibir os novos contatos externos, vá para o centro de administração Exchange (EAC) e clique em > Destinatários Contatos.To view the new external contacts, go to the Exchange admin center (EAC), and then click Recipients > Contacts.

    Dica

    Para obter instruções sobre como se conectar ao EAC, consulte Exchange centro de administração em Exchange Online.For instructions for connecting to the EAC, see Exchange admin center in Exchange Online.

  5. Se necessário, clique em Atualizar para atualizar a lista e consulte os contatos externos que foram importados.If necessary, click Refresh to update the list and see the external contacts that were imported.

    Os contatos importados aparecerão no livro de endereços compartilhado Outlook e Outlook na Web.The imported contacts will appear in the shared address book in Outlook and Outlook on the web.

    Observação

    Você também pode exibir os contatos no centro de administração do Microsoft 365, indo para Contatos > de Usuários.You can also view the contacts in the Microsoft 365 admin center by going to Users > Contacts.

Etapa 3: Adicionar informações às propriedades dos contatos externosStep 3: Add information to the properties of the external contacts

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.After you run the command in Step 2, the external contacts are created, but they don't contain any of the contact or organization information, which is the information from most of the cells in the CSV file. Isso acontece porque, quando você cria novos contatos externos, apenas as propriedades necessárias são preenchidas.This is because when you create new external contacts, only the required properties are populated. Não se preocupe se você não tiver todas as informações preenchidas no arquivo CSV.Don't worry if you don't have all the information populated in the CSV file. Se ele não estiver lá, ele não será adicionado.If it's not there, it won't be added.

  1. Conexão PowerShell para sua Exchange Online organização.Connect PowerShell to your Exchange Online organization. Para obter instruções passo a passo, confira Conectar-se ao Exchange Online Windows PowerShell.For step-by-step instructions, see Connect to Exchange Online PowerShell.

  2. Vá para a pasta da área de trabalho onde você salvou o arquivo CSV na Etapa 1; por exemplo, C:\Users\Administrator\desktop .Go to the desktop folder where you saved the CSV file in Step 1; for example, C:\Users\Administrator\desktop.

  3. Execute os dois comandos a seguir para adicionar as outras propriedades do arquivo CSV aos contatos externos que você criou na Etapa 2.Run the following two commands to add the other properties from the CSV file to the external contacts that you created in Step 2.

    $Contacts = Import-CSV .\ExternalContacts.csv
    
    
    $contacts | ForEach {Set-Contact $_.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.The Manager parameter might be problematic. 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.If the cell is blank in the CSV file, you will get an error and none of the property information will be added to the contact. Se você não precisar especificar um gerente, exclua do -Manager $_.Manager comando anterior do PowerShell.If you don't need to specify a manager, then just delete -Manager $_.Manager from the previous PowerShell command.

    Novamente, pode demorar um pouco para atualizar os contatos, dependendo de quantos você importou na Etapa 1.Again, it might take a while to update the contacts, depending on how many you imported in Step 1.

  4. Para verificar se as propriedades foram adicionadas aos contatos:To verify that the properties were added to the contacts:

  5. No EAC, acesse Destinatários > Contatos.In the EAC, go to Recipients > Contacts.

  6. Clique em um contato e clique em Editar  ícone editar para exibir as propriedades do contato.Click a contact and then click Edit Edit icon to display the contact's properties.

Isso é tudo.That's it! Os usuários podem ver os contatos e as informações adicionais no Outlook e Outlook na Web.Users can see the contacts and the additional information in the address book Outlook and Outlook on the web.

Adicionar mais contatos externosAdd more external contacts

Você pode repetir as Etapas 1 a Etapa 3 para adicionar novos contatos externos Exchange Online.You can repeat Steps 1 through Step 3 to add new external contacts in Exchange Online. Você ou usuários em sua empresa podem apenas adicionar uma nova linha no arquivo CSV para o novo contato.You or users in your company can just add a new row in the CSV file for the new contact. Em seguida, você pode executar os comandos do PowerShell da Etapa 2 e Etapa 3 para criar e adicionar informações aos novos contatos.Then you can run the PowerShell commands from Step 2 and Step 3 to create and add information to the new contacts.

Observação

Ao executar o comando para criar novos contatos, você pode receber um erro dizendo que os contatos que foram criados anteriormente já existem.When you run the command to create new contacts, you might get an error saying that the contacts that were created earlier already exist. Mas qualquer novo contato adicionado ao arquivo CSV é criado.But any new contact added to the CSV file is created.

Ocultar contatos externos do livro de endereços compartilhado>Hide external contacts from the shared address book>

Algumas empresas podem usar contatos externos apenas para que possam ser adicionados como membros de grupos de distribuição.Some companies may use external contacts only so they can be added as members of distribution groups. Nesse cenário, eles podem querer ocultar contatos externos do livro de endereços compartilhado.In this scenario, they may want to hide external contacts from the shared address book. Veja como:Here's how:

  1. Conexão PowerShell para sua Exchange Online organização.Connect PowerShell to your Exchange Online organization. Para obter instruções passo a passo, confira Conectar-se ao Exchange Online Windows PowerShell.For step-by-step instructions, see Connect to Exchange Online PowerShell.

  2. Para ocultar um único contato externo, execute o seguinte comando.To hide a single external contact, run the following command.

    Set-MailContact <external contact> -HiddenFromAddressListsEnabled $true 
    

    Por exemplo, para ocultar Pilar Pinilla do livro de endereços compartilhado, execute este comando:For example, to hide Pilar Pinilla from the shared address book, run this command:

    Set-MailContact "Pilar Pinilla" -HiddenFromAddressListsEnabled $true
    
  3. Para ocultar todos os contatos externos do livro de endereços compartilhado, execute este comando:To hide all external contacts from the shared address book, run this command:

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

Depois que você os oculta, os contatos externos não são exibidos no livro de endereços compartilhado, mas você ainda pode adicioná-los como membros de um grupo de distribuição.After you hide them, external contacts aren't displayed in the shared address book, but you can still add them as members of a distribution group.