외부 연락처를 대량으로 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? 이 경우 PowerShell 및 CSV(Exchange Online 값) 파일을 사용하여 외부 연락처를 여러 개의 파일로 대량으로 가져올 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. 3단계 프로세스입니다.It's a three-step process:

1단계: 외부 연락처에 대한 정보가 포함된 CSV 파일 만들기Step 1: Create a CSV file that contains information about the external contacts

2단계: PowerShell을 사용하여 외부 연락처 만들기Step 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. 다음 텍스트를 메모장의 텍스트 파일에 복사하고 파일 이름 접미사로 를 사용하여 데스크톱에 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 또는 기타 유니코드 인코딩으로 저장합니다.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.

    중요

    외부 연락처를 만들 때 외부 연락처를 만드는 데 필요한 속성(헤더 행의 처음 4개 항목)은 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. 2단계에서 실행한 PowerShell 명령은 이러한 속성의 값을 사용하여 연락처를 생성합니다.The PowerShell command that you run in Step 2 will use the values for these properties to create the contacts.

2단계: PowerShell을 사용하여 외부 연락처 만들기Step 2: Create the external contacts with PowerShell

다음 단계는 1단계 및 PowerShell에서 만든 CSV 파일을 사용하여 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. PowerShell에 연결할 때 전역 관리자 계정의 사용자 이름과 암호를 Exchange Online 합니다.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 1단계에서 CSV 파일을 저장한 데스크톱 폴더로 이동합니다. 예를 들면 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. 새 외부 연락처를 보려면 EAC(Exchange 관리 센터)로 이동한 다음 받는 사람 연락처 > 를 클릭합니다.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. 1단계에서 CSV 파일을 저장한 데스크톱 폴더로 이동합니다. 예를 들면 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. 관리자를 지정할 필요가 없는 경우 이전 PowerShell 명령에서 -Manager $_.Manager 삭제하면 됩니다.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. EAC에서 받는 사람 > 연락처 로 이동합니다.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

1~3단계를 반복하여 외부 연락처에 새 외부 연락처를 추가할 Exchange Online.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. 그런 다음 2단계 및 3단계의 PowerShell 명령을 실행하여 새 연락처에 정보를 만들고 추가할 수 있습니다.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.