Importación masiva de contactos para Exchange Online (Office 365) mediante script de PowerShell | Parte 2#2
El artículo actual es el segundo de nuestra serie de dos artículos, en el que revisamos el proceso de importación masiva de contactos a Exchange Online (Office 365) usando PowerShell.
Los dos temas que revisaremos en este artículo son:
- Usando un script de PowerShell de “Importación masiva de contactos”. El uso del script de PowerShell simplificará y agilizará el proceso de importación de datos desde el archivo CSV y también incluirá otras tareas relacionadas.
- Cómo manipular la información del archivo CSV. La suposición subyacente es que la información que se exporta desde la infraestructura de correo actual no es totalmente compatible con la estructura de datos requerida, que se utiliza para importar datos a Exchange Online. En esta sección, revisaremos algunos ejemplos de cómo usar fórmulas de Excel para manipular datos existentes.
Importación masiva de contactos para Exchange Online (Office 365) mediante script de PowerShell | Serie de artículos
- Importación masiva de contactos para Exchange Online (Office 365) mediante PowerShell | Parte 1#2
- Importación masiva de contactos para Exchange Online (Office 365) mediante script de PowerShell | Parte 2#2
Usando el script de PowerShell para importar contactos
Para simplificar el procedimiento de importación masiva de contactos a Exchange Online, he preparado un script de PowerShell que incluye las siguientes opciones:
- Inicie sesión con sus credenciales de administrador de Office 365; esta opción nos ayudará a crear una sesión remota de PowerShell que nos conectará a Exchange Online.
- Importar contactos externos desde un archivo CSV: esta opción nos ayudará a ejecutar las dos fases del comando PowerShell: fase 1: importar la información desde un archivo CSV y crear los contactos externos necesarios en Exchange Online y fase dos: importar las propiedades para cada contacto.
- Eliminar contactos externos de un archivo CSV: en caso de que queramos eliminar el contacto externo que se importó a Exchange Online desde el archivo CSV, podemos usar esta opción.
- Importar miembros del grupo de distribución desde un archivo CSV: esta opción nos ayudará a completar el grupo de distribución existente con los contactos externos que se importaron desde el archivo CSV.
- Exportar información sobre contactos externos: esta opción nos ayudará a exportar datos sobre contactos externos de Exchange Online existentes a tres tipos de formatos de archivo: TXT, CSV y HTML.
Ejecutando el script de PowerShell import-contacts.ps1
Después de haber descargado PowerShell y extraído el archivo ZIP, guarde el script de PowerShell en una carpeta específica.
En nuestro escenario, hemos guardado import-contacts.ps1 en una carpeta llamada script en < unidadC:.
En caso de que sea la primera vez que ejecuta PowerShell en su escritorio, deberá ejecutar la consola de PowerShell como administrador y ejecutar el comando de PowerShell:
Set-ExecutionPolicy Unrestricted -forceEjecutaremos import-contacts.ps1 desde la consola de PowerShell, siguiendo los siguientes pasos:
1. “Navega” por la ubicación del script de PowerShell. Script de PowerShell
Para poder ejecutar el script de PowerShell, debemos navegar hasta la ruta en la que se encuentra el script de PowerShell.
En nuestro escenario, el script de PowerShell se encuentra en la carpeta c:\script.
Escriba el siguiente comando y presione ENTER
cd c:\script2. Proporciona el nombre del script de PowerShell.
Para ejecutar un script de PowerShell, debemos iniciar el comando con los siguientes caracteres: “.\” y luego escribir el nombre del script de PowerShell.
Por ejemplo: .\ importar-contactos.ps1
Otra opción útil que podemos usar es la función autocompletar de PowerShell.
En lugar de escribir el “nombre completo” del script de PowerShell, podemos escribir las primeras letras del nombre del script de PowerShell y dejar que PowerShell completa el resto del nombre del script.
Por ejemplo, para llamar a un script de PowerShell, necesitamos escribir los siguientes caracteres: .\ y luego escribir las primeras letras del script de PowerShell, como imp<..
Para iniciar la función autocompletar, presionamos la tecla TAB.
Después de "presionar" la tecla TAB, la consola PowerShell completará automáticamente el resto del nombre del script de PowerShell por sí mismo.
La primera tarea que debemos completar es conectarnos a Exchange Online mediante PowerShell remoto.
Para iniciar el proceso de conexión remota, seleccione el menú “0” y presione la tecla ENTER.
Aparecen ventanas emergentes de credenciales.
Tendremos que proporcionar las credenciales de administrador global de Office 365.
Menú 1 - Importar contactos externos desde un archivo CSV
Usando el menú “1“, importaremos la información del archivo CSV, crearemos objetos de contactos externos en Exchange Online e importaremos las propiedades de los contactos.
En esta fase, asumimos que ya hemos exportado la información de contacto requerida a un archivo CSV.
Escriba el número “1” y luego presione la tecla ENTER.
Aparece un mensaje que nos pide que proporcionemos la ruta al archivo CSV.
En nuestro escenario, el nombre del archivo CSV es import-contacts.ps1 y el archivo se encuentra en Temp <carpeta en la unidad C:
Para iniciar el proceso de importación presione la tecla ENTER.
La información fue importada exitosamente.
En la siguiente captura de pantalla, podemos ver el contacto externo del archivo CSV creado en Exchange Online.
Menú 3: Importar miembros del grupo de distribución desde un archivo CSV
Usando esta opción, agregaremos todos los destinatarios externos que aparecen en el archivo CSV a un grupo de distribución existente.
Esta opción nos permite completar un requisito común que está relacionado con el proceso de gestión de contactos externos.
En nuestro escenario, crearemos un nuevo grupo de distribución.
El nombre del grupo de distribución es - Contactos externos
Escriba el número “3” y luego presione la tecla ENTER.
Necesitaremos proporcionar dos parámetros:
1. La ruta al archivo CSV
Aparece un mensaje que nos pide que proporcionemos la ruta al archivo CSV.
En nuestro escenario, el nombre del archivo CSV es ExternalContacts_01.csv y el archivo se encuentra en la carpeta Temp . carpeta en la unidad C:
Para continuar con el siguiente paso, presione la tecla ENTER.
2. La dirección de correo electrónico del grupo de distribución.
Proporcione la dirección de correo electrónico del grupo de distribución
Para iniciar el proceso de importación, presione la tecla ENTER.
En la siguiente captura de pantalla, podemos ver que el destinatario externo que aparece en el archivo CSV se agregó correctamente como miembro del grupo de distribución Contactos externos.
Menú 4 - Exportar información sobre contactos externos
Usando la opción de exportación, podremos exportar la información sobre los contactos externos de Exchange Online existentes.
El comando de PowerShell exportará la información sobre los contactos externos en tres formatos de archivo: TEXTO, CSV y HTML.
El comando de PowerShell creará una nueva carpeta llamada - INFO en la unidad C:
Escriba el número “4” y luego presione la tecla ENTER.
La información fue exportada y está “esperándonos” en la carpeta INFO.
En la siguiente captura de pantalla podemos ver que el comando PowerShell exporta la información utilizando tres tipos de formatos de archivo.
Este es un ejemplo de la información que se exportó a formato de archivo HTML:
Cómo manipular la información en el archivo CSV
En este apartado repasamos cómo “manipular” la información que existía en el archivo CSV que vamos a importar usando PowerShell a Exchange Online.
La suposición subyacente es que, en muchos escenarios, la información que exportamos no es "perfecta" y no incluye toda la información requerida sobre un contacto en particular.
Por ejemplo, una escena en la que falta el "nombre privado" del contacto (no existe) o un escenario en el que la información sobre el contacto no incluye el nombre de la empresa del contacto.
Utilizar una herramienta como Excel puede ayudarnos a “jugar” con la información existente demandando a Excel diversas fórmulas de Excel.
En la siguiente sección, revisaremos tres ejemplos de la forma en que podemos usar fórmulas de Excel para manipular datos existentes.
Ejemplo 1: extraer el nombre de la dirección de correo electrónico
Descripción del escenario
Al buscar en nuestro archivo CSV, hemos notado que falta el “Nombre” para algunos de nuestros contactos.
Nos gustaría "completar" la información "robando" el nombre individual de la dirección de correo electrónico de contacto.
Para poder completar esta tarea, usaremos la función de Excel llamada - BUSCAR.
En nuestro escenario, le indicamos a la función BUSCAR que vaya a la celda que incluye la dirección de correo electrónico del contacto y “tomar” la parte izquierda de la dirección de correo electrónico (el alias del destinatario).
La sintaxis de la función que utilizamos es:
=IZQUIERDA(E2,BUSCAR(“@”,E2)-1)
Ejemplo 2: extraer el nombre de la empresa de la dirección de correo electrónico
Descripción del escenario
Al buscar en nuestro archivo CSV, hemos notado que falta el “nombre de la empresa” para algunos de nuestros contactos.
Nos gustaría “completar” la información, “robando” el nombre de la empresa que aparece como parte del nombre de dominio de la dirección de correo electrónico.
Para poder completar esta tarea, usaremos la función de Excel llamada - BUSCAR.
En nuestro escenario, le indicamos a la función BUSCAR que vaya a la celda que incluye la dirección de correo electrónico del contacto. y “tomar” la parte izquierda de la dirección de correo electrónico (el alias del destinatario).
La sintaxis de la función que utilizamos es:
=IZQUIERDA(REPLACE(E4,1,BUSCAR(“@ ”,E4), ” ”),BUSCAR(“. ”,REPLACE(E4,1,BUSCAR(“@ ”,E4), ” ”)) -1)
Ejemplo 3: combinar valores de diferentes celdas + agregar espacio
Descripción del escenario
Al buscar en nuestro archivo CSV, hemos notado que el “Nombre” (también descrito como - Nombre para mostrar o Nombre completo) falta para algunos de nuestros contactos.
Nos gustaría “completar” la información, “robando” el nombre de la empresa que aparece como parte del nombre de dominio de la dirección de correo electrónico.
Para poder completar esta tarea, usaremos la función de Excel denominada - CONCATENAR.
En nuestro escenario, le indicamos a la función CONCATENAR que vaya a la celda de Excel que incluye el nombre y a la celda de Excel que incluye el apellido y "combina" estos dos valores separados en un solo valor.
La sintaxis de la función que utilizamos es:
=CONCATENAR(E8, ” “,F8)
Descargue el archivo Excel
Puede descargar el archivo Excel: Sample-Contacts.xls