Agregar miembros de grupo de forma masiva en Microsoft Entra ID

Visión general

Puede agregar varios miembros a un grupo utilizando un archivo de valores separados por comas (CSV) para importar de forma masiva miembros de un grupo en el portal de Microsoft Entra ID.

Nociones sobre la plantilla CSV

Descargue y rellene la plantilla CSV de carga masiva para agregar correctamente miembros a un grupo de Microsoft Entra de forma masiva. Use la plantilla que descargue para la operación de importación de miembros del grupo. La plantilla actual de miembros del grupo comienza con la cabecera de columna, no con una fila version:v1.0.

Estructura de la plantilla CSV

Las filas de una plantilla CSV descargada son:

  • Encabezados de columna: conserve exactamente tal cual el encabezado completo de la columna descargada. El nombre de la propiedad entre corchetes es solo una parte del encabezado, así que no sustituya el encabezado completo solo por memberObjectIdOrUpn. El encabezado de importación del miembro del grupo actual es Member object ID or user principal name [memberObjectIdOrUpn] Required. Para los cambios en la pertenencia a grupos, puede usar el identificador de objeto del miembro o el nombre principal de usuario (UPN) en las filas situadas bajo este encabezado.
  • Fila de ejemplos: si la plantilla incluye una fila de valores de ejemplo, como Example: 9832aad8-e4fe-496b-a604-95c6eF01ae75, quite la fila de ejemplos y reemplácela por sus propias entradas.

Nota:

Los formatos de plantilla CSV varían según la operación. Algunas plantillas, como la creación o eliminación masiva de usuarios, incluyen version:v1.0 como primera fila. Otras plantillas, como las operaciones de miembros de grupos, comienzan con encabezados de columna. Descargue la plantilla para su operación específica desde el portal. No agregue una fila de versión ni ninguna otra fila que no esté en la plantilla descargada. Mantenga cualquier fila de versión y fila de encabezado de columna sin cambios.

Más instrucciones

  • Mantenga las filas de versiones y las filas de encabezado de columnas en la plantilla de carga exactamente tal y como las descargó; de lo contrario, no se podrá procesar la carga.
  • Las columnas necesarias se enumeran en primer lugar.
  • No se recomienda agregar nuevas columnas a la plantilla. Cualquier columna adicional que agregue se omitirá y no se procesará.
  • Se recomienda que descargue la versión más reciente de la plantilla CSV tan a menudo como sea posible.
  • Agregue como mínimo los UPN de dos usuarios o identificadores de objeto para cargar correctamente el archivo.
  • Introduzca un miembro por fila. No use punto y coma ni otros delimitadores para separar varios miembros de una sola fila.

Archivo .csv de ejemplo

Este es un ejemplo de un archivo CSV completado listo para la carga, que coincide con el formato de plantilla de importación del miembro del grupo actual. En este ejemplo se usan nombres principales de usuario (UPN):

Member object ID or user principal name [memberObjectIdOrUpn] Required
[email protected]
[email protected]
[email protected]
[email protected]

Como alternativa, puede usar identificadores de objeto en lugar de UPN:

Member object ID or user principal name [memberObjectIdOrUpn] Required
00aa00aa-bb11-cc22-dd33-44ee44ee44ee
11bb11bb-cc22-dd33-ee44-55ff55ff55ff
22cc22cc-dd33-ee44-ff55-66aa66aa66aa

Sugerencia

Para buscar el identificador de objeto de un usuario, vaya a Identidad>Usuarios>Todos los usuarios, seleccione el usuario y copie el ID de objeto de la página de perfil del usuario.

Importación masiva de miembros de grupo

  1. Inicie sesión en el Centro de administración de Microsoft Entra por lo menos como administrador de grupos.

  2. Vaya a Identidad.

    Nota:

    Los propietarios de grupos también pueden importar de forma masiva miembros de los grupos que poseen.

  3. Seleccione Grupos>Todos los grupos.

  4. Abra el grupo al que va a agregar miembros y luego seleccione Miembros.

  5. En la página Miembros , seleccione Operaciones masivas y, a continuación, elija Importar miembros.

  6. En la página Importación masiva de los miembros del grupo, seleccione Descargar para obtener la plantilla del archivo CSV con las propiedades de miembro de grupo requeridas.

    Captura de pantalla que muestra el comando Import Members está en la página de perfil del grupo.

  7. Abra el archivo CSV y agregue una línea para cada miembro del grupo que quiera importar al grupo. Para cada miembro, escriba su nombre principal de usuario (UPN, como [email protected]) o su identificador de objeto (un GUID como aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb). Introduzca un miembro por fila. A continuación, guarde el archivo.

  8. En la página Importación masiva de los miembros del grupo, en Cargar archivo CSV, vaya al archivo. Al seleccionar el archivo CSV, comienza su validación.

  9. Cuando finalice la validación del contenido del archivo, aparecerá el mensaje Archivo cargado correctamente en la página de importación en bloque. Si hay errores, debe corregirlos para poder enviar el trabajo.

  10. Cuando el archivo supere la validación, seleccione Enviar para iniciar la operación masiva que importa los miembros al grupo.

  11. Cuando la operación de importación finalice, una notificación indicará que la operación masiva se realizó correctamente.

Si experimenta errores, puede descargar y ver el archivo de resultados en la página Resultados de la operación masiva. El archivo contiene el motivo de cada error. El envío del archivo debe coincidir con la plantilla proporcionada e incluir los nombres de columna exactos.

Para obtener más información sobre las limitaciones de las operaciones masivas, consulte Límites del servicio de importación masiva.

Comprobación del estado de importación

Puede ver el estado de todas las solicitudes masivas pendientes en la página Resultados de la operación masiva.

  1. Navegue a Identidad>Usuarios>Resultados de la operación masiva.

  2. Encuentre su operación masiva en la lista. La columna Estado muestra si la operación está en curso, Correcta o Con errores.

    Recorte de pantalla que muestra la opción Comprobar estado en la página Resultados de operaciones masivas.

Para obtener más detalles sobre cada elemento de línea dentro de la operación masiva, seleccione los valores en las columnas Número de éxitos, Número de errores o Solicitudes totales. Si se produjeron errores, se incluyen los motivos en una lista.

Descargar el archivo de resultados

Para descargar resultados detallados:

  1. En la página Resultados de la operación masiva, seleccione la operación que desea revisar.
  2. Seleccione Descargar para obtener un archivo CSV que contenga el estado de cada fila de la carga original.
  3. Abra el archivo CSV para ver qué miembros se agregaron correctamente y cuáles fallaron, junto con mensajes de error específicos.

Estos son algunos de los errores comunes:

  • Miembro no encontrado: el UPN o el identificador de objeto no existe en el directorio.
  • El miembro ya existe: el usuario ya es miembro del grupo.
  • Formato no válido: el formato upn o id. de objeto es incorrecto.

Límites del servicio de importación en bloque

Nota:

Al realizar operaciones masivas, como importar o crear, puede encontrar un problema si la operación masiva no se completa en el plazo de la hora. Para solucionar este problema, se recomienda dividir el número de registros procesados por lote. Por ejemplo, antes de iniciar una exportación, puede limitar el conjunto de resultados filtrando por un tipo de grupo o un nombre de usuario para reducir el tamaño de los resultados. Al refinar los filtros, básicamente limitas los datos que devuelve la operación masiva. Para más información, consulte Limitaciones del servicio de operaciones masivas.

Pasos siguientes

  • Last updated on