Массовый импорт внешних контактов в Exchange OnlineBulk import external contacts to Exchange Online

Эта статья для администраторов. Вы пытаетесь импортировать контакты в собственный почтовый ящик? См. в обзоре Импорт контактов в OutlookThis article is for administrators. Are you trying to import contacts to your own mailbox? See Import contacts to Outlook

Имеет ли ваша компания множество существующих бизнес-контактов, которые необходимо включить в общую адресную книгу (также называемую глобальным адресным списком) в 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? Вы хотите добавить внешние контакты в качестве членов групп рассылки, как это можно сделать с пользователями внутри вашей компании?Do you want to add external contacts as members of distribution groups, just like you can with users inside your company? Если это так, вы можете использовать Exchange Online PowerShell и CSV (разделенное запятой значение) для массового импорта внешних контактов в 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. Это трехшаговая процедура:It's a three-step process:

Шаг 1. Создание CSV-файла, содержаного сведения о внешних контактахStep 1: Create a CSV file that contains information about the external contacts

Шаг 2. Создание внешних контактов с PowerShellStep 2: Create the external contacts with PowerShell

Шаг 3. Добавление сведений о свойствах внешних контактовStep 3: Add information to the properties of the external contacts

После выполнения этих действий по импорту контактов можно выполнить следующие дополнительные задачи:After you complete these steps to import contacts, you can perform these additional tasks:

Шаг 1. Создание CSV-файла, содержаного сведения о внешних контактахStep 1: Create a CSV file that contains information about the external contacts

На первом этапе необходимо создать CSV-файл, содержащий сведения о каждом внешнем контакте, который необходимо импортировать в 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. Скопируйте следующий текст в текстовый файл в NotePad и сохраните его на рабочем столе в виде CSV-файла с помощью суффикса файла .csv; например, 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.

    Совет

    Если язык содержит специальные символы (например, å, ä и ö на шведском языке), сохраните CSV-файл с кодом UTF-8 или другим кодом единой кодировки при сохранения файла в NotePad.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
    

    В первой строке или строке заглавной строки файла CSV перечислены свойства контактов, которые можно использовать при импорте в 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. Каждое имя свойства разделено запятой.Each property name is separated by a comma. Каждая строка в строке загона представляет значения свойств для импорта одного внешнего контакта.Each row under the header row represents the property values for importing a single external contact.

    Примечание

    Этот текст содержит пример данных, которые можно удалить.This text includes sample data, which you can delete. Но не удаляйте и не измените первую строку (заглавную строку).But don't delete or change the first (header) row. Он содержит все свойства внешних контактов.It contains all of the properties for the external contacts.

  2. Откройте CSV-файл в Microsoft Excel, чтобы изменить CSV-файл, так как для редактирования CSV-файла проще использовать Excel.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. Создайте строку для каждого контакта, который необходимо импортировать в Exchange Online.Create a row for each contact that you want to import to Exchange Online. Заполнять как можно больше ячеек.Populate as many of the cells as possible. Эти сведения будут отображаться в общей адресной книге для каждого контакта.This information will be displayed in the shared address book for each contact.

    Важно!

    Для создания внешнего контакта необходимы следующие свойства (которые являются первыми четырьмя элементами в строке заголовки) и должны быть заполнены в 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. Команда PowerShell, которую вы запустите в шаге 2, будет использовать значения для этих свойств для создания контактов.The PowerShell command that you run in Step 2 will use the values for these properties to create the contacts.

Шаг 2. Создание внешних контактов с PowerShellStep 2: Create the external contacts with PowerShell

Следующим шагом является использование CSV-файла, созданного в шаге 1 и PowerShell, для массового импорта внешних контактов, перечисленных в CSV-файле, в 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. Подключение PowerShell к организации Exchange Online.Connect PowerShell to your Exchange Online organization. Пошаговые инструкции см. в статье Подключение к Exchange Online с помощью удаленной оболочки PowerShell.For step-by-step instructions, see Connect to Exchange Online PowerShell. Не забудьте использовать имя пользователя и пароль для глобальной учетной записи администратора при подключении к 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. После подключения PowerShell к Exchange Online перейдите к настольной папке, в которой сохранен файл CSV в шаге 1; например 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. Запустите следующую команду для создания внешних контактов: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}
    

    Создание новых контактов может занять некоторое время в зависимости от того, сколько вы импортируете.It might take a while to create the new contacts, depending on how many you're importing. После завершения работы команды PowerShell отображает список созданных новых контактов.When the command is finished running, PowerShell displays a list of the new contacts that were created.

  4. Чтобы просмотреть новые внешние контакты, перейдите в центр администрирования Exchange (EAC), а затем щелкните Контакты > получателей.To view the new external contacts, go to the Exchange admin center (EAC), and then click Recipients > Contacts.

    Совет

    Инструкции по подключению к EAC см. в центре администрирования Exchange в Exchange Online.For instructions for connecting to the EAC, see Exchange admin center in Exchange Online.

  5. При необходимости щелкните Обновление, чтобы обновить список и увидеть внешние контакты, импортируемые.If necessary, click Refresh to update the list and see the external contacts that were imported.

    Импортируемые контакты будут отображаться в общей адресной книге в Outlook и Outlook в Интернете.The imported contacts will appear in the shared address book in Outlook and Outlook on the web.

    Примечание

    Вы также можете просмотреть контакты в центре администрирования Microsoft 365, переехав к контактам > пользователей.You can also view the contacts in the Microsoft 365 admin center by going to Users > Contacts.

Шаг 3. Добавление сведений о свойствах внешних контактовStep 3: Add information to the properties of the external contacts

После запуска команды в шаге 2 создаются внешние контакты, но они не содержат никакой информации о контактах или организации, которая является информацией из большинства ячеек в 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. Это происходит потому, что при создании новых внешних контактов заполняются только необходимые свойства.This is because when you create new external contacts, only the required properties are populated. Не волнуйтесь, если у вас нет всей информации, заполненной в CSV-файле.Don't worry if you don't have all the information populated in the CSV file. Если ее нет, она не будет добавлена.If it's not there, it won't be added.

  1. Подключение PowerShell к организации Exchange Online.Connect PowerShell to your Exchange Online organization. Пошаговые инструкции см. в статье Подключение к Exchange Online с помощью удаленной оболочки PowerShell.For step-by-step instructions, see Connect to Exchange Online PowerShell.

  2. Перейдите к настольной папке, в которой сохранен файл CSV в шаге 1; например, 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. Запустите следующие две команды, чтобы добавить другие свойства из CSV-файла в внешние контакты, созданные в шаге 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}
    

    Примечание

    Параметр Manager может быть проблематичным.The Manager parameter might be problematic. Если ячейка является пустой в CSV-файле, вы получите ошибку, и ни одна из сведений о свойстве не будет добавлена в контакт.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. Если вам не нужно указать диспетчера, просто удалите из предыдущей -Manager $_.Manager команды PowerShell.If you don't need to specify a manager, then just delete -Manager $_.Manager from the previous PowerShell command.

    Опять же, может потребоваться некоторое время для обновления контактов в зависимости от того, сколько вы импортировали в шаге 1.Again, it might take a while to update the contacts, depending on how many you imported in Step 1.

  4. Чтобы убедиться, что свойства были добавлены в контакты:To verify that the properties were added to the contacts:

  5. В Центре администрирования Exchange перейдите в раздел Получатели > Контакты.In the EAC, go to Recipients > Contacts.

  6. Щелкните контакт, а затем нажмите кнопку Изменить изменить значок, чтобы отобразить  свойства контакта.Click a contact and then click Edit Edit icon to display the contact's properties.

Вот и все!That's it! Пользователи могут видеть контакты и дополнительные сведения в адресной книге Outlook и Outlook в Интернете.Users can see the contacts and the additional information in the address book Outlook and Outlook on the web.

Добавление дополнительных внешних контактовAdd more external contacts

Для добавления новых внешних контактов в Exchange Online можно повторить действия с 1 по шагу 3.You can repeat Steps 1 through Step 3 to add new external contacts in Exchange Online. Вы или пользователи в вашей компании можете просто добавить новую строку в CSV-файл для нового контакта.You or users in your company can just add a new row in the CSV file for the new contact. Затем можно запустить команды PowerShell из шаг 2 и шаг 3 для создания и добавления сведений в новые контакты.Then you can run the PowerShell commands from Step 2 and Step 3 to create and add information to the new contacts.

Примечание

При запуске команды для создания новых контактов может возникнуть ошибка, которая говорит, что контакты, созданные ранее, уже существуют.When you run the command to create new contacts, you might get an error saying that the contacts that were created earlier already exist. Но создается любой новый контакт, добавленный в CSV-файл.But any new contact added to the CSV file is created.

Скрыть внешние контакты из общей адресной книги>Hide external contacts from the shared address book>

Некоторые компании могут использовать внешние контакты только для того, чтобы они могли быть добавлены в группы рассылки.Some companies may use external contacts only so they can be added as members of distribution groups. В этом случае может потребоваться скрыть внешние контакты из общей адресной книги.In this scenario, they may want to hide external contacts from the shared address book. Вот как это сделать:Here's how:

  1. Подключение PowerShell к организации Exchange Online.Connect PowerShell to your Exchange Online organization. Пошаговые инструкции см. в статье Подключение к Exchange Online с помощью удаленной оболочки PowerShell.For step-by-step instructions, see Connect to Exchange Online PowerShell.

  2. Чтобы скрыть один внешний контакт, запустите следующую команду.To hide a single external contact, run the following command.

    Set-MailContact <external contact> -HiddenFromAddressListsEnabled $true 
    

    Например, чтобы скрыть Pilar Pinilla из общей адресной книги, запустите эту команду:For example, to hide Pilar Pinilla from the shared address book, run this command:

    Set-MailContact "Pilar Pinilla" -HiddenFromAddressListsEnabled $true
    
  3. Чтобы скрыть все внешние контакты из общей адресной книги, запустите эту команду: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  
    

После их сокрытия внешние контакты не отображаются в общей адресной книге, но их можно добавить в качестве членов группы рассылки.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.