Importación masiva de contactos externos a Exchange OnlineBulk import external contacts to Exchange Online

Este artículo está para administradores. ¿Está intentando importar contactos a su propio buzón? Vea Importar contactos a OutlookThis article is for administrators. Are you trying to import contacts to your own mailbox? See Import contacts to Outlook

¿Su empresa tiene muchos contactos empresariales existentes que desea incluir en la libreta de direcciones compartida (también denominada lista global de direcciones) en 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? ¿Desea agregar contactos externos como miembros de grupos de distribución, tal como puede hacer con los usuarios de su empresa?Do you want to add external contacts as members of distribution groups, just like you can with users inside your company? Si es así, puede usar Exchange Online PowerShell y un archivo CSV (valor separado por comas) para importar contactos externos masivamente a 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. Es un proceso de tres pasos:It's a three-step process:

Paso 1: Crear un archivo CSV que contenga información sobre los contactos externosStep 1: Create a CSV file that contains information about the external contacts

Paso 2: Crear los contactos externos con PowerShellStep 2: Create the external contacts with PowerShell

Paso 3: Agregar información a las propiedades de los contactos externosStep 3: Add information to the properties of the external contacts

Después de completar estos pasos para importar contactos, puede realizar estas tareas adicionales:After you complete these steps to import contacts, you can perform these additional tasks:

Paso 1: Crear un archivo CSV que contenga información sobre los contactos externosStep 1: Create a CSV file that contains information about the external contacts

El primer paso es crear un archivo CSV que contenga información sobre cada contacto externo que desee importar a 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 el texto siguiente en un archivo de texto en el Bloc de notas y guárdelo en el escritorio como un archivo CSV mediante un sufijo de nombre de archivo de .csv; por ejemplo, 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.

    Sugerencia

    Si el idioma contiene caracteres especiales (como å, ä y ö en sueco) guarde el archivo CSV con UTF-8 u otra codificación Unicode al guardar el archivo en el Bloc 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
    

    La primera fila, o fila de encabezado, del archivo CSV enumera las propiedades de los contactos que se pueden usar al importarlas a 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 nombre de propiedad está separado por una coma.Each property name is separated by a comma. Cada fila debajo de la fila de encabezado representa los valores de propiedad para importar un único contacto externo.Each row under the header row represents the property values for importing a single external contact.

    Nota

    Este texto incluye datos de ejemplo, que puede eliminar.This text includes sample data, which you can delete. Pero no elimine ni cambie la primera fila (encabezado).But don't delete or change the first (header) row. Contiene todas las propiedades de los contactos externos.It contains all of the properties for the external contacts.

  2. Abra el archivo CSV en Microsoft Excel para editar el archivo CSV porque es mucho más fácil usar Excel para editar el archivo 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. Cree una fila para cada contacto que desee importar a Exchange Online.Create a row for each contact that you want to import to Exchange Online. Rellene tantas celdas como sea posible.Populate as many of the cells as possible. Esta información se mostrará en la libreta de direcciones compartida para cada contacto.This information will be displayed in the shared address book for each contact.

    Importante

    Las siguientes propiedades (que son los cuatro primeros elementos de la fila de encabezado) son necesarias para crear un contacto externo y deben rellenarse en el archivo 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. El comando de PowerShell que ejecute en el paso 2 usará los valores de estas propiedades para crear los contactos.The PowerShell command that you run in Step 2 will use the values for these properties to create the contacts.

Paso 2: Crear los contactos externos con PowerShellStep 2: Create the external contacts with PowerShell

El siguiente paso es usar el archivo CSV que creó en los pasos 1 y PowerShell para importar masivamente los contactos externos enumerados en el archivo CSV a 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. Conecte PowerShell a su organización de Exchange Online.Connect PowerShell to your Exchange Online organization. Para obtener instrucciones, consulte Conexión a Exchange Online PowerShell.For step-by-step instructions, see Connect to Exchange Online PowerShell. Asegúrese de usar el nombre de usuario y la contraseña para su cuenta de administrador global al conectarse a 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. Después de conectar PowerShell a Exchange Online, vaya a la carpeta de escritorio donde guardó el archivo CSV en el paso 1; por ejemplo 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. Ejecute el siguiente comando para crear los contactos 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}
    

    Puede tardar un tiempo en crear los nuevos contactos, en función de cuántos importes.It might take a while to create the new contacts, depending on how many you're importing. Cuando el comando termina de ejecutarse, PowerShell muestra una lista de los nuevos contactos que se crearon.When the command is finished running, PowerShell displays a list of the new contacts that were created.

  4. Para ver los nuevos contactos externos, vaya al Centro de administración de Exchange (EAC) y, a continuación, haga clic en Contactos de > destinatarios.To view the new external contacts, go to the Exchange admin center (EAC), and then click Recipients > Contacts.

    Sugerencia

    Para obtener instrucciones para conectarse al EAC, vea Centro de administración de Exchange en Exchange Online.For instructions for connecting to the EAC, see Exchange admin center in Exchange Online.

  5. Si es necesario, haga clic en Actualizar para actualizar la lista y ver los contactos externos que se importaron.If necessary, click Refresh to update the list and see the external contacts that were imported.

    Los contactos importados aparecerán en la libreta de direcciones compartida en Outlook y Outlook en la web.The imported contacts will appear in the shared address book in Outlook and Outlook on the web.

    Nota

    También puede ver los contactos en el Centro de administración de Microsoft 365 yendo a Contactos > de usuarios.You can also view the contacts in the Microsoft 365 admin center by going to Users > Contacts.

Paso 3: Agregar información a las propiedades de los contactos externosStep 3: Add information to the properties of the external contacts

Después de ejecutar el comando en el paso 2, se crean los contactos externos, pero no contienen ninguna información de contacto u organización, que es la información de la mayoría de las celdas del archivo 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. Esto se debe a que al crear nuevos contactos externos, solo se rellenan las propiedades necesarias.This is because when you create new external contacts, only the required properties are populated. No se preocupe si no tiene toda la información rellenada en el archivo CSV.Don't worry if you don't have all the information populated in the CSV file. Si no está ahí, no se agregará.If it's not there, it won't be added.

  1. Conecte PowerShell a su organización de Exchange Online.Connect PowerShell to your Exchange Online organization. Para obtener instrucciones, consulte Conexión a Exchange Online PowerShell.For step-by-step instructions, see Connect to Exchange Online PowerShell.

  2. Vaya a la carpeta de escritorio donde guardó el archivo CSV en el paso 1; por ejemplo, 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. Ejecute los dos comandos siguientes para agregar las demás propiedades del archivo CSV a los contactos externos que creó en el paso 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}
    

    Nota

    El parámetro Manager puede ser problemático.The Manager parameter might be problematic. Si la celda está en blanco en el archivo CSV, se producirá un error y no se agregará ninguna información de propiedad al contacto.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. Si no necesita especificar un administrador, simplemente elimine -Manager $_.Manager del comando de PowerShell anterior.If you don't need to specify a manager, then just delete -Manager $_.Manager from the previous PowerShell command.

    De nuevo, podría tardar un tiempo en actualizar los contactos, en función de cuántos haya importado en el paso 1.Again, it might take a while to update the contacts, depending on how many you imported in Step 1.

  4. Para comprobar que las propiedades se agregaron a los contactos:To verify that the properties were added to the contacts:

  5. En el EAC, vaya a Destinatarios > Contactos.In the EAC, go to Recipients > Contacts.

  6. Haga clic en un contacto y, a continuación, haga clic en Editar icono editar para mostrar las propiedades  del contacto.Click a contact and then click Edit Edit icon to display the contact's properties.

Y eso es todo.That's it! Los usuarios pueden ver los contactos y la información adicional en la libreta de direcciones outlook y Outlook en la web.Users can see the contacts and the additional information in the address book Outlook and Outlook on the web.

Agregar más contactos externosAdd more external contacts

Puede repetir los pasos del 1 al 3 para agregar nuevos contactos externos en Exchange Online.You can repeat Steps 1 through Step 3 to add new external contacts in Exchange Online. Usted o los usuarios de su empresa solo pueden agregar una nueva fila en el archivo CSV para el nuevo contacto.You or users in your company can just add a new row in the CSV file for the new contact. A continuación, puede ejecutar los comandos de PowerShell de los pasos 2 y 3 para crear y agregar información a los nuevos contactos.Then you can run the PowerShell commands from Step 2 and Step 3 to create and add information to the new contacts.

Nota

Al ejecutar el comando para crear nuevos contactos, es posible que reciba un error que diga que los contactos que se crearon anteriormente ya existen.When you run the command to create new contacts, you might get an error saying that the contacts that were created earlier already exist. Pero se crea cualquier contacto nuevo agregado al archivo CSV.But any new contact added to the CSV file is created.

Ocultar contactos externos de la libreta de direcciones compartida>Hide external contacts from the shared address book>

Algunas empresas pueden usar contactos externos solo para que se puedan agregar como miembros de grupos de distribución.Some companies may use external contacts only so they can be added as members of distribution groups. En este escenario, es posible que desee ocultar contactos externos de la libreta de direcciones compartida.In this scenario, they may want to hide external contacts from the shared address book. A continuación se describe cómo:Here's how:

  1. Conecte PowerShell a su organización de Exchange Online.Connect PowerShell to your Exchange Online organization. Para obtener instrucciones, consulte Conexión a Exchange Online PowerShell.For step-by-step instructions, see Connect to Exchange Online PowerShell.

  2. Para ocultar un único contacto externo, ejecute el siguiente comando.To hide a single external contact, run the following command.

    Set-MailContact <external contact> -HiddenFromAddressListsEnabled $true 
    

    Por ejemplo, para ocultar Pilar Pinilla de la libreta de direcciones compartida, ejecute 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 los contactos externos de la libreta de direcciones compartida, ejecute 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  
    

Después de ocultarlos, los contactos externos no se muestran en la libreta de direcciones compartida, pero aún puede agregarlos como miembros de un grupo de distribución.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.