Invitar a usuarios invitados externos

Invitar a usuarios invitados externos a la organización

Descripción

Este runbook invita a un usuario externo como usuario invitado en Microsoft Entra ID. Las propiedades opcionales del perfil, como nombre, apellido, nombre de la empresa, ubicación de uso, responsable y patrocinador, se pueden establecer después de que se acepte la invitación. Opcionalmente, el usuario invitado puede agregarse a un grupo especificado.

Ubicación

Organización → General → Invitar a usuarios invitados externos

Nombre completo del runbook

rjgit-org_general_Invite-external-guest-users

Detalles

Propiedad	Valor
Versión	2.0.3
Módulos requeridos	RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0)
Programable	no

Notas

Casos de uso comunes:

• Invitación básica para invitado: proporcione solo la dirección de correo electrónico y el nombre para mostrar; todos los parámetros de perfil y de grupo pueden dejarse en blanco
• Incorporación completa: proporcione todos los campos opcionales para establecer las propiedades del perfil, asignar un responsable/patrocinador y agregar a un grupo en una sola ejecución

Interacciones de parámetros:

• Las propiedades del perfil (givenName, surname, companyName, usageLocation) se aplican solo cuando no están vacías; omitirlas evita por completo la llamada PATCH
• La asignación de responsable y patrocinador y la pertenencia al grupo requieren cada una sus parámetros respectivos; todo se omite silenciosamente cuando no se proporciona

Permisos

Permisos de aplicación

• Tipo: Microsoft Graph

  • User.ReadWrite.All

    • Crea la invitación, aplica PATCH a las propiedades del perfil del invitado y establece el responsable y el patrocinador
  • Group.ReadWrite.All

    • Verifica el grupo de destino y agrega al invitado mediante /groups/{id}/members/$ref
  • Organization.Read.All

    • Lee el id del Tenant para construir la URL de redirección predeterminada de la invitación

Parámetros

Correo electrónico del usuario invitado

Dirección de correo electrónico del usuario invitado a invitar.

Propiedad	Valor
Requerido	true
Valor predeterminado
Tipo	Cadena

Nombre para mostrar del usuario invitado

Nombre para mostrar del usuario invitado.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena

Id. del grupo

El ID de objeto del grupo al que agregar el usuario invitado. Si no se especifica, el usuario no se agregará a ningún grupo.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena

Nombre

Nombre de pila (nombre) del usuario invitado.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena

Apellido

Apellido (apellido) del usuario invitado.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena

Nombre de la empresa

Nombre de la empresa del usuario invitado.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena

Nombre del responsable

Responsable que se asignará al usuario invitado. Seleccione un usuario del directorio.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena

Nombre del patrocinador

Patrocinador que se asignará al usuario invitado. Seleccione un usuario del directorio.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena

Personalizar invitación

Habilítelo para personalizar el mensaje de invitación y la URL de redirección.

Propiedad	Valor
Requerido	falso
Valor predeterminado	Falso
Tipo	Booleano

Mensaje de invitación

Cuerpo del mensaje personalizado que se incluirá en el correo electrónico de invitación. Solo se usa cuando está habilitada la personalización de la invitación.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena

URL de redirección de la invitación

URL personalizada a la que se redirige al usuario después de aceptar la invitación. Solo se usa cuando está habilitada la personalización de la invitación.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena

Ubicación de uso

Código de país alfa-2 ISO 3166-1 para la ubicación de uso del usuario invitado (por ejemplo, "US", "DE").

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena

Volver a la vista general de la referencia del runbook