Compartir a través de


IA-Connect JML

IA-Connect es una plataforma "RPA" de Automatización de procesos robóticos que agrega funcionalidad RPA desde la nube a máquinas virtuales locales o a través de conexiones "RDS" de Citrix o Escritorio remoto de Microsoft. Este es el módulo para automatizar los procesos joiner, Mover y Leaver.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Ultima Labs
URL https://www.ultima.com/ultima-labs
Correo Electrónico IAConnect@ultima.com
Metadatos del conector
Publicador Última Empresa
Sitio web https://www.ultima.com/ultima-labs
Directiva de privacidad https://www.ultima.com/privacy-policy
Categorías Operaciones de TI; Productividad

IA-Connect es una plataforma de Automatización de procesos robóticos (RPA) que agrega funcionalidad de RPA desde Flujos de Power Automate Cloud a máquinas virtuales locales o a través de conexiones de Citrix o Escritorio remoto de Microsoft (RDS). Los conectores de IA-Connect proporcionan más de 800 acciones, lo que le permite automatizar cada tipo de aplicación local directamente desde un flujo de nube de Power Automate. Todas las acciones de IA-Connect están disponibles directamente desde Power Automate Cloud Flow, lo que proporciona una integración sencilla entre aplicaciones locales y basadas en la nube, la capacidad de aprovechar las condiciones, bucles, contenido dinámico, expresiones y control de excepciones existentes en los procesos de RPA. La utilización de los conectores de IA-Connect también proporciona un historial de ejecución completo y una auditoría del historial de ejecución de Flow, a la vez que elimina la necesidad de tener una aplicación, consola o estudio independiente para desarrollar los procesos de RPA.

Prerrequisitos

Para usar cualquiera de los conectores de IA-Connect, debe instalar el software IA-Connect. Esto es gratuito para probar durante 30 días, después de lo cual necesitará una licencia de IA-Connect.

El software IA-Connect consta de dos componentes principales:

  • La IA-Connect Orchestrator, que es una aplicación web de Azure que hospedaría en su propio inquilino de Azure. Esto controla el enrutamiento y la seguridad de los flujos de RPA a una o varias máquinas virtuales locales o basadas en la nube.

  • El agente y el director de IA-Connect, que se instalan en las máquinas virtuales donde se puede acceder al software que desea automatizar. Además, el agente de IA-Connect puede ejecutarse dentro de una sesión de Citrix o Microsoft Remote Desktop Services (RDS), donde los comandos de RPA se pasan a un canal virtual en la sesión remota para su ejecución. El agente de IA-Connect se puede ejecutar desde un recurso compartido de red y no requiere instalación.

Conectores de IA-Connect disponibles

Los conectores de IA-Connect disponibles son:

  • IA-Connect código dinámico
  • IA-Connect Java
  • IA-Connect JML
  • sistema central de IA-Connect
  • IA-Connect Microsoft Office
  • IA-Connect GUI de SAP
  • sesión de IA-Connect
  • interfaz de usuario de IA-Connect
  • explorador web de IA-Connect

Obtención de credenciales

Para recibir su licencia y comenzar su evaluación gratuita de 30 días, envíe una solicitud en nuestro sitio web (https://www.ultima.com/IA-Connect/Power-Automate).

Una vez recibida una solicitud de evaluación, nos pondrá en contacto con usted a través de la dirección de correo electrónico proporcionada para ayudar a configurar el software de IA-Connect y para proporcionarle la licencia de prueba. Esta es una prueba completa y le permitirá probar cualquiera de las 800 acciones en todos los 9 conectores IA-Connect dentro de su propio entorno durante el período de prueba.

Introducción al conector

Después de enviar una solicitud de prueba para IA-Connect, podrá descargar un archivo ZIP que contenga el software IA-Connect y la documentación que cubre la instalación y la instalación. También nos pondrá en contacto con usted para ofrecer soporte técnico e instrucciones a través del proceso de instalación según sea necesario.

Support

Durante el período de prueba, puede ponerse en contacto con Ultima Labs (IAConnect@ultima.com) para obtener soporte técnico y asistencia.

Al comprar licencias IA-Connect recibirá tokens de soporte técnico que se pueden canjear por formación o soporte técnico personalizados del Centro de Servicios Técnicos (TSC) basado en Reino Unido de Ultima.

Problemas conocidos, errores comunes y preguntas más frecuentes

Nuestra Knowledge Base contiene una serie de artículos que abarcan cualquier problema conocido, errores comunes que pueden producirse al usar los conectores de IA-Connect y las preguntas más frecuentes. Esto es accesible en https://support.ultima.com/ultimalabs y se proporciona una cuenta para acceder a estos recursos durante la prueba de IA-Connect y después de comprar una licencia de IA-Connect.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Clave de API securestring La clave de API de esta API Cierto
dirección de IA-Connect Orchestrator cuerda / cadena Especificar la dirección IA-Connect Orchestrator sin el componente HTTP(S) Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Adición de un objeto de Active Directory a varios grupos

Agregue un objeto de Active Directory (normalmente un usuario, grupo o equipo) a varios grupos de Active Directory existentes. IA-Connect agrega el objeto a tantos grupos como sea posible e informa sobre el resultado. Si el objeto ya es miembro de uno o varios de los grupos especificados, se cuenta como correcto.

Adición de un usuario de Active Directory

Crea una nueva cuenta de usuario de Active Directory.

Adición de un usuario de Azure AD

Crea una nueva cuenta de usuario de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Adición de un usuario de Azure AD al grupo

Agregue un usuario de Azure Active Directory a un grupo de Seguridad de Azure Active Directory o M365 existente. Esta acción no puede modificar listas de distribución ni grupos de seguridad habilitados para correo: use las acciones de Office 365 Exchange Online en su lugar. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Adición de una unidad organizativa de Active Directory

Crea una nueva unidad organizativa (OU) de Active Directory.

Adición de varios miembros del grupo de Active Directory

Agregue uno o varios objetos de Active Directory (normalmente usuarios, grupos o equipos) a un grupo de Active Directory existente. IA-Connect agrega tantos miembros al grupo como sea posible e informa sobre el resultado. Si el grupo y el miembro del grupo están en dominios diferentes, deberá especificar el nombre distintivo (DN) para los miembros y el grupo. Si algunos de los objetos ya son miembros del grupo, se cuenta como correcto.

Agregar grupo de Active Directory

Crea un nuevo grupo de Active Directory.

Agregar miembro de Microsoft Exchange al grupo de distribución

Agregue un miembro (por ejemplo, un usuario) a un grupo de distribución de Exchange. Si el miembro ya está en el grupo, no se realiza ninguna acción.

Agregar miembro de Office 365 al grupo de distribución

Agregue un miembro a un grupo de distribución de Microsoft Exchange Online u Office 365 o a un grupo de seguridad habilitado para correo.

Agregar miembro del grupo de Active Directory

Agregue un objeto de Active Directory (normalmente un usuario, grupo o equipo) a un grupo de Active Directory existente. Si el grupo y el miembro del grupo están en dominios diferentes, deberá especificar el nombre distintivo (DN) para los miembros y el grupo.

Agregar permiso de buzón de Microsoft Exchange

Asigne permisos de buzón a un objeto de Active Directory (por ejemplo, usuario o grupo).

Agregar permiso de buzón de Microsoft Exchange al usuario

Asigne permisos de buzón a un usuario de buzón, usuario o grupo de seguridad especificado.

Agregar permiso de buzón de Office 365 al usuario

Asigne permisos de buzón de Microsoft Exchange Online u Office 365 a un usuario de buzón, usuario o grupo de seguridad especificado.

Asignación de un usuario de Azure AD a varios roles de administrador

Asigne un usuario de Azure Active Directory (u otro objeto) a uno o varios roles de administrador de Azure Active Directory existentes. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Asignación de un usuario de Azure AD al rol de administrador

Asigne un usuario de Azure Active Directory (u otro objeto) a un rol de administrador de Azure Active Directory existente. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Borrar la expiración de la cuenta de usuario de Active Directory

Borra la fecha de expiración de una cuenta de Active Directory.

Clonación de la pertenencia a grupos de usuarios de Active Directory

Agrega el usuario de Active Directory de destino a los mismos grupos de Active Directory de los que el primer usuario es miembro, menos el grupo principal (normalmente "Usuarios de dominio") ya que técnicamente no es una pertenencia.

Clonación de propiedades de usuario de Active Directory

Configura las propiedades o atributos especificados del usuario de Active Directory de origen en el usuario de Active Directory de destino.

Comprobación de que existe una unidad organizativa de Active Directory

Informa si existe una unidad organizativa (OU) de Active Directory.

Conectarse a Office 365 con credenciales

Conecta IA-Connect a Office 365 mediante los módulos de PowerShell de Office 365. Esta acción (o "Conectar a Office 365 con certificado") debe emitirse antes de ejecutar cualquier otra acción de Office 365. Esta acción requiere una cuenta que no requiera MFA (2FA) o deberá usar el módulo de automatización de la interfaz de usuario para automatizar el componente 2FA (es decir, el elemento emergente de autenticación con contraseña única). Como alternativa, use la acción "Conectar a Office 365 con certificado".

Conexión a Active Directory con credenciales

Permite especificar una cuenta alternativa que se usará al ejecutar comandos de PowerShell de Active Directory. Esto afecta a todos los comandos de Active Directory emitidos después de esta acción. Si no usa esta acción, todos los comandos de PowerShell de Active Directory se ejecutarán como la cuenta de usuario en la que se ejecuta el agente de IA-Connect.

Conexión a Azure AD con certificado

Conecta IA-Connect a Azure Active Directory (también conocido como Id. de Microsoft Entra, Azure AD o AAD). Esta acción (o "Conectarse a Azure AD con credenciales") debe emitirse antes de ejecutar cualquier otra acción de Azure AD. Esta acción requiere que una entidad de servicio de Azure y el registro de aplicaciones de Azure AD con el certificado se configuren en Azure AD antes de que funcione, pero tiene la ventaja de no requerir MFA (2FA). Esta acción usa módulos de PowerShell de Azure AD v2 o Microsoft Graph.

Conexión a Azure AD con credenciales

Conecta IA-Connect a Azure Active Directory (también conocido como Id. de Microsoft Entra, Azure AD o AAD). Esta acción (o "Conectarse a Azure AD con certificado") debe emitirse antes de ejecutar cualquier otra acción de Azure AD. Esta acción requiere una cuenta que no use MFA (2FA) o tendrá que usar el módulo de automatización de la interfaz de usuario para automatizar el componente 2FA (es decir, el elemento emergente de autenticación de contraseña única). Como alternativa, use la acción "Conectar a Azure AD con certificado". Esta acción usa módulos de PowerShell para usuarios de Azure AD v2 o Microsoft Graph.

Conexión a Microsoft Exchange

Conecta IA-Connect a un servidor de Microsoft Exchange. Esta acción debe emitirse antes de ejecutar cualquier otra acción de Exchange. Si especifica un nombre de usuario y una contraseña, todas las acciones posteriores de Exchange se ejecutarán como esa cuenta. Si no especifica un nombre de usuario y una contraseña, todas las acciones posteriores de Exchange se ejecutarán como la cuenta de usuario en la que se ejecuta el agente de IA-Connect.

Conexión a Office 365 con certificado

Conecta IA-Connect a Office 365 mediante los módulos de PowerShell de Office 365. Esta acción (o "Conectar a Office 365 con credenciales") debe emitirse antes de ejecutar cualquier otra acción de Office 365. Esta acción requiere un registro de aplicación de Azure AD con el certificado y los roles correctos que se van a configurar en Azure AD antes de que funcionen, pero tiene la ventaja de no requerir MFA (2FA).

Conexión al dominio predeterminado de Active Directory

Conecta el agente de IA-Connect al dominio del equipo del que se ejecuta el agente de IA-Connect es miembro, usando la cuenta de la que el agente de IA-Connect se ejecuta como (es decir, el comportamiento predeterminado).

Conexión al entorno de JML

Conéctese a un entorno de JML donde los detalles de ese entorno se mantienen en el IA-Connect Orchestrator. Estos detalles pueden incluir credenciales, direcciones y otras configuraciones de conectividad. Por ejemplo, puede usar esta acción para conectarse a Active Directory, Microsoft Exchange, Azure AD u Office 365 Exchange Online.

Creación de un buzón de Microsoft Exchange y una cuenta de usuario

Cree un usuario habilitado para correo en Active Directory local y cree un buzón asociado en Microsoft Exchange. Use esta acción solo si el usuario no existe en Active Directory local. Si el usuario ya existe, use la acción "Crear un buzón de Microsoft Exchange para un usuario".

Creación de un nuevo grupo de Microsoft 365 de Azure AD

Crea un nuevo grupo de Microsoft 365 de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Creación de un nuevo grupo de seguridad de Azure AD

Crea un nuevo grupo de seguridad de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Crear buzón compartido de Office 365 y cuenta de usuario

Cree un buzón compartido en Microsoft Exchange online y una cuenta de usuario en Azure Active Directory/Entra ID. Use solo esta acción si el usuario aún no existe en Azure Active Directory/Entra ID. La dirección SMTP del buzón compartido se basará en el nombre, el alias o la dirección SMTP principal (en función de las entradas proporcionadas).

Crear buzón de archivo de Office 365 para el usuario existente

Crea un buzón archivado en Microsoft Exchange online para un usuario existente en Azure Active Directory/Entra ID. El usuario debe tener ya un buzón y una licencia adecuada.

Crear buzón de Microsoft Exchange Online para un usuario

Crea un buzón de correo de Microsoft Exchange Online u Office 365 (remoto) o un buzón de archivo para un usuario existente de Active Directory local que aún no tiene un buzón. La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida. También puede usar esta acción para archivar un buzón remoto existente.

Crear buzón de Office 365 y cuenta de usuario

Cree un buzón en Microsoft Exchange Online y una cuenta de usuario en Azure Active Directory/Entra ID. Use solo esta acción si el usuario aún no existe en Azure Active Directory/Entra ID. Si el usuario ya existe, asigne una licencia adecuada a la cuenta de usuario en su lugar.

Crear buzón y cuenta de usuario de Microsoft Exchange Online

Cree un usuario habilitado para correo en Active Directory local y cree un buzón remoto asociado en Microsoft Exchange Online u Office 365. Use esta acción solo si el usuario no existe en Active Directory local. Si el usuario ya existe, use la acción "Crear buzón de Microsoft Exchange Online para un usuario". La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida.

Crear un buzón de Microsoft Exchange para un usuario

Crea un buzón de Microsoft Exchange para un usuario existente que aún no tiene un buzón.

Crear un nuevo grupo de distribución de Microsoft Exchange

Crea un nuevo grupo de distribución de Microsoft Exchange o un grupo de seguridad habilitado para correo.

Crear un nuevo grupo de distribución de Office 365

Crea un nuevo grupo de seguridad habilitado para correo o grupo de distribución de Microsoft Exchange Online u Office 365.

Desbloquear cuenta de Active Directory

Desbloquee una cuenta de Active Directory. Si la cuenta no está bloqueada, este comando no hace nada.

Desconectar de Microsoft Exchange

Desconecta IA-Connect de un servidor de Microsoft Exchange (conectado mediante la acción "Conectar a Microsoft Exchange"). No podrá volver a emitir acciones de Microsoft Exchange PowerShell hasta que vuelva a conectarse.

Desconectar de Office 365

Desconecta IA-Connect de Office 365 mediante los módulos de PowerShell de Office 365 (conectados mediante la acción "Conectar a Office 365"). No podrá volver a emitir acciones de PowerShell de Office 365 hasta que vuelva a conectarse.

Desconexión de Active Directory

Si ha usado la acción "Open Active Directory PowerShell runspace with credentials" (Abrir el espacio de ejecución de PowerShell de Active Directory con credenciales) para ejecutar comandos de PowerShell de Active Directory como una cuenta de usuario alternativa o para un dominio alternativo, esta acción devuelve el agente de IA-Connect al comportamiento predeterminado de ejecutar acciones de Active Directory como la cuenta de usuario en la que se ejecuta el agente de IA-Connect.

Desconexión de Azure AD

Desconecta IA-Connect de Azure Active Directory (también conocido como Microsoft Entra ID, Azure AD o AAD). No podrá volver a emitir acciones de Azure AD hasta que se vuelva a conectar. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse originalmente.

Deshabilitación de la cuenta de usuario de Active Directory

Deshabilita una cuenta de usuario de Active Directory. Si una cuenta de usuario está deshabilitada, el usuario no puede iniciar sesión.

Deshabilitación del usuario de Azure AD

Deshabilita un usuario de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Deshabilitar el buzón de Microsoft Exchange Online para un usuario

Deshabilite un buzón existente de Microsoft Exchange Online u Office 365 (remoto). La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida.

Deshabilitar el buzón de Microsoft Exchange para un usuario

Deshabilite un buzón de Microsoft Exchange existente.

Ejecución del script de PowerShell de Active Directory

Ejecuta un script de PowerShell en el espacio de ejecución de Active Directory en la sesión donde se ejecuta el agente de IA-Connect, donde el contenido del script se pasa al agente de IA-Connect como parte del comando. Esta es la acción recomendada para ejecutar su propio código personalizado de PowerShell de Active Directory. Esta acción también se puede usar para recuperar los resultados de una ejecución anterior de un script de PowerShell, que se ejecuta como un subproceso del Agente.

Ejecución del script de PowerShell de Azure AD

Ejecuta un script de PowerShell en el espacio de ejecución de Azure Active Directory (también conocido como Id. de Entra de Microsoft, Azure AD o AAD) en la sesión en la que se ejecuta el agente de IA-Connect, donde se pasa el contenido del script al agente de IA-Connect como parte del comando. Esta es la acción recomendada para ejecutar sus propios scripts personalizados de PowerShell de Azure AD. Esta acción también se puede usar para recuperar los resultados de una ejecución anterior de un script de PowerShell, que se ejecuta como un subproceso del Agente. Esta acción usa módulos de PowerShell para usuarios de Azure AD v2 o Microsoft Graph.

Ejecución del script de PowerShell de Exchange

Ejecuta un script de PowerShell en el espacio de ejecución de Exchange en la sesión en la que se ejecuta el agente de IA-Connect, donde el contenido del script se pasa al agente de IA-Connect como parte del comando. Esta es la acción recomendada para ejecutar su propio código personalizado de PowerShell de Exchange. Esta acción también se puede usar para recuperar los resultados de una ejecución anterior de un script de PowerShell, que se ejecuta como un subproceso del Agente.

Ejecutar script de PowerShell de Office 365

Ejecuta un script de PowerShell en el espacio de ejecución de Office 365 en la sesión donde se ejecuta el agente de IA-Connect, donde el contenido del script se pasa al agente de IA-Connect como parte del comando. Esta es la acción recomendada para ejecutar su propio código personalizado de PowerShell de Office 365 Exchange Online. Esta acción también se puede usar para recuperar los resultados de una ejecución anterior de un script de PowerShell, que se ejecuta como un subproceso del Agente.

Eliminación de la seguridad de Azure AD o del grupo de Microsoft 365

Quite un grupo de seguridad de Azure Active Directory o un grupo de Microsoft 365. Esta acción no puede quitar grupos de seguridad habilitados para correo o listas de distribución: use la acción "Quitar grupo de distribución de Office 365" en su lugar. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Eliminación de la unidad organizativa de Active Directory

Quita una unidad organizativa (OU) de Active Directory. La unidad organizativa no se puede eliminar si hay objetos (por ejemplo, usuarios, grupos o equipos) en la unidad organizativa.

Eliminación de todas las licencias de usuario de Azure AD

Quita todas las licencias de usuario (SKU) de Azure AD asignadas a un usuario. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Eliminación del objeto de Active Directory de varios grupos

Quita un objeto de Active Directory (normalmente un usuario, grupo o equipo) de varios grupos de Active Directory existentes. IA-Connect quita el objeto de tantos grupos como sea posible e informa sobre el resultado. Si el objeto no es miembro de uno o varios de los grupos especificados, se cuenta como correcto.

Eliminación del permiso de buzón de Microsoft Exchange del usuario

Quite los permisos de buzón de un usuario de buzón, usuario o grupo de seguridad especificados.

Eliminación del usuario de Active Directory

Quita un usuario de Active Directory.

Eliminación del usuario de Active Directory de todos los grupos

Quita un usuario de Active Directory de todos los grupos de Active Directory de los que son miembros. IA-Connect quita al usuario de tantos grupos como sea posible e informa sobre el resultado. Esta acción solo funciona con cuentas de usuario, no puede usar esta acción para quitar una pertenencia a grupos o equipos.

Eliminación del usuario de Azure AD

Quite un usuario de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Eliminación del usuario de Azure AD de la asignación de roles de administrador

Quite un usuario de Azure Active Directory (u otro objeto) de una asignación de roles de administrador de Azure Active Directory existente. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Eliminación del usuario de Azure AD de todas las asignaciones de roles de administrador

Quita un usuario de Azure Active Directory (u otro objeto) de todos los roles de administrador de Azure Active Directory a los que están asignados. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Eliminación del usuario de Azure AD de todos los grupos

Quita un usuario de Azure Active Directory de todos los grupos de Azure Active Directory de los que son miembros. Esta acción no puede modificar listas de distribución ni grupos de seguridad habilitados para correo: use las acciones de Office 365 Exchange Online en su lugar. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Eliminación del usuario de Azure AD de varios grupos

Quita un usuario de Azure Active Directory de varios grupos de Azure Active Directory existentes en los que los grupos se especifican mediante el identificador de objeto o el nombre para mostrar. IA-Connect quita al usuario de tantos grupos como sea posible e informa sobre el resultado. Esta acción no puede modificar listas de distribución ni grupos de seguridad habilitados para correo: use las acciones de Office 365 Exchange Online en su lugar. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Eliminación del usuario de Azure AD de varios roles de administrador

Quita un usuario de Azure Active Directory (u otro objeto) de uno o varios roles de administrador de Azure Active Directory existentes. Esta acción recorre en iteración la lista de asignaciones de roles del usuario y quita los elementos coincidentes, por lo que si especifica roles no existentes que se van a quitar, esto no desencadena un error (ya que si el usuario no está en ese rol, no se intenta nada). Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Eliminación del usuario de Azure AD del grupo

Quita un usuario de Azure Active Directory de un grupo de Azure Active Directory. Esta acción no puede modificar listas de distribución ni grupos de seguridad habilitados para correo: use las acciones de Office 365 Exchange Online en su lugar. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Es el usuario de Azure AD asignado al rol de administrador.

Devuelve si se asigna un usuario de Azure Active Directory a un rol de administrador de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Esperar un buzón de Office 365

Espere a que exista un buzón de Microsoft Exchange Online u Office 365 especificado. Esto es habitual si está esperando que una configuración de sincronización o licencia de AD surta efecto. Si el buzón ya existía, la acción devolverá inmediatamente correctamente.

Establecer el envío de buzón de Exchange en nombre de

Especifique quién puede enviar en nombre de este buzón existente.

Establecer el usuario de Active Directory protegido contra la eliminación accidental

Establece una cuenta de Active Directory que se va a proteger (o no protegida) de la eliminación accidental. Si protege una cuenta frente a la eliminación accidental, no podrá eliminarla hasta que quite la protección.

Establecer Exchange para ver todo el bosque de Active Directory

Especifique si se busca o ve todo el bosque de Active Directory (incluidos los subdominios) al realizar acciones de Exchange. Es posible que tenga que usar esta acción si tiene varios dominios vinculados.

Establecer las propiedades en un buzón de Microsoft Exchange

Establezca las propiedades de un buzón de Microsoft Exchange existente.

Establecer las propiedades en un buzón de Microsoft Exchange Online

Establezca las propiedades de un buzón existente de Microsoft Exchange Online u Office 365 (remoto). La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida.

Establecer las propiedades en un buzón de Office 365

Establezca las propiedades en un buzón de Correo de Microsoft Exchange Online u Office 365.

Establecer respuestas automáticas (fuera de la oficina) para un buzón de Microsoft Exchange

Establecer respuestas automáticas (fuera de la oficina) para un buzón de Microsoft Exchange. Esta acción no funcionará para el buzón remoto en Microsoft Exchange Online u Office 365: Use la acción "Establecer respuestas automáticas (fuera de Office) para un buzón de Office 365" en su lugar.

Establecer respuestas automáticas (fuera de office) para un buzón de Office 365

Establecer respuestas automáticas (fuera de office) para un buzón de Microsoft Exchange Online u Office 365.

Establecimiento de la fecha de finalización de la expiración de la cuenta de usuario de Active Directory

Establece el final de la fecha de expiración de la cuenta para una cuenta de usuario de Active Directory. Este es el último día completo en el que se puede usar la cuenta, por lo que técnicamente la cuenta expira al principio del día siguiente. El agente de IA-Connect es consciente de esto y agrega automáticamente 1 día a la fecha de entrada proporcionada al almacenar la fecha en Active Directory.

Establecimiento de la licencia de usuario de Azure AD

Agrega o quita una licencia de usuario (SKU) de Azure AD. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Establecimiento del administrador del usuario de Azure AD

Establezca el administrador de un usuario de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Establecimiento del servidor de Active Directory

Establece un servidor de Active Directory específico que se usará para todas las acciones adicionales de Active Directory.

Está conectado a Active Directory

Informa si IA-Connect está conectado a Active Directory. De forma predeterminada, IA-Connect se conecta automáticamente al dominio del equipo en el que se ejecuta el agente de IA-Connect es miembro, con la cuenta de la que se ejecuta el agente de IA-Connect como. Use la acción "Conectar a Active Directory con credenciales" para conectarse mediante credenciales alternativas o a un dominio alternativo.

Está conectado a Azure AD

Informa si IA-Connect está conectado a Azure Active Directory (también conocido como Id. de Microsoft Entra, Azure AD o AAD). Use una de las acciones "Conectar a Azure AD" para conectarse.

Está conectado a Microsoft Exchange

Informa si IA-Connect está conectado a un servidor de Microsoft Exchange. Use la acción "Conectar a Microsoft Exchange" para conectarse.

Está conectado a Office 365

Informa si IA-Connect está conectado a Office 365 con los módulos de PowerShell de Office 365. Use la acción "Conectar a Office 365" para conectarse.

Habilitación de la cuenta de usuario de Active Directory

Habilita una cuenta de usuario de Active Directory. Si la cuenta no está deshabilitada, este comando no hace nada.

Habilitación del usuario de Azure AD

Habilita un usuario de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Incorporación de un usuario de Azure AD a varios grupos

Agrega un usuario de Azure Active Directory a varios grupos de Azure Active Directory existentes en los que los grupos se especifican mediante el identificador de objeto o el nombre para mostrar. IA-Connect agrega el usuario a tantos grupos como sea posible e informa sobre el resultado. Esta acción no puede modificar listas de distribución ni grupos de seguridad habilitados para correo: use las acciones de Office 365 Exchange Online en su lugar. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Modificación de la carpeta principal del usuario de Active Directory

Establece la carpeta principal, directorio o unidad para un usuario de Active Directory.

Modificación de la propiedad booleana de usuario de Active Directory

Modifique una propiedad booleana individual (true/false) de un usuario de Active Directory. Esto le permite modificar una configuración de usuario muy específica, incluidas las propiedades personalizadas.

Modificación de las propiedades de la cadena de usuario de Active Directory

Modifique las propiedades de cadena individuales de un usuario de Active Directory. Esto le permite modificar la configuración de usuario muy específica, incluidas las propiedades personalizadas. También puede establecer propiedades de usuario individuales en blanco.

Modificación de las propiedades de usuario comunes de Active Directory

Modifique las propiedades comunes de un usuario de Active Directory. Solo puede asignar valores a propiedades, no establecerlos en blanco. Para establecer las propiedades en blanco, use la acción "Modificar propiedades de cadena de usuario de Active Directory".

Modificación de las propiedades de usuario de Azure AD

Modifique las propiedades comunes de un usuario de Azure Active Directory. Solo puede asignar valores a propiedades, no establecerlos en blanco, ya que un valor en blanco se interpreta como una intención de dejar el valor sin cambios. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Modificar direcciones de correo electrónico de buzón de Microsoft Exchange

Modifique las direcciones de correo electrónico en un buzón de Microsoft Exchange. Puede agregar, quitar y reemplazar las direcciones de correo electrónico principal y de alias.

Modificar direcciones de correo electrónico de buzón de Microsoft Exchange Online

Modifique las direcciones de correo electrónico en un buzón existente de Microsoft Exchange Online u Office 365 (remoto). Puede agregar, quitar y reemplazar las direcciones de correo electrónico principal y de alias. La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida.

Mover el usuario de Active Directory a la unidad organizativa

Mueve un usuario de Active Directory a una unidad organizativa (OU) de Active Directory existente.

Obtención de asignaciones de roles de administrador de usuarios de Azure AD

Devuelve una lista de roles de administrador de Azure Active Directory a los que se asigna el usuario especificado. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Obtención de grupos de Azure AD

Devuelve los detalles de los grupos de Azure Active Directory (también conocidos como Identificador de Entra de Microsoft, Azure AD o AAD). Puede buscar por identificador de objeto o mediante un filtro. Una búsqueda de id. de objeto debe devolver 0 o 1 resultados. Una búsqueda de filtro podría devolver 0 o más resultados. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Obtención de la pertenencia a grupos de usuarios de Active Directory

Devuelve una lista de grupos de Active Directory de los que es miembro el usuario especificado, menos el grupo principal (normalmente "Usuarios de dominio") ya que técnicamente no es miembro. Esta acción solo funciona con cuentas de usuario, no puede usar esta acción para consultar la pertenencia a grupos de grupos o equipos.

Obtención de la pertenencia a grupos de usuarios de Azure AD

Devuelve una lista de grupos de Azure Active Directory de los que es miembro el usuario especificado. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Obtención de la unidad organizativa de Active Directory del DN del usuario

Función de utilidad. Dado el nombre distintivo (DN) de un usuario de Active Directory, devuelve la unidad organizativa (OU) en la que se encuentra el usuario.

Obtención de licencias de usuario de Azure AD

Recupera una lista de licencias (SKU) asignadas a un usuario de Azure AD. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Obtención de miembros del grupo de Azure AD

Devuelve una lista de miembros de un grupo de Azure Active Directory. Los miembros pueden ser usuarios, grupos, dispositivos o entidades de servicio o aplicaciones empresariales. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Obtención de planes de servicio de licencia de usuario de Azure AD

Recupera una lista de planes de licencias asignados a una licencia de usuario (SKU) de Azure AD especificada. Por ejemplo: si el usuario tiene asignada la licencia de FLOW_FREE, esto le permitirá ver qué planes de servicio han aprovisionado en esa licencia. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Obtención de SKU de licencia de Azure AD

Devuelve una lista de unidades de almacenamiento de existencias (SKU) de licencia de Azure Active Directory a las que se suscribe la instancia de Azure AD conectada. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Obtención de un usuario de Active Directory

Devuelve las propiedades de un usuario de Active Directory especificado. Puede buscar por identidad (para buscar un solo usuario) o mediante un filtro (para localizar uno o varios usuarios).

Obtención de usuarios de Azure AD

Devuelve los detalles de los usuarios de Azure Active Directory (también conocidos como Id. de Microsoft Entra, Azure AD o AAD). Puede buscar por identificador de objeto o mediante un filtro. Una búsqueda de id. de objeto debe devolver 0 o 1 resultados. Una búsqueda de filtro podría devolver 0 o más resultados. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Obtención del FQDN de dominio de Active Directory desde DN

Función de utilidad. Dado el nombre distintivo (DN) de un usuario de Active Directory, devuelve el dominio de Active Directory que contiene el usuario.

Obtener buzón de Office 365

Devuelve las propiedades del buzón especificado de Microsoft Exchange Online u Office 365.

Obtener el siguiente nombre de cuenta disponible

En los detalles relacionados con el formato de nomenclatura para los nombres de cuentas de Active Directory y Exchange, se proporcionan los detalles del siguiente nombre de cuenta de reserva disponible. Se usa para determinar qué cuenta de Active Directory y Exchange se va a crear para un usuario determinado. Esta acción no crea ninguna cuenta, proporciona información sobre la disponibilidad del nombre.

Obtener grupo de Active Directory

Devuelve las propiedades de un grupo o grupos de Active Directory especificados. Puede buscar por identidad (para buscar un único grupo) o mediante un filtro (para buscar uno o varios grupos).

Obtener grupo de distribución de Office 365

Devuelve las propiedades de los grupos de distribución de Microsoft Exchange Online u Office 365 especificados o grupos de seguridad habilitados para correo. Puede buscar por Identidad o mediante un filtro. Una búsqueda de identidad debe devolver 0 o 1 resultados. Una búsqueda de filtro podría devolver 0 o más resultados.

Obtener información de dominio de Active Directory

Recupera información sobre un dominio de Active Directory.

Obtener miembros del grupo de Active Directory

Devuelve una lista de miembros de un grupo de Active Directory.

Obtener miembros del grupo de distribución de Microsoft Exchange

Recupere una lista de los miembros de un grupo de distribución de Microsoft Exchange.

Obtener miembros del grupo de distribución de Office 365

Recupere una lista de los miembros de un grupo de distribución de Microsoft Exchange Online u Office 365 o un grupo de seguridad habilitado para correo.

Quitar el buzón de Office 365 de todos los grupos de distribución

Quite un buzón de todos los grupos de distribución de Microsoft Exchange Online u Office 365 o grupos de seguridad habilitados para correo de los que es miembro.

Quitar el permiso de buzón de Office 365 del usuario

Quite los permisos de buzón de Correo de Microsoft Exchange Online u Office 365 de un usuario, usuario o grupo de seguridad especificados.

Quitar grupo de Active Directory

Quita un grupo de Active Directory. Si hay objetos (por ejemplo, usuarios, grupos o equipos) en el grupo, esos objetos se quitarán como parte de la eliminación del grupo.

Quitar grupo de distribución de Microsoft Exchange

Quitar un grupo de distribución de Microsoft Exchange.

Quitar grupo de distribución de Office 365

Quite un grupo de seguridad habilitado para correo electrónico o un grupo de distribución de Microsoft Exchange Online u Office 365.

Quitar miembro de Microsoft Exchange del grupo de distribución

Quite un miembro (por ejemplo, un usuario) de un grupo de distribución de Exchange. Si el miembro no está en el grupo, no se realiza ninguna acción.

Quitar miembro de Office 365 del grupo de distribución

Quite un miembro de un grupo de distribución de Microsoft Exchange Online u Office 365 o un grupo de seguridad habilitado para correo.

Quitar miembro del grupo de Active Directory

Quita un miembro de Active Directory (usuario, grupo o equipo) de un grupo de Active Directory.

Quitar varios miembros del grupo de Active Directory

Quite uno o varios objetos de Active Directory (normalmente usuarios, grupos o equipos) de un grupo de Active Directory existente. IA-Connect quita tantos miembros del grupo como sea posible e informa sobre el resultado. Si el grupo y el miembro del grupo están en dominios diferentes, deberá especificar el nombre distintivo (DN) para los miembros y el grupo. Si algunos de los objetos no son miembros del grupo, se cuenta como un éxito.

Realizar Active Directory DirSync

Realiza una sincronización entre Active Directory (local) y Azure Active Directory (nube). Este comando se debe emitir al servidor con el rol "DirSync" (es decir, el equipo que realiza la sincronización).

Recuperación de la pertenencia a grupos de distribución de buzones de Microsoft Exchange

Recupere los grupos de distribución a los que pertenece un buzón.

Recuperar detalles del grupo de distribución de Microsoft Exchange

Recupere los detalles de un grupo de distribución de Microsoft Exchange. Puede buscar por Identidad o mediante un filtro. Una búsqueda de identidad debe devolver 0 o 1 resultados. Una búsqueda de filtro podría devolver 0 o más resultados.

Recuperar direcciones de correo electrónico de buzón de Microsoft Exchange

Recupera una lista de todas las direcciones de correo electrónico asignadas a un buzón de Microsoft Exchange. Esto incluye la dirección SMTP principal, las direcciones de correo electrónico proxy, las direcciones X.400 y las direcciones EUM (mensajería unificada de Exchange).

Recuperar direcciones de correo electrónico de buzón de Microsoft Exchange Online

Recupera una lista de todas las direcciones de correo electrónico asignadas a un buzón existente de Microsoft Exchange Online u Office 365 (remoto). Esto incluye la dirección SMTP principal, las direcciones de correo electrónico proxy, las direcciones X.400 y las direcciones EUM (mensajería unificada de Exchange). La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida.

Recuperar la pertenencia a grupos de distribución de buzones de Office 365

Recuperar de qué grupos de distribución o grupos de seguridad habilitados para correo es miembro un buzón de Office 365 o Exchange Online.

Recuperar los detalles del buzón de Microsoft Exchange

Devuelve las propiedades del buzón de Exchange especificado. Puede buscar por Identidad o mediante un filtro. Una búsqueda de identidad debe devolver 0 o 1 resultados. Una búsqueda de filtro podría devolver 0 o más resultados.

Recuperar los detalles del buzón de Microsoft Exchange Online

Devuelve las propiedades del buzón especificado de Microsoft Exchange Online u Office 365 (remoto). La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida. Puede buscar por Identidad o mediante un filtro. Una búsqueda de identidad debe devolver 0 o 1 resultados. Una búsqueda de filtro podría devolver 0 o más resultados.

Restablecer las propiedades de un buzón de Microsoft Exchange

Establezca las propiedades especificadas de un buzón de Microsoft Exchange existente en blanco.

Restablecer las propiedades de un buzón de Microsoft Exchange Online

Establezca las propiedades especificadas de un buzón existente de Microsoft Exchange Online u Office 365 (remoto) en blanco. La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida.

Restablecimiento de la contraseña de usuario de Active Directory

Restablece la contraseña de un usuario de Active Directory con una nueva contraseña y, opcionalmente, establece las propiedades de contraseña.

Restablecimiento de la contraseña de usuario de Azure AD

Restablece la contraseña de un usuario de Azure Active Directory con una nueva contraseña. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Restablecimiento de las propiedades de usuario de Azure AD

Restablezca las propiedades comunes de un usuario de Azure Active Directory a un valor en blanco. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Usuario en el grupo de usuarios de Azure AD

Devuelve si un usuario es miembro de un grupo de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

¿Está instalado el módulo de PowerShell de Azure AD?

Informa si los módulos de PowerShell necesarios para Azure Active Directory (también conocido como Id. de Microsoft Entra, Azure AD o AAD) se instalan en el equipo donde se ejecuta el agente de IA-Connect. Esta acción comprueba los módulos de PowerShell de usuarios de Azure AD v2 y Microsoft Graph.

¿Existe el buzón de Microsoft Exchange Online?

Devuelve si existe el buzón especificado de Microsoft Exchange Online u Office 365 (remoto). La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida.

¿Existe el buzón de Microsoft Exchange?

Devuelve si existe el buzón de Exchange especificado.

¿Existe un grupo de Active Directory?

Devuelve si existe un grupo de Active Directory especificado.

¿Tiene un buzón de Office 365 un archivo?

Informa de si un buzón existente en Microsoft Exchange Online tiene un buzón de archivo. Si el buzón no existe, se producirá una excepción.

Adición de un objeto de Active Directory a varios grupos

Agregue un objeto de Active Directory (normalmente un usuario, grupo o equipo) a varios grupos de Active Directory existentes. IA-Connect agrega el objeto a tantos grupos como sea posible e informa sobre el resultado. Si el objeto ya es miembro de uno o varios de los grupos especificados, se cuenta como correcto.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de objeto
UserIdentity True string

Objeto (normalmente un usuario, grupo o equipo) que se va a agregar a uno o varios grupos. Puede especificar un usuario o grupo por Nombre distintivo (por ejemplo, CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID o SAMAccountName/pre-2K (por ejemplo, "User1"). Puede especificar un equipo por Nombre distintivo o nombre de equipo (antes de 2K) seguido de $ (por ejemplo, VM01$).

Grupos de AD que se van a agregar
GroupNamesJSON string

Lista de los grupos de AD a los que se va a agregar el objeto en formato JSON o CSV. Por ejemplo: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (formato de tabla JSON), ["Group 1", "Group 2"] (formato de matriz JSON) o Group 1,Group 2 (formato CSV). Puede especificar un grupo por Nombre distintivo (por ejemplo, CN=Group1,OU=Mis grupos,DC=mydomain,DC=local), GUID, SID o SAMAccountName/nombre de pre-2K (por ejemplo, "Group1"). No puede usar el nombre para mostrar o el nombre del grupo (aunque el nombre del grupo suele ser el mismo que el nombre anterior a 2K que se puede usar).

Excepción si algún grupo no puede agregar
ExceptionIfAnyGroupsFailToAdd boolean

Si se establece en true: se generará una excepción (error) si un único grupo no puede agregar (es decir, 100% correcto es un requisito). Si no se produce ninguna excepción, esta acción notificará cuántos grupos se agregaron correctamente y cuántos no se pudieron agregar.

Excepción si no se pueden agregar todos los grupos
ExceptionIfAllGroupsFailToAdd boolean

Si se establece en true: se generará una excepción (error) solo si todos los grupos no pueden agregar (es decir, sin éxitos y algunos errores). Si no se produce ninguna excepción, esta acción notificará cuántos grupos se agregaron correctamente y cuántos no se pudieron agregar.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Número máximo de grupos por llamada
MaxGroupsPerCall integer

Si se especifica un gran número de grupos de AD para agregar, esto puede provocar un tiempo de espera. Al establecer el valor "Grupos máximos por llamada" en 1 o superior, el IA-Connect Orchestrator dividirá esta acción en varias llamadas al director de IA-Connect y al agente con el número máximo especificado de grupos por llamada. Primero disponible en IA-Connect 9.3. Por ejemplo: si establece un valor de 5 y 14 grupos se solicitan para su adición, Orchestrator dividirá esto en solicitudes de 5, 5, 4.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Grupos de AD agregados correctamente
ADGroupsAddedSuccessfully integer

Número de grupos de AD al que se agregó correctamente el objeto.

Los grupos de AD no se pudieron agregar
ADGroupsFailedToAdd integer

Número de grupos de AD a los que el objeto no se pudo agregar.

Mensaje de error Agregar grupos de AD
AddADGroupsMasterErrorMessage string

Si el objeto no se pudo agregar a algunos de los grupos de AD y no se produjo ninguna excepción, este mensaje de error proporciona detalles del problema.

Adición de un usuario de Active Directory

Crea una nueva cuenta de usuario de Active Directory.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre
Name True string

Nombre del usuario de Active Directory. Aparece en la columna "Nombre" de usuarios y equipos de AD y en la parte superior de la pestaña Usuario "General" (en el título). Este no es el nombre de inicio de sesión del usuario.

Nombre principal del usuario
UserPrincipalName string

Nombre de inicio de sesión de usuario en Active Directory. Por lo general, debe estar en el formato "name@domainFQDN" (por ejemplo, "TestUser1@domain.local"). El usuario puede iniciar sesión con este formato: name@domainFQDN.

Nombre de la cuenta SAM
SamAccountName string

Nombre de inicio de sesión de usuario (anterior a Windows 2000) en Active Directory. Esto tiene el formato "name" (por ejemplo, "TestUser1"). El usuario puede iniciar sesión con este formato: DOMAIN\name.

Nombre
GivenName string

Nombre de usuario opcional.

Apellido
SurName string

Apellidos de usuario opcional.

Ruta
Path string

Unidad organizativa (OU) en la que almacenar el usuario en formato de nombre distintivo (por ejemplo, OU=Target OU,OU=London,DC=mydomain,DC=local), formato GUID o como ruta de acceso (por ejemplo, MyUsers\London). Si se deja en blanco, el usuario se creará en la unidad organizativa "Usuarios".

Description
Description string

Descripción del usuario opcional.

Nombre para mostrar
DisplayName string

Nombre para mostrar del usuario opcional.

Contraseña de la cuenta
AccountPassword password

Contraseña de usuario. Debe especificarse y cumplir las reglas de complejidad de contraseñas de Active Directory. Si se trata de una contraseña "Almacenada", escriba en el formato {IAConnectPassword:StoredPasswordIdentifier} y establezca la entrada "contraseña almacenada" en true. Si se trata de una credencial genérica de Orchestrator, escriba en el formato {OrchestratorCredential:FriendlyName} y establezca la entrada "contraseña almacenada" en true.

La contraseña de la cuenta se almacena
AccountPasswordIsStoredPassword boolean

Establézcalo en true si la contraseña es un identificador de contraseña almacenado IA-Connect (por ejemplo, generado por la acción "Generar contraseña") o una credencial genérica de IA-Connect Orchestrator (por ejemplo, si usa IA-Connect con un flujo de PA).

Enabled
Enabled boolean

Establézcalo en true si desea habilitar la cuenta inmediatamente después de la creación. Establézcalo en false para que la cuenta se inicie deshabilitada. Esta opción tiene como valor predeterminado true.

El usuario debe cambiar la contraseña en el siguiente inicio de sesión
ChangePasswordAtLogon boolean

Establézcalo en true si desea obligar al usuario a cambiar su contraseña cuando inicie sesión (es decir, la nueva contraseña que se establece aquí es una contraseña única para que el usuario inicie sesión). Establézcalo en false si se trata de la contraseña que usará el usuario hasta que la cambie manualmente. No se puede establecer esta opción en true al mismo tiempo que establecer "El usuario no puede cambiar la contraseña" o "La contraseña nunca expira" en true.

El usuario no puede cambiar la contraseña
CannotChangePassword boolean

Establézcalo en true para impedir que el usuario pueda cambiar su contraseña. Establézcalo en false si el usuario puede cambiar la contraseña. No puede establecer esta opción en true al mismo tiempo que establecer "El usuario debe cambiar la contraseña en el siguiente inicio de sesión" a true.

La contraseña nunca expira
PasswordNeverExpires boolean

Establézcalo en true si la contraseña nunca expira (es decir, el usuario nunca se le pedirá que cambie la contraseña). Establézcalo en false si la contraseña puede expirar como establecida en la directiva de dominio de Active Directory. No puede establecer esta opción en true al mismo tiempo que establecer "El usuario debe cambiar la contraseña en el siguiente inicio de sesión" a true.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de salida de PowerShell
PowerShellJSONOutput string

Salida del script de PowerShell, con formato JSON.

Nombre distintivo del usuario creado
CreatedUserDistinguishedName string

Nombre distintivo (DN) de Active Directory de la cuenta de usuario creada.

Nombre de cuenta SAM de usuario creado
CreatedUserSAMAccountName string

Nombre de cuenta sam de Active Directory de la cuenta de usuario creada.

Nombre principal de usuario creado
CreatedUserPrincipalName string

Nombre principal de usuario (UPN) de Active Directory de la cuenta de usuario creada.

Adición de un usuario de Azure AD

Crea una nueva cuenta de usuario de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre principal del usuario
UserPrincipalName True string

Nombre de inicio de sesión de usuario en Azure Active Directory. Por lo general, debe estar en el formato "name@domainFQDN" (por ejemplo, "TestUser1@mydomain.onmicrosoft.com").

Cuenta habilitada
AccountEnabled True boolean

Establézcalo en true si desea habilitar la cuenta inmediatamente después de la creación. Establézcalo en false para que la cuenta se inicie deshabilitada. Esta opción tiene como valor predeterminado true.

Contraseña de la cuenta
AccountPassword True password

Contraseña de usuario. Debe especificarse y cumplir las reglas de complejidad de contraseñas de Azure Active Directory. Si se trata de una contraseña "Almacenada", escriba en el formato {IAConnectPassword:StoredPasswordIdentifier} y establezca la entrada "contraseña almacenada" en true. Si se trata de una credencial genérica de Orchestrator, escriba en el formato {OrchestratorCredential:FriendlyName} y establezca la entrada "contraseña almacenada" en true.

La contraseña de la cuenta se almacena
AccountPasswordIsStoredPassword boolean

Establézcalo en true si la contraseña es un identificador de contraseña almacenado IA-Connect (por ejemplo, generado por la acción "Generar contraseña") o una credencial genérica de IA-Connect Orchestrator (por ejemplo, si usa IA-Connect con un flujo de PA).

Nombre
FirstName string

Nombre del usuario.

Apellido
LastName string

Nombre de familia / apellido / apellido del usuario.

Nombre para mostrar
DisplayName True string

Nombre para mostrar completo para este usuario.

City
City string

Nombre de la ciudad en la que reside el usuario o donde se encuentra su oficina.

Nombre de la compañía
CompanyName string

Nombre de la empresa para la que trabaja el usuario.

País o región
Country string

País o región en el que reside el usuario o donde se encuentra su oficina.

Departamento
Department string

Nombre del departamento para el que trabaja el usuario dentro de la Compañía.

Número de fax
FaxNumber string

Número de teléfono de fax (facsimile) del usuario.

Puesto
JobTitle string

Puesto del usuario.

Alias de correo
MailNickName True string

Alias de correo del usuario.

Número de teléfono móvil
MobilePhone string

Número de teléfono móvil del usuario.

Oficina
Office string

Ubicación de la oficina donde trabaja el usuario.

Número de teléfono
PhoneNumber string

Número de teléfono del usuario.

Código postal
PostalCode string

El código postal o postal donde reside el usuario, o la oficina en la que trabaja.

Lenguaje preferido
PreferredLanguage string

Idioma preferido del usuario. Normalmente, esto se escribe como un código de dos letras de idioma (ISO 639-1), seguido de un guión, seguido de un código de país de dos letras mayúsculas (ISO 3166). Por ejemplo: en-US, en-GB, fr-FR, ja-JP.

Estado o provincia
State string

El estado, provincia o condado en el que reside el usuario o donde se encuentra su oficina.

Dirección postal
StreetAddress string

La dirección postal donde reside el usuario o su dirección postal de oficina.

Ubicación de uso
UsageLocation string

Código de país de dos letras (ISO 3166). Necesario para los usuarios a los que se asignarán licencias debido a un requisito legal. Por ejemplo: EE. UU. (Estados Unidos), JP (Japón), GB (Reino Unido), FR (Francia), IN (India). Consulte https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes.

Grupo de edad
AgeGroup string

Grupo de edad del usuario, con fines de control parental. El valor predeterminado no es ninguno o no especificado que (desde la perspectiva de los controles) es el mismo que para adultos.

Consentimiento proporcionado para el menor
ConsentProvidedForMinor string

Si el "Grupo de edad" es "Menor", este campo le permite especificar si el consentimiento se ha proporcionado para el menor, con fines de control parental.

Id. de empleado
EmployeeId string

Identificador de empleado opcional. Puede usarlo para distinguir de forma única entre cada usuario de su organización.

Forzar el cambio de contraseña en el siguiente inicio de sesión
ForceChangePasswordNextLogin boolean

Establézcalo en true si desea forzar al usuario a cambiar su contraseña cuando inicie sesión (es decir, la nueva contraseña que se establece aquí es una contraseña única para permitir que el usuario inicie sesión). Establézcalo en false si se trata de la contraseña que usará el usuario hasta que la cambie manualmente.

Aplicación de la directiva de cambio de contraseña
EnforceChangePasswordPolicy boolean

Establézcalo en true para aplicar la directiva de cambio de contraseña de Azure Active Directory que (dependiendo de su entorno) puede definir la frecuencia con la que el usuario debe cambiar su contraseña, las opciones de recuperación de contraseñas y la comprobación de seguridad adicional. Esto puede hacer que se solicite al usuario información adicional.

La contraseña nunca expira
PasswordNeverExpires boolean

Establézcalo en true si la contraseña nunca expira (es decir, el usuario nunca se le pedirá que cambie la contraseña). Establézcalo en false si la contraseña puede expirar como se establece en la directiva de contraseñas de Azure Active Directory.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON del resultado de la acción
PowerShellJSONOutput string

Salida del script de PowerShell, con formato JSON.

Nombre principal de usuario creado
CreatedUserPrincipalName string

El nombre principal de usuario (UPN) de Azure Active Directory de la cuenta de usuario creada.

Identificador de objeto de usuario creado
CreatedUserObjectId string

Identificador de objeto de usuario de Azure Active Directory de la cuenta de usuario creada.

Adición de un usuario de Azure AD al grupo

Agregue un usuario de Azure Active Directory a un grupo de Seguridad de Azure Active Directory o M365 existente. Esta acción no puede modificar listas de distribución ni grupos de seguridad habilitados para correo: use las acciones de Office 365 Exchange Online en su lugar. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
UserObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Id. de objeto de grupo o nombre para mostrar
GroupObjectId True string

Identificador o nombre para mostrar de un grupo de Azure Active Directory. Puede especificar un grupo por Nombre para mostrar (por ejemplo, "Usuarios financieros") o ObjectId (por ejemplo, UUID/valor GUID).

Comprobar primero las pertenencias a grupos de usuarios
CheckUserGroupMembershipsFirst boolean

Si se establece en true, IA-Connect comprobará las pertenencias a grupos del usuario antes de intentar agregarlas al grupo. Si el usuario ya es miembro del grupo, IA-Connect simplemente notificará el éxito sin tener que hacer nada. Si se establece en false, IA-Connect agregará inmediatamente el usuario al grupo sin comprobarlo, lo que producirá un error si el usuario ya está en el grupo.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
AzureADv2AddUserToGroupResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Adición de una unidad organizativa de Active Directory

Crea una nueva unidad organizativa (OU) de Active Directory.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre
Name True string

Nombre de la unidad organizativa de Active Directory. Esto aparece en la estructura del árbol de unidades organizativas en usuarios y equipos de AD y en la parte superior de la pestaña "General" de las propiedades de la unidad organizativa (en el título).

Ruta
Path string

Unidad organizativa (OU) en la que se va a almacenar la nueva unidad organizativa en formato de nombre distintivo (por ejemplo, OU=Unidad organizativa principal,OU=Londres,DC=mydomain,DC=local), formato GUID o como ruta de acceso (por ejemplo, London\Parent OU). Si se deja en blanco, la unidad organizativa se creará en la raíz del árbol.

Description
Description string

Descripción opcional de la unidad organizativa.

Nombre para mostrar
DisplayName string

Nombre para mostrar de la unidad organizativa opcional. A diferencia de las cuentas de usuario, el nombre para mostrar de una unidad organizativa no se muestra en los usuarios y equipos de AD.

Administrado por
ManagedBy string

Especifica el usuario o grupo que administra esta unidad organizativa. Puede especificar esta entrada en formato de nombre distintivo (por ejemplo, CN=MrBig,OU=London,DC=mydomain,DC=local), formato GUID, SID o SAMAccountName (por ejemplo, "MrBig").

Protección contra la eliminación accidental
ProtectedFromAccidentalDeletion boolean

Establezca en true (valor predeterminado) para proteger esta unidad organizativa frente a la eliminación accidental. Establézcalo en false para dejar la unidad organizativa desprotegida de la eliminación accidental.

Dirección postal
StreetAddress string

La propiedad "Street" de la unidad organizativa (en la pestaña "General" de los usuarios y equipos de AD).

City
City string

La propiedad 'City' de la unidad organizativa (en la pestaña "General" de las propiedades de la unidad organizativa en usuarios y equipos de AD).

Estado
State string

Propiedad "Estado o provincia" de la unidad organizativa (en la pestaña "General" de usuarios y equipos de AD.

Código postal
PostalCode string

La propiedad "Código postal/postal" de la unidad organizativa (en la pestaña "General" de los usuarios y equipos de AD.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de salida de PowerShell
PowerShellJSONOutput string

Salida del script de PowerShell, con formato JSON.

Nombre distintivo de unidad organizativa creada
CreatedOUDistinguishedName string

Nombre distintivo de Active Directory (DN) de la unidad organizativa creada.

Adición de varios miembros del grupo de Active Directory

Agregue uno o varios objetos de Active Directory (normalmente usuarios, grupos o equipos) a un grupo de Active Directory existente. IA-Connect agrega tantos miembros al grupo como sea posible e informa sobre el resultado. Si el grupo y el miembro del grupo están en dominios diferentes, deberá especificar el nombre distintivo (DN) para los miembros y el grupo. Si algunos de los objetos ya son miembros del grupo, se cuenta como correcto.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de grupo
GroupIdentity string

Identidad del grupo de Active Directory. Puede especificar un grupo por Nombre distintivo (por ejemplo, CN=Group1,OU=Mis grupos,DC=mydomain,DC=local), GUID, SID o SAMAccountName/nombre de pre-2K (por ejemplo, "Group1"). No puede usar el nombre para mostrar o el nombre del grupo (aunque el nombre del grupo suele ser el mismo que el nombre anterior a 2K que se puede usar).

Miembros del grupo
GroupMembersJSON string

Lista de los miembros (normalmente usuarios, grupos o equipos) que se van a agregar al grupo de AD, en formato JSON o CSV. Por ejemplo: [{"MemberName": "Usuario 1"}, {"MemberName": "Usuario 2"}] (formato de tabla JSON), ["Usuario 1", "Usuario 2"] (formato de matriz JSON) o Usuario 1,Usuario 2 (formato CSV). Puede especificar un usuario o grupo por Nombre distintivo (por ejemplo, CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID o SAMAccountName/pre-2K (por ejemplo, "User1"). Puede especificar un equipo por Nombre distintivo o nombre de equipo (antes de 2K) seguido de $ (por ejemplo, VM01$).

Excepción si algún miembro no puede agregar
ExceptionIfAnyMembersFailToAdd boolean

Si se establece en true: se generará una excepción (error) si algún miembro único no puede agregar (es decir, 100% correcto es un requisito). Si no se produce ninguna excepción, esta acción notificará cuántos miembros se agregaron correctamente y cuántos no se pudieron agregar.

Excepción si no se pueden agregar todos los miembros
ExceptionIfAllMembersFailToAdd boolean

Si se establece en true: se generará una excepción (error) solo si todos los miembros no pueden agregar (es decir, sin éxitos y algunos errores). Si no se produce ninguna excepción, esta acción notificará cuántos miembros se agregaron correctamente y cuántos no se pudieron agregar.

Agregar todos los miembros en una sola llamada
AddAllMembersInASingleCall boolean

Si se establece en true, todos los miembros se agregarán al grupo en una sola acción. Esto será más rápido, pero si no existe un solo miembro o no se puede agregar, no se agregará ningún miembro y se generará una excepción, independientemente de las opciones de entrada "Excepción". Si se establece en false (el valor predeterminado), cada miembro se agregará individualmente y el agente de IA-Connect contará cuántos agregados correctamente y cuántos no se pudieron agregar. Si agrega miembros a grupos entre dominios, se recomienda establecer esta entrada en false.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Los miembros del grupo de AD se agregaron correctamente
ADGroupMembersAddedSuccessfully integer

Número de miembros agregados correctamente al grupo de AD.

No se pudieron agregar miembros del grupo de AD
ADGroupMembersFailedToAdd integer

Número de miembros que no se pudieron agregar al grupo de AD.

Mensaje de error Agregar miembros del grupo de AD
AddADGroupMembersMasterErrorMessage string

Si algunos miembros no se pudieron agregar al grupo de AD y no se generó ninguna excepción, este mensaje de error proporciona detalles del problema.

Agregar grupo de Active Directory

Crea un nuevo grupo de Active Directory.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre
Name True string

Nombre del grupo de Active Directory. Aparece en la columna "Nombre" de usuarios y equipos de AD y en la parte superior de la pestaña Grupo "General" (en el título).

Nombre de la cuenta SAM
SamAccountName string

Nombre del grupo (anterior a Windows 2000) en Active Directory. Se trata del formato "name" (por ejemplo, "TestGroup1").

Ruta
Path string

Unidad organizativa (OU) en la que almacenar el grupo en formato de nombre distintivo (por ejemplo, OU=Target OU,OU=London,DC=mydomain,DC=local), formato GUID o como ruta de acceso (por ejemplo, MyGroups\London). Si se deja en blanco, el grupo se creará en la unidad organizativa "Usuarios".

Description
Description string

Descripción del grupo opcional.

Notas
Notes string

Notas de grupo opcionales.

Nombre para mostrar
DisplayName string

Nombre para mostrar del grupo opcional. A diferencia de las cuentas de usuario, un nombre para mostrar de grupo no se muestra en usuarios y equipos de AD.

Categoría de grupo
GroupCategory True string

Tipo de grupo que se va a crear. Normalmente, un grupo de seguridad se usa para administrar el acceso de usuario y equipo a los recursos de TI. Normalmente, un grupo de distribución se usa para crear un correo electrónico de grupo, lo que permite enviar un correo electrónico a un grupo de usuarios.

Ámbito de grupo
GroupScope True string

Ámbito del grupo que se va a crear. Hay un conjunto complejo de reglas que describen dónde se puede hacer referencia a un grupo y qué se puede colocar en un grupo, en función del ámbito de ese grupo. No siempre puede convertir a otro ámbito de grupo más adelante, por lo que debe elegir el ámbito correcto al crearse.

Página principal
HomePage string

Página principal del grupo opcional.

Administrado por
ManagedBy string

Especifica el usuario o grupo que administra este grupo. Puede especificar esta entrada en formato de nombre distintivo (por ejemplo, CN=MrBig,OU=London,DC=mydomain,DC=local), formato GUID, SID o SAMAccountName (por ejemplo, "MrBig").

Protección contra la eliminación accidental
ProtectedFromAccidentalDeletion boolean

Establézcalo en true para proteger este grupo frente a la eliminación accidental. Establézcalo en false para dejar el grupo en el valor predeterminado de no estar protegido frente a la eliminación accidental.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de salida de PowerShell
PowerShellJSONOutput string

Salida del script de PowerShell, con formato JSON.

Nombre distintivo del grupo creado
CreatedGroupDistinguishedName string

Nombre distintivo de Active Directory (DN) del grupo creado.

Nombre de cuenta sam del grupo creado
CreatedGroupSAMAccountName string

Nombre de la cuenta SAM de Active Directory del grupo creado.

Agregar miembro de Microsoft Exchange al grupo de distribución

Agregue un miembro (por ejemplo, un usuario) a un grupo de distribución de Exchange. Si el miembro ya está en el grupo, no se realiza ninguna acción.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del grupo de distribución
Identity True string

Identidad del grupo de distribución al que se va a agregar. Puede especificar un grupo de distribución por Nombre, Alias, Nombre distintivo (por ejemplo, CN=MyGroup,OU=Mis grupos,DC=mydomain,DC=local), Dirección de correo electrónico o GUID.

Miembro que se va a agregar
Member True string

Identidad del miembro que se va a agregar al grupo de distribución. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ExchangeAddDistributionGroupMemberResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Agregar miembro de Office 365 al grupo de distribución

Agregue un miembro a un grupo de distribución de Microsoft Exchange Online u Office 365 o a un grupo de seguridad habilitado para correo.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del grupo de distribución
Identity True string

Identidad del grupo de distribución o del grupo de seguridad habilitado para correo que se va a agregar. Puede especificar un grupo de distribución por Nombre, Alias, Nombre distintivo (por ejemplo, CN=MyGroup,OU=Mis grupos,DC=mydomain,DC=local), Dirección de correo electrónico o GUID.

Miembro que se va a agregar
Member True string

Identidad del miembro que se va a agregar al grupo de distribución o al grupo de seguridad habilitado para correo. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Omitir la comprobación del administrador de grupos de seguridad
BypassSecurityGroupManagerCheck boolean

Si la cuenta de automatización del agente de IA-Connect no es propietario del grupo de distribución o del grupo de seguridad habilitado para correo, no podrá quitar el grupo. Si establece esta opción en true, se omitirá la comprobación de propietario, pero requiere que la cuenta de automatización esté en el grupo de roles "Administración de la organización" de Exchange o que tenga asignado el rol "Administración de roles", es un único rol para concederle permisos para modificar cualquier grupo de Office 355 Exchange Online en lugar de ser propietario de todos los grupos que necesita modificar.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
O365AddDistributionGroupMemberResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Agregar miembro del grupo de Active Directory

Agregue un objeto de Active Directory (normalmente un usuario, grupo o equipo) a un grupo de Active Directory existente. Si el grupo y el miembro del grupo están en dominios diferentes, deberá especificar el nombre distintivo (DN) para los miembros y el grupo.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de grupo
GroupIdentity string

Identidad del grupo de Active Directory. Puede especificar un grupo por Nombre distintivo (por ejemplo, CN=Group1,OU=Mis grupos,DC=mydomain,DC=local), GUID, SID o SAMAccountName/nombre de pre-2K (por ejemplo, "Group1"). No puede usar el nombre para mostrar o el nombre del grupo (aunque el nombre del grupo suele ser el mismo que el nombre anterior a 2K que se puede usar).

Nombre del grupo
GroupName string

Como alternativa a la búsqueda por identidad, proporcione el nombre anterior a 2K (SAMAccountName) del grupo de Active Directory. Dado que la entrada "Identidad de grupo" también acepta el nombre anterior a 2K, esta entrada ahora es redundante, pero se mantiene para la compatibilidad con versiones anteriores.

Miembro del grupo
UserIdentity True string

Miembro del grupo que se va a agregar (normalmente un usuario, grupo o equipo). Puede especificar un usuario o grupo por Nombre distintivo (por ejemplo, CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID o SAMAccountName/pre-2K (por ejemplo, "User1"). Puede especificar un equipo por Nombre distintivo o nombre de equipo (antes de 2K) seguido de $ (por ejemplo, VM01$).

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectoryAddADGroupMemberByIdentityResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Agregar permiso de buzón de Microsoft Exchange

Asigne permisos de buzón a un objeto de Active Directory (por ejemplo, usuario o grupo).

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Microsoft Exchange. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Objeto de Active Directory
User True string

Objeto active Directory (por ejemplo, usuario o grupo) al que asignar los permisos. Puede especificar un usuario por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Derechos de acceso
AccessRights string

Derechos de acceso que se van a asignar a los permisos del usuario en el buzón. Las opciones disponibles son 'AccessSystemSecurity', 'CreateChild', 'DeleteChild', 'ListChildren', 'Self', 'ReadProperty', 'WriteProperty', 'DeleteTree', 'ListObject', 'ExtendedRight', 'Delete', 'ReadControl', 'GenericExecute', 'GenericWrite', 'GenericRead', 'WriteDacl', 'WriteOwner', 'GenericAll' y 'Synchronize'.

Derechos extendidos
ExtendedRights string

Un derecho extendido opcional para asignar a los permisos del usuario en el buzón. Los derechos extendidos incluyen "Enviar como".

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ExchangeAddADPermissionResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Agregar permiso de buzón de Microsoft Exchange al usuario

Asigne permisos de buzón a un usuario de buzón, usuario o grupo de seguridad especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Microsoft Exchange. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Usuario
User True string

Usuario que se va a agregar a los permisos del buzón. Puede especificar un usuario por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Derechos de acceso
AccessRights True string

Derechos de acceso que se van a asignar a los permisos del usuario en el buzón. Las opciones disponibles son "ChangeOwner", "ChangePermission", "DeleteItem", "ExternalAccount", "FullAccess" y "ReadPermission". Para asignar varios permisos, especifíquelos como una lista separada por comas.

Asignación automática
AutoMapping boolean

Si se establece en true, el buzón y la cuenta de usuario tendrán algunas propiedades adicionales establecidas que darán lugar a que Outlook abra automáticamente el buzón cuando haya iniciado sesión como este usuario. Esto puede tardar unos minutos en surtir efecto. Si se establece en false, no se establecerán las propiedades adicionales y Outlook no abrirá automáticamente el buzón.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ExchangeAddMailboxPermissionResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Agregar permiso de buzón de Office 365 al usuario

Asigne permisos de buzón de Microsoft Exchange Online u Office 365 a un usuario de buzón, usuario o grupo de seguridad especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identificador de un buzón de Microsoft Exchange Online u Office 365. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Usuario
User True string

El usuario de buzón, el usuario o el grupo de seguridad habilitado para correo para recibir los permisos de buzón. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Derechos de acceso
AccessRights True string

Derechos de acceso que se van a asignar a los permisos del usuario en el buzón. Las opciones disponibles son "ChangeOwner", "ChangePermission", "DeleteItem", "ExternalAccount", "FullAccess" y "ReadPermission". Para asignar varios permisos, especifíquelos como una lista separada por comas.

Asignación automática
AutoMapping boolean

Si se establece en true, el buzón y la cuenta de usuario tendrán algunas propiedades adicionales establecidas que darán lugar a que Outlook abra automáticamente el buzón cuando haya iniciado sesión como este usuario. Esto puede tardar unos minutos en surtir efecto. Si se establece en false, no se establecerán las propiedades adicionales y Outlook no abrirá automáticamente el buzón.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
O365AddMailboxPermissionResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Asignación de un usuario de Azure AD a varios roles de administrador

Asigne un usuario de Azure Active Directory (u otro objeto) a uno o varios roles de administrador de Azure Active Directory existentes. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
UserObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Identificadores de objeto de rol o nombres para mostrar
RolesJSON string

Lista de los roles de administrador que se van a asignar al usuario, en formato JSON o CSV. Por ejemplo: [{"Role": "Application Developer"}, {"Role": "Exchange Administrator"}] (formato de tabla JSON), ["Application Developer", "Exchange Administrator"] (formato de matriz JSON) o Desarrollador de aplicaciones,Administrador de Exchange (formato CSV). Puede especificar un rol de administrador de AAD por Nombre para mostrar (por ejemplo, "Desarrollador de aplicaciones") o ObjectId (por ejemplo, UUID/VALOR GUID).

Excepción si se produce un error en la asignación de roles
ExceptionIfAnyRolesFailToAssign boolean

Si se establece en true: se generará una excepción (error) si un único rol de administrador de Azure AD no puede asignar (es decir, 100% correcto es un requisito). Si no se produce ninguna excepción, esta acción notificará cuántos roles de administrador de Azure AD se asignaron correctamente y cuántos no se pudieron asignar.

Excepción si todos los roles no se pueden asignar
ExceptionIfAllRolesFailToAssign boolean

Si se establece en true: solo se generará una excepción (error) si todos los roles de administrador de Azure AD no pueden asignar (es decir, sin éxito y algunos errores). Si no se produce ninguna excepción, esta acción notificará cuántos roles de administrador de Azure AD se asignaron correctamente y cuántos no se pudieron asignar.

Id. de ámbito de directorio
DirectoryScopeId string

Identificador de ámbito de directorio para todos los roles que se asignan. Por ejemplo: / representa todo el inquilino, /GUID representa un registro de aplicación, /administrativeUnits/GUID representa una unidad administrativa.

Comprobar primero las pertenencias a roles de usuario
CheckUserRoleMembershipsFirst boolean

Si se establece en true (valor predeterminado), IA-Connect comprobará las asignaciones de roles del usuario antes de intentar asignarlas al rol. Si el usuario ya está asignado al rol, IA-Connect simplemente notificará el éxito sin tener que hacer nada. Si se establece en false, IA-Connect asignará inmediatamente el usuario al rol sin comprobarlo, lo que producirá un error si el usuario ya está asignado al rol.

Comprobación de que existen identificadores de rol
CheckRoleIdsExist boolean

Si se establece en true (el valor predeterminado) y uno o varios de los roles se proporcionan en formato id. de objeto, IA-Connect comprobará esos identificadores de rol son válidos. Esto se recomienda porque el mensaje de error recibido de Azure AD, cuando se proporciona un identificador de objeto no válido, no resulta útil. Si se establece en false, IA-Connect no comprobará la validez de los identificadores de rol proporcionados, lo que es más rápido.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Roles de Azure AD asignados correctamente
AzureADRolesAssignedSuccessfully integer

Número de roles de Azure AD asignados correctamente.

Los roles de Azure AD no se pudieron asignar
AzureADRolesFailedToAssign integer

Número de roles de Azure AD que no se pudieron asignar.

Mensaje de error Asignar roles de Azure AD
AssignAzureADRolesMasterErrorMessage string

Si algunos roles no se pudieron asignar y no se produjo ninguna excepción, este mensaje de error proporciona detalles del problema.

Asignación de un usuario de Azure AD al rol de administrador

Asigne un usuario de Azure Active Directory (u otro objeto) a un rol de administrador de Azure Active Directory existente. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
UserObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Id. de objeto de rol o nombre para mostrar
RoleObjectId True string

Identificador o nombre para mostrar de un rol de administrador de Azure Active Directory. Puede especificar un rol de administrador de AAD por Nombre para mostrar (por ejemplo, "Desarrollador de aplicaciones") o ObjectId (por ejemplo, UUID/VALOR GUID).

Id. de ámbito de directorio
DirectoryScopeId string

Identificador de ámbito de directorio para la asignación de roles. Por ejemplo: / representa todo el inquilino, /GUID representa un registro de aplicación, /administrativeUnits/GUID representa una unidad administrativa.

Comprobar primero las pertenencias a roles de usuario
CheckUserRoleMembershipsFirst boolean

Si se establece en true (valor predeterminado), IA-Connect comprobará las asignaciones de roles del usuario antes de intentar asignarlas al rol. Si el usuario ya está asignado al rol, IA-Connect simplemente notificará el éxito sin tener que hacer nada. Si se establece en false, IA-Connect asignará inmediatamente el usuario al rol sin comprobarlo, lo que producirá un error si el usuario ya está asignado al rol.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
AzureADv2AssignUserToRoleResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Borrar la expiración de la cuenta de usuario de Active Directory

Borra la fecha de expiración de una cuenta de Active Directory.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity True string

Identidad del usuario de Active Directory. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectoryClearADUserAccountExpirationResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Clonación de la pertenencia a grupos de usuarios de Active Directory

Agrega el usuario de Active Directory de destino a los mismos grupos de Active Directory de los que el primer usuario es miembro, menos el grupo principal (normalmente "Usuarios de dominio") ya que técnicamente no es una pertenencia.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario de origen
SourceUserIdentity True string

Identidad del usuario de Active Directory de origen (el usuario desde el que se van a copiar grupos). Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Identidad de usuario de destino
DestinationUserIdentity True string

Identidad del usuario de Active Directory de destino (el usuario al que se van a agregar los grupos). Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Grupos de AD agregados correctamente
ADGroupsAddedSuccessfully integer

Número de grupos de AD al que se agregó correctamente el usuario de destino.

Los grupos de AD no se pudieron agregar
ADGroupsFailedToAdd integer

Número de grupos de AD a los que el usuario de destino no pudo agregar.

Mensaje de error Agregar grupos de AD
AddADGroupsMasterErrorMessage string

Si el usuario de destino no pudo agregar a algunos de los grupos de AD, este mensaje de error proporciona detalles del problema.

Clonación de propiedades de usuario de Active Directory

Configura las propiedades o atributos especificados del usuario de Active Directory de origen en el usuario de Active Directory de destino.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario de origen
SourceUserIdentity True string

Identidad del usuario de Active Directory de origen (el usuario desde el que se copiarán los atributos). Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Identidad de usuario de destino
DestinationUserIdentity True string

Identidad del usuario de Active Directory de destino (el usuario al que copiar atributos). Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Propiedades que se van a clonar
PropertiesToClone True string

Lista separada por comas de propiedades de usuario que se van a copiar del usuario de origen al usuario de destino. Entre las propiedades comunes que se van a clonar se incluyen: city, company, country, department, description, division, enabled, homedirectory, homedrive, homephone, manager, office, organization, postalcode, profilepath, scriptpath, state, streetaddress.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectoryCloneADUserPropertiesResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Comprobación de que existe una unidad organizativa de Active Directory

Informa si existe una unidad organizativa (OU) de Active Directory.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de unidad organizativa
OUIdentity True string

Ruta de acceso a la unidad organizativa (OU) de destino en formato de nombre distintivo (por ejemplo, OU=Target OU,OU=London,DC=mydomain,DC=local), formato GUID o como ruta de acceso (por ejemplo, London\Target OU).

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Propiedades de unidad organizativa como JSON
PowerShellJSONOutput string

Los detalles de la unidad organizativa (OU) ubicada.

Existe una unidad organizativa
OUExists boolean

Se establece en true si existe la unidad organizativa (OU), false si no.

Conectarse a Office 365 con credenciales

Conecta IA-Connect a Office 365 mediante los módulos de PowerShell de Office 365. Esta acción (o "Conectar a Office 365 con certificado") debe emitirse antes de ejecutar cualquier otra acción de Office 365. Esta acción requiere una cuenta que no requiera MFA (2FA) o deberá usar el módulo de automatización de la interfaz de usuario para automatizar el componente 2FA (es decir, el elemento emergente de autenticación con contraseña única). Como alternativa, use la acción "Conectar a Office 365 con certificado".

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de usuario
Office365Username True string

Nombre de usuario de la cuenta que se va a usar al ejecutar comandos de PowerShell de Office 365.

Contraseña
Office365Password True password

Contraseña de la cuenta que se va a usar al ejecutar comandos de PowerShell de Office 365.

Exchange URL
ExchangeURL string

Dirección URL opcional del servidor de Microsoft Exchange Online al que conectarse. Use esto solo si tiene una dirección URL personalizada.

Método de conexión
ConnectionMethod string

Qué método se debe usar para conectarse a Microsoft Exchange. Tanto "EXO V1 local" como "EXO V1 remote" usan el PowerShell original de Microsoft Exchange Online que se ejecuta en el equipo que ejecuta el agente de IA-Connect y no requiere ningún módulo adicional de PowerShell, pero finalmente quedará en desuso. "EXO V1 local" importa el espacio de ejecución remoto de Exchange localmente y ejecuta comandos localmente. "EXO V1 remote" se ejecuta directamente en el espacio de ejecución remoto de Exchange y no puede ejecutar scripts genéricos de PowerShell debido a restricciones de seguridad. "EXO V2" usa el módulo de PowerShell v2 de Microsoft Exchange Online más reciente que se ejecuta en el equipo que ejecuta el agente de IA-Connect y requiere el módulo de PowerShell "ExchangeOnlineManagement" v2 instalado.

Solo conéctese si aún no está conectado
OnlyConnectIfNotAlreadyConnected boolean

Si se establece en false: esta acción siempre se conectará a Office 365 Exchange Online aunque IA-Connect ya esté conectado. Si se establece en true (valor predeterminado): si IA-Connect ya está conectado a Office 365 Exchange Online con una configuración idéntica y la conexión de Office 365 Exchange Online responde, IA-Connect no hará nada, ya que la conexión ya está establecida.

Tipos de comandos para importar localmente
CommandTypesToImportLocally string

Los métodos de conexión "EXO v1 local" y "EXO V2" importan los comandos de PowerShell de Office 365 o Exchange Online localmente. Esta opción permite elegir qué comandos de PowerShell se deben importar. Mantener esta lista en un mínimo reduce el uso de memoria y el tiempo de conexión. "All" (valor predeterminado, para la compatibilidad con versiones anteriores) importa todos los comandos de PS. ' soloIA-Connect' (la opción recomendada) importa solo los comandos PS usados por IA-Connect (puede especificar comandos de PS adicionales). "Especificado" solo importa los comandos de PS que especifique y podría interrumpir algunas acciones de IA-Connect si dependen de los comandos de PS que no haya especificado.

Comandos adicionales para importar localmente
AdditionalCommandsToImportLocallyCSV string

Si usa los métodos de conexión "EXO v1 local" o "EXO V2" y si ha elegido importar los comandos "soloIA-Connect" o "Especificado", puede especificar una lista separada por comas de comandos PS adicionales que se van a importar. Por ejemplo: "Get-Mailbox,New-Mailbox,New-DistributionGroup".

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
OpenO365PowerShellRunspaceResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Conexión a Active Directory con credenciales

Permite especificar una cuenta alternativa que se usará al ejecutar comandos de PowerShell de Active Directory. Esto afecta a todos los comandos de Active Directory emitidos después de esta acción. Si no usa esta acción, todos los comandos de PowerShell de Active Directory se ejecutarán como la cuenta de usuario en la que se ejecuta el agente de IA-Connect.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de usuario
Username True string

Nombre de usuario de la cuenta que se va a usar al ejecutar comandos de Active Directory. Puede especificar un nombre de usuario con el formato "DOMAIN\username" (por ejemplo, TESTDOMAIN\admin) o "username@domainFQDN" (por ejemplo, admin@testdomain.local).

Contraseña
Password True password

Contraseña de la cuenta que se va a usar al ejecutar comandos de Active Directory.

Equipo remoto
RemoteComputer string

El nombre o el nombre de dominio completo (FQDN) de un controlador de dominio (DC) o un servidor miembro de Active Directory para autenticarse en y para que se pasen todas las acciones de Active Directory. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio. Si se escribe un servidor miembro (en lugar de un controlador de dominio), ese servidor miembro debe tener instalados los módulos o RSAT de Active Directory PowerShell.

Uso de SSL
UseSSL boolean

Establezca en true para conectarse al punto de conexión WSMan remoto mediante SSL.

Puerto TCP alternativo
AlternativeTCPPort integer

Se establece en un puerto TCP alternativo si no se usa el valor predeterminado de WSMan TCP/5985 (no SSL) o TCP/5986 (SSL).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
OpenActiveDirectoryPowerShellRunspaceWithCredentialsResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Conexión a Azure AD con certificado

Conecta IA-Connect a Azure Active Directory (también conocido como Id. de Microsoft Entra, Azure AD o AAD). Esta acción (o "Conectarse a Azure AD con credenciales") debe emitirse antes de ejecutar cualquier otra acción de Azure AD. Esta acción requiere que una entidad de servicio de Azure y el registro de aplicaciones de Azure AD con el certificado se configuren en Azure AD antes de que funcione, pero tiene la ventaja de no requerir MFA (2FA). Esta acción usa módulos de PowerShell de Azure AD v2 o Microsoft Graph.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de registro de aplicaciones de Azure AD
ApplicationId True string

El identificador de aplicación del registro de aplicaciones de Azure AD que contiene el certificado y tiene los roles necesarios en Azure AD para realizar las acciones de automatización. Un administrador debe haber configurado previamente este registro de aplicaciones de Azure AD.

Huella digital del certificado
CertificateThumbprint True string

Huella digital del certificado usado para la autenticación. Este certificado debe haberse creado previamente y existir en el equipo donde IA-Connect está realizando las acciones de automatización y en el registro de aplicaciones de Azure AD.

Identificador de inquilino de Azure
TenantId True string

Identificador de inquilino de Azure al que conectarse. Debe especificarse al usar certificados para autenticarse.

API que se va a usar
APIToUse string

API que se va a usar para la conexión a Azure AD. Una vez establecido, todos los comandos adicionales de Azure AD emitidos por IA-Connect usarán esta API. Si se establece en automático (valor predeterminado), los módulos de PowerShell instalados se analizarán y seleccionarán en el orden siguiente: Módulo de PowerShell usuarios de Microsoft Graph, módulo de PowerShell de Azure AD v2. El módulo de PowerShell de Azure AD v2 está en desuso el 30 de marzo de 2024 y, por tanto, se recomienda usar el módulo de PowerShell usuarios de Microsoft Graph.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
OpenAzureADv2PowerShellRunspaceWithCertificateResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Conexión a Azure AD con credenciales

Conecta IA-Connect a Azure Active Directory (también conocido como Id. de Microsoft Entra, Azure AD o AAD). Esta acción (o "Conectarse a Azure AD con certificado") debe emitirse antes de ejecutar cualquier otra acción de Azure AD. Esta acción requiere una cuenta que no use MFA (2FA) o tendrá que usar el módulo de automatización de la interfaz de usuario para automatizar el componente 2FA (es decir, el elemento emergente de autenticación de contraseña única). Como alternativa, use la acción "Conectar a Azure AD con certificado". Esta acción usa módulos de PowerShell para usuarios de Azure AD v2 o Microsoft Graph.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de usuario
Username True string

Nombre de usuario de la cuenta que se va a usar al ejecutar comandos de PowerShell de Azure AD v2.

Contraseña
Password True password

Contraseña de la cuenta que se va a usar al ejecutar comandos de PowerShell de Azure AD v2.

Identificador de inquilino de Azure
TenantId string

Identificador de inquilino de Azure opcional al que conectarse. Si se deja en blanco, se usa el inquilino predeterminado asociado a la cuenta de usuario proporcionada.

API que se va a usar
APIToUse string

API que se va a usar para la conexión a Azure AD. Una vez establecido, todos los comandos adicionales de Azure AD emitidos por IA-Connect usarán esta API. Si se establece en automático (valor predeterminado), los módulos de PowerShell instalados se analizarán y seleccionarán en el orden siguiente: Módulo de PowerShell usuarios de Microsoft Graph, módulo de PowerShell de Azure AD v2. El módulo de PowerShell de Azure AD v2 está en desuso el 30 de marzo de 2024 y, por tanto, se recomienda usar el módulo de PowerShell usuarios de Microsoft Graph.

Ámbito de autenticación
AuthenticationScope string

El ámbito de los permisos necesarios para realizar todas las tareas de automatización en esta sesión de inicio de sesión de Azure AD. De forma predeterminada, IA-Connect solicitará un ámbito de permiso para permitir la modificación de usuarios, grupos y asignaciones de licencias. Esta configuración solo se usa al conectarse mediante el módulo de PowerShell usuarios de Microsoft Graph.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
OpenAzureADv2PowerShellRunspaceResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Conexión a Microsoft Exchange

Conecta IA-Connect a un servidor de Microsoft Exchange. Esta acción debe emitirse antes de ejecutar cualquier otra acción de Exchange. Si especifica un nombre de usuario y una contraseña, todas las acciones posteriores de Exchange se ejecutarán como esa cuenta. Si no especifica un nombre de usuario y una contraseña, todas las acciones posteriores de Exchange se ejecutarán como la cuenta de usuario en la que se ejecuta el agente de IA-Connect.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de usuario
Username string

Nombre de usuario de la cuenta que se va a usar al ejecutar comandos de PowerShell de Exchange. Puede especificar un nombre de usuario con el formato "DOMAIN\username" (por ejemplo, TESTDOMAIN\admin) o "username@domainFQDN" (por ejemplo, admin@testdomain.local). Si no especifica un nombre de usuario y una contraseña, todas las acciones posteriores de Exchange se ejecutarán como la cuenta de usuario en la que se ejecuta el agente de IA-Connect.

Contraseña
Password password

Contraseña de la cuenta que se va a usar al ejecutar comandos de Exchange PowerShell.

FQDN del servidor Exchange
ExchangeServerFQDN True string

Nombre de dominio completo (FQDN) o nombre de host del servidor de Microsoft Exchange.

Uso de SSL
UseSSL boolean

Establézcalo en true si desea conectarse al servidor de Microsoft Exchange mediante HTTPS /SSL. Esto cifrará todo el tráfico, pero solo funcionará si el servidor Exchange está configurado para aceptar comandos de PowerShell a través de SSL.

Método de conexión
ConnectionMethod string

Qué método se debe usar para conectarse a Microsoft Exchange. "Local" importa el espacio de ejecución remoto de Exchange localmente y ejecuta comandos localmente. "Remote" se ejecuta directamente en el espacio de ejecución remoto de Exchange y es posible que no pueda ejecutar scripts genéricos de PowerShell debido a restricciones de seguridad.

Mecanismo de autenticación
AuthenticationMechanism string

Mecanismo de autenticación que se va a usar si se conecta a un equipo remoto o ejecuta el script como usuario alternativo. Los valores admitidos son "Basic", "Credssp", "Default", "Digest", "Kerberos" y "Negotiate".

Solo conéctese si aún no está conectado
OnlyConnectIfNotAlreadyConnected boolean

Si se establece en false: esta acción siempre se conectará a Exchange incluso si IA-Connect ya está conectado. Si se establece en true (valor predeterminado): si IA-Connect ya está conectado a Exchange con una configuración idéntica y la conexión de Exchange responde, IA-Connect no hará nada, ya que la conexión ya está establecida.

Tipos de comandos para importar localmente
CommandTypesToImportLocally string

El método de conexión "Local" importa los comandos de Exchange PowerShell localmente. Esta opción permite elegir qué comandos de PowerShell se deben importar. Mantener esta lista en un mínimo reduce el uso de memoria y el tiempo de conexión. "All" (valor predeterminado, para la compatibilidad con versiones anteriores) importa todos los comandos de PS. ' soloIA-Connect' (la opción recomendada) importa solo los comandos PS usados por IA-Connect (puede especificar comandos de PS adicionales). "Especificado" solo importa los comandos de PS que especifique y podría interrumpir algunas acciones de IA-Connect si dependen de los comandos de PS que no haya especificado.

Comandos adicionales para importar localmente
AdditionalCommandsToImportLocallyCSV string

Si usa el método de conexión "Local" y si ha elegido importar los comandos "soloIA-Connect" o "Especificado", puede especificar una lista separada por comas de comandos ps adicionales que se van a importar. Por ejemplo: "Get-Mailbox,New-Mailbox,New-DistributionGroup".

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
OpenExchangePowerShellRunspaceResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Conexión a Office 365 con certificado

Conecta IA-Connect a Office 365 mediante los módulos de PowerShell de Office 365. Esta acción (o "Conectar a Office 365 con credenciales") debe emitirse antes de ejecutar cualquier otra acción de Office 365. Esta acción requiere un registro de aplicación de Azure AD con el certificado y los roles correctos que se van a configurar en Azure AD antes de que funcionen, pero tiene la ventaja de no requerir MFA (2FA).

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de aplicación de registro de aplicaciones de Azure AD
ApplicationId True string

El identificador de aplicación del registro de aplicaciones de Azure AD que contiene el certificado y tiene los roles necesarios en Azure AD para realizar las acciones de automatización. Un administrador debe haber configurado previamente este registro de aplicaciones de Azure AD.

Huella digital del certificado
CertificateThumbprint True string

Huella digital del certificado usado para la autenticación. Este certificado debe haberse creado previamente y existir en el equipo donde IA-Connect está realizando las acciones de automatización y en el registro de aplicaciones de Azure AD.

Organización
Organization True string

La organización que se va a usar para la autenticación. Por ejemplo: mytestenvironment.onmicrosoft.com.

Exchange URL
ExchangeURL string

Dirección URL opcional del servidor de Microsoft Exchange Online al que conectarse. Use esto solo si tiene una dirección URL personalizada.

Método de conexión
ConnectionMethod string

Qué método se debe usar para conectarse a Microsoft Exchange. 'EXO V1' es el PowerShell original de Microsoft Exchange Online y no admite certificados (y, por tanto, no está disponible como opción). "EXO V2" usa el módulo de PowerShell v2 de Microsoft Exchange Online más reciente que se ejecuta en el equipo que ejecuta el agente de IA-Connect y requiere el módulo de PowerShell "ExchangeOnlineManagement" v2 instalado.

Solo conéctese si aún no está conectado
OnlyConnectIfNotAlreadyConnected boolean

Si se establece en false: esta acción siempre se conectará a Office 365 Exchange Online aunque IA-Connect ya esté conectado. Si se establece en true (valor predeterminado): si IA-Connect ya está conectado a Office 365 Exchange Online con una configuración idéntica y la conexión de Office 365 Exchange Online responde, IA-Connect no hará nada, ya que la conexión ya está establecida.

Tipos de comandos para importar localmente
CommandTypesToImportLocally string

El método de conexión "EXO V2" (necesario para la autenticación de certificados) importa los comandos de PowerShell de Office 365 o Exchange Online localmente. Esta opción permite elegir qué comandos de PowerShell se deben importar. Mantener esta lista en un mínimo reduce el uso de memoria y el tiempo de conexión. "All" (valor predeterminado, para la compatibilidad con versiones anteriores) importa todos los comandos de PS. ' soloIA-Connect' (la opción recomendada) importa solo los comandos PS usados por IA-Connect (puede especificar comandos de PS adicionales). "Especificado" solo importa los comandos de PS que especifique y podría interrumpir algunas acciones de IA-Connect si dependen de los comandos de PS que no haya especificado.

Comandos adicionales para importar localmente
AdditionalCommandsToImportLocallyCSV string

Si ha elegido importar los comandos "soloIA-Connect" o "Especificado", puede especificar una lista separada por comas de comandos PS adicionales que se van a importar. Por ejemplo: "Get-Mailbox,New-Mailbox,New-DistributionGroup".

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
OpenO365PowerShellRunspaceWithCertificateResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Conexión al dominio predeterminado de Active Directory

Conecta el agente de IA-Connect al dominio del equipo del que se ejecuta el agente de IA-Connect es miembro, usando la cuenta de la que el agente de IA-Connect se ejecuta como (es decir, el comportamiento predeterminado).

Parámetros

Nombre Clave Requerido Tipo Description
Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
OpenLocalPassthroughActiveDirectoryPowerShellRunspaceResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Conexión al entorno de JML

Conéctese a un entorno de JML donde los detalles de ese entorno se mantienen en el IA-Connect Orchestrator. Estos detalles pueden incluir credenciales, direcciones y otras configuraciones de conectividad. Por ejemplo, puede usar esta acción para conectarse a Active Directory, Microsoft Exchange, Azure AD u Office 365 Exchange Online.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre amigable
FriendlyName string

Nombre descriptivo del entorno JML que se mantiene en el IA-Connect Orchestrator.

Solo conéctese si aún no está conectado
OnlyConnectIfNotAlreadyConnected boolean

Solo se aplica a Exchange y Office 365 Exchange Online. Si se establece en false: esta acción siempre se conectará a Exchange u Office 365 Exchange Online aunque IA-Connect ya esté conectado. Si se establece en true (valor predeterminado): si IA-Connect ya está conectado a Exchange u Office 365 Exchange Online con una configuración idéntica y la conexión de Exchange responde, IA-Connect no hará nada, ya que la conexión ya está establecida.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
JMLConnectToJMLEnvironmentResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Creación de un buzón de Microsoft Exchange y una cuenta de usuario

Cree un usuario habilitado para correo en Active Directory local y cree un buzón asociado en Microsoft Exchange. Use esta acción solo si el usuario no existe en Active Directory local. Si el usuario ya existe, use la acción "Crear un buzón de Microsoft Exchange para un usuario".

Parámetros

Nombre Clave Requerido Tipo Description
Nombre
FirstName string

Nombre del usuario.

Apellido
LastName string

Apellidos o apellidos del usuario.

Unidad organizativa
OrganizationalUnit string

Unidad de organización (OU) en la que almacenar el usuario en formato de nombre distintivo (por ejemplo, OU=Target OU,OU=London,DC=mydomain,DC=local), formato GUID o como ruta de acceso (por ejemplo, MyUsers\London). Si se deja en blanco, el usuario se creará en la unidad organizativa "Usuarios".

Nombre
Name True string

Nombre del usuario de Active Directory. Aparece en la columna "Nombre" de usuarios y equipos de AD y en la parte superior de la pestaña Usuario "General". Este no es el nombre de inicio de sesión del usuario.

Nombre para mostrar
DisplayName string

Nombre para mostrar del usuario opcional.

Alias
Alias string

Alias de Exchange (también conocido como alias de correo) para el usuario. Si la directiva de dirección de correo electrónico está habilitada, se usará para generar el componente de nombre de la dirección de correo electrónico SMTP principal (por ejemplo, alias@mydomain.com). Si la directiva de dirección de correo electrónico no está habilitada, es posible que desee establecer la dirección SMTP principal en su lugar.

Dirección SMTP principal
PrimarySmtpAddress string

Dirección de correo electrónico de devolución principal que se usa para el destinatario. Es poco probable que pueda establecer esto si la "directiva de dirección de correo electrónico" está habilitada, por lo que use "Alias" en su lugar (y la directiva creará la dirección SMTP principal desde el alias) o deshabilitará la directiva de dirección de correo electrónico.

Nombre principal del usuario
UserPrincipalName True string

Nombre de inicio de sesión de usuario en Active Directory. Por lo general, debe estar en el formato "name@domainFQDN" (por ejemplo, "TestUser1@domain.local"). El usuario puede iniciar sesión con este formato: name@domainFQDN.

Nombre de la cuenta SAM
SamAccountName string

Nombre de inicio de sesión de usuario (anterior a Windows 2000) en Active Directory. Esto tiene el formato "name" (por ejemplo, "TestUser1"). El usuario puede iniciar sesión con este formato: DOMAIN\name.

Contraseña de la cuenta
Password password

Contraseña de usuario. Debe especificarse y cumplir las reglas de complejidad de contraseñas de Active Directory. Si se trata de una contraseña "Almacenada", escriba en el formato {IAConnectPassword:StoredPasswordIdentifier} y establezca la entrada "contraseña almacenada" en true. Si se trata de una credencial genérica de Orchestrator, escriba en el formato {OrchestratorCredential:FriendlyName} y establezca la entrada "contraseña almacenada" en true.

La contraseña de la cuenta se almacena
AccountPasswordIsStoredPassword boolean

Establézcalo en true si la contraseña es un identificador de contraseña almacenado IA-Connect (por ejemplo, generado por la acción "Generar contraseña") o una credencial genérica de IA-Connect Orchestrator (por ejemplo, si usa IA-Connect con un flujo de PA).

El usuario debe cambiar la contraseña en el siguiente inicio de sesión
ResetPasswordOnNextLogon boolean

Establézcalo en true si desea obligar al usuario a cambiar su contraseña cuando inicie sesión (es decir, la nueva contraseña que se establece aquí es una contraseña única para que el usuario inicie sesión). Establézcalo en false si se trata de la contraseña que usará el usuario hasta que la cambie manualmente.

Base de datos
Database string

Base de datos de Exchange que va a contener la nueva base de datos. Puede especificar la base de datos por Nombre distintivo, GUID o Nombre.

Es buzón compartido
SharedMailbox boolean

Establézcalo en true si el buzón que se va a crear debe ser un buzón compartido.

Directiva de dirección de correo electrónico habilitada
EmailAddressPolicyEnabled boolean

Establézcalo en true si desea actualizar automáticamente las direcciones de correo electrónico en función de la directiva de direcciones de correo electrónico aplicada a este destinatario. Si la directiva de dirección de correo electrónico está habilitada, esto generalmente afectará a la capacidad de establecer la dirección SMTP principal. Establézcalo en false para deshabilitar la característica, lo que le proporciona control total para establecer manualmente direcciones de correo electrónico. Deje en blanco si no desea establecer esta opción (es decir, deje el valor existente o predeterminado).

Crear buzón de archivo
Archive boolean

Establezca en true si desea crear además un buzón de archivo en Microsoft Exchange Online u Office 365.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON del resultado de la acción
PowerShellJSONOutput string

Salida de la nueva acción de buzón, en formato JSON.

Nuevo DN de buzón
NewMailboxDN string

Nombre distintivo (DN) del buzón recién creado. Se trata de un identificador único para el buzón que se podría usar en acciones adicionales en este buzón.

NUEVO GUID de buzón
NewMailboxGUID string

GUID del buzón recién creado. Se trata de un identificador único para el buzón que se podría usar en acciones adicionales en este buzón.

Creación de un nuevo grupo de Microsoft 365 de Azure AD

Crea un nuevo grupo de Microsoft 365 de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre para mostrar
DisplayName True string

Nombre para mostrar del grupo.

Description
Description string

Descripción del grupo.

Alias de correo
MailNickname string

El alias de correo electrónico, que se usa para formar la dirección de correo electrónico del grupo.

Visibilidad del grupo
GroupVisibility string

Si se establece en público (el valor predeterminado), cualquier persona puede ver el contenido del grupo y cualquier persona puede unirse al grupo. Si se establece en privado, solo los miembros pueden ver el contenido del grupo y solo los propietarios pueden agregar nuevos miembros al grupo o aprobar solicitudes de unión.

Comprobar que el grupo existe
CheckGroupExists boolean

Si se establece en true, IA-Connect comprobará si el grupo existe y, si existe, IA-Connect simplemente notificará el éxito de ese grupo sin tener que hacer nada. Si se establece en false, IA-Connect creará el grupo sin comprobarlo, lo que podría dar lugar a un nombre de grupo duplicado.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON del resultado de la acción
PowerShellJSONOutput string

Salida de la acción crear grupo de distribución, en formato JSON. Normalmente, contendrá los detalles del grupo creado.

El grupo ya existe
GroupAlreadyExists boolean

Si el grupo ya existe, se establecerá en true para informarle de que el grupo existe y, por tanto, IA-Connect no era necesario realizar ninguna acción.

Identificador de objeto del grupo creado
CreatedGroupObjectId string

Identificador de objeto del grupo creado (o el grupo existente).

Creación de un nuevo grupo de seguridad de Azure AD

Crea un nuevo grupo de seguridad de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre para mostrar
DisplayName True string

Nombre para mostrar del grupo.

Description
Description string

Descripción del grupo.

Comprobar que el grupo existe
CheckGroupExists boolean

Si se establece en true, IA-Connect comprobará si el grupo existe y, si existe, IA-Connect simplemente notificará el éxito de ese grupo sin tener que hacer nada. Si se establece en false, IA-Connect creará el grupo sin comprobarlo, lo que podría dar lugar a un nombre de grupo duplicado.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON del resultado de la acción
PowerShellJSONOutput string

Salida de la acción crear grupo de distribución, en formato JSON. Normalmente, contendrá los detalles del grupo creado.

El grupo ya existe
GroupAlreadyExists boolean

Si el grupo ya existe, se establecerá en true para informarle de que el grupo existe y, por tanto, IA-Connect no era necesario realizar ninguna acción.

Identificador de objeto del grupo creado
CreatedGroupObjectId string

Identificador de objeto del grupo creado (o el grupo existente).

Crear buzón compartido de Office 365 y cuenta de usuario

Cree un buzón compartido en Microsoft Exchange online y una cuenta de usuario en Azure Active Directory/Entra ID. Use solo esta acción si el usuario aún no existe en Azure Active Directory/Entra ID. La dirección SMTP del buzón compartido se basará en el nombre, el alias o la dirección SMTP principal (en función de las entradas proporcionadas).

Parámetros

Nombre Clave Requerido Tipo Description
Nombre
Name True string

Nombre único del buzón. Se trata de un valor interno que no será visible externamente (a menos que no establezca un alias o una dirección SMTP principal, en cuyo caso se usará como componente de nombre de la dirección de correo ELECTRÓNICO SMTP). Se recomienda establecerlo en el mismo valor que el alias, a menos que tenga un procedimiento alternativo o una buena razón para usar un valor diferente.

Nombre
FirstName string

Nombre del usuario del buzón.

Apellido
LastName string

Apellidos o apellidos del usuario del buzón.

Initials
Initials string

Iniciales intermedias del usuario del buzón.

Nombre para mostrar
DisplayName string

Nombre para mostrar del buzón opcional.

Alias
Alias string

Alias de buzón (también conocido como alias de correo) para el usuario. Este valor se usará para generar el componente de nombre de la dirección de correo electrónico SMTP del buzón (por ejemplo, un alias de 'alias' daría como resultado alias@mydomain.com). Si esto difiere de la dirección SMTP principal, esto hará que el buzón tenga varias direcciones SMTP. Si no se proporciona este valor, no se configurarán alias de buzón y el buzón solo tendrá una dirección SMTP principal.

Dirección SMTP principal
PrimarySmtpAddress string

Dirección de correo electrónico SMTP de devolución principal que se usa para el destinatario. Si esto difiere del alias del buzón, esto hará que el buzón tenga varias direcciones SMTP. Si no se proporciona este valor, la dirección SMTP principal se calculará automáticamente en función del alias o el nombre y la directiva de organización (que normalmente se basará en el dominio predeterminado establecido en el Centro de administración de Office 365).

Crear buzón de archivo
Archive boolean

Establezca en true si desea crear además un buzón de archivo en Microsoft Exchange Online u Office 365.

Región del buzón
MailboxRegion string

Región geográfica opcional en la que se va a crear el buzón, cuando se encuentra en un entorno multigeográfico.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON del resultado de la acción
PowerShellJSONOutput string

Salida de la nueva acción de buzón, en formato JSON.

Nuevo usuario: Id. de servicios en línea de Microsoft
NewUserMicrosoftOnlineServicesID string

El identificador de servicios en línea de Microsoft de la cuenta de usuario del buzón recién creado. Se trata de un identificador único para el buzón que se podría usar en otras acciones.

NUEVO GUID de buzón
NewMailboxGUID string

GUID del buzón recién creado. Se trata de un identificador único para el buzón que se podría usar en otras acciones.

Nueva dirección SMTP principal del buzón
NewMailboxPrimarySmtpAddress string

Dirección SMTP principal del buzón recién creado.

Crear buzón de archivo de Office 365 para el usuario existente

Crea un buzón archivado en Microsoft Exchange online para un usuario existente en Azure Active Directory/Entra ID. El usuario debe tener ya un buzón y una licencia adecuada.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identificador de un buzón de Microsoft Exchange Online u Office 365. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Comprobación de si existe el archivo
CheckIfArchiveExists boolean

Si se establece en true (valor predeterminado), el agente de IA-Connect comprobará si el buzón ya tiene un archivo. Si ya existe un archivo, no hay nada que hacer (ya que no se puede crear un archivo dos veces) y el agente devolverá el éxito. Si se establece en false, el agente de IA-Connect no comprobará si el buzón ya tiene un archivo, lo que produce una excepción si ya existe.

Nombre de archivo
ArchiveName string

Nombre de archivo opcional. Si no se especifica, este valor predeterminado es "In-Place Archive - {Nombre para mostrar}".

Archivo de expansión automática
AutoExpandingArchive boolean

Si se establece en true, el espacio de almacenamiento adicional se agrega automáticamente al buzón de archivo cuando se aproxima al límite de almacenamiento. Esta característica no se puede deshabilitar una vez habilitada.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
O365EnableArchiveMailboxResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Crear buzón de Microsoft Exchange Online para un usuario

Crea un buzón de correo de Microsoft Exchange Online u Office 365 (remoto) o un buzón de archivo para un usuario existente de Active Directory local que aún no tiene un buzón. La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida. También puede usar esta acción para archivar un buzón remoto existente.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

La identidad del usuario existente para la que desea crear un buzón. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Alias
Alias string

Alias de Exchange (también conocido como alias de correo) para el usuario. Si la directiva de dirección de correo electrónico está habilitada, se usará para generar el componente de nombre de la dirección de correo electrónico SMTP principal (por ejemplo, alias@mydomain.com). Si la directiva de dirección de correo electrónico no está habilitada, es posible que desee establecer la dirección SMTP principal en su lugar.

Nombre para mostrar
DisplayName string

Nombre para mostrar del buzón. Esto es visible en las listas de direcciones.

Dirección de enrutamiento remoto
RemoteRoutingAddress string

Dirección SMTP del buzón en Microsoft Exchange Online u Office 365 con la que está asociado este usuario.

Dirección SMTP principal
PrimarySmtpAddress string

Dirección de correo electrónico de devolución principal que se usa para el destinatario. Es poco probable que pueda establecer esto si la "directiva de dirección de correo electrónico" está habilitada, por lo que use "Alias" en su lugar o deshabilite la directiva de direcciones de correo electrónico.

Crear buzón de archivo
Archive boolean

Establezca en true si desea crear además un buzón de archivo en Microsoft Exchange Online u Office 365.

Directiva de dirección de correo electrónico habilitada
EmailAddressPolicyEnabled boolean

Establézcalo en true si desea actualizar automáticamente las direcciones de correo electrónico en función de la directiva de direcciones de correo electrónico aplicada a este destinatario. Si la directiva de dirección de correo electrónico está habilitada, esto generalmente afectará a la capacidad de establecer la dirección SMTP principal. Establézcalo en false para deshabilitar la característica, lo que le proporciona control total para establecer manualmente direcciones de correo electrónico. Deje en blanco si no desea establecer esta opción (es decir, deje el valor existente o predeterminado).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON del resultado de la acción
PowerShellJSONOutput string

Salida de la acción habilitar buzón remoto, en formato JSON.

Nuevo DN de buzón
NewMailboxDN string

Nombre distintivo (DN) del buzón recién creado (habilitado). Se trata de un identificador único para el buzón que se podría usar en acciones adicionales en este buzón.

NUEVO GUID de buzón
NewMailboxGUID string

Guid del buzón recién creado (habilitado). Se trata de un identificador único para el buzón que se podría usar en acciones adicionales en este buzón.

Crear buzón de Office 365 y cuenta de usuario

Cree un buzón en Microsoft Exchange Online y una cuenta de usuario en Azure Active Directory/Entra ID. Use solo esta acción si el usuario aún no existe en Azure Active Directory/Entra ID. Si el usuario ya existe, asigne una licencia adecuada a la cuenta de usuario en su lugar.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de servicios en línea de Microsoft
MicrosoftOnlineServicesID True string

Identificador único del usuario. Normalmente, esto tiene el formato 'name@xxx.onmicrosoft.com'.

Nombre
Name True string

Nombre único del buzón. Se trata de un valor interno que no será visible externamente. Se recomienda establecerlo en el mismo valor que el componente de nombre de su identificador de servicios en línea de Microsoft (por ejemplo, "usuario1", a menos que tenga un procedimiento alternativo o una buena razón para usar un valor diferente.

Nombre
FirstName string

Nombre del usuario.

Apellido
LastName string

Apellidos o apellidos del usuario.

Initials
Initials string

Iniciales intermedias del usuario.

Nombre para mostrar
DisplayName string

Nombre para mostrar del usuario opcional.

Alias
Alias string

Alias de buzón (también conocido como alias de correo) para el usuario. Este valor se usará para generar el componente de nombre de la dirección de correo electrónico SMTP del usuario (por ejemplo, un alias de "alias" daría como resultado alias@mydomain.com). Si esto difiere de la dirección SMTP principal, esto hará que el usuario tenga varias direcciones SMTP. Si no se proporciona este valor, no se configurarán alias de usuario y el usuario solo tendrá una dirección SMTP principal.

Dirección SMTP principal
PrimarySmtpAddress string

Dirección de correo electrónico SMTP de devolución principal que se usa para el destinatario. Si esto difiere del alias de usuario, esto hará que el usuario tenga varias direcciones SMTP. Si no se proporciona este valor, la dirección SMTP principal se calculará automáticamente en función de la directiva de organización (que normalmente se basará en el dominio predeterminado establecido en el Centro de administración de Office 365).

Contraseña de la cuenta
Password password

Contraseña de usuario. Debe especificarse y cumplir las reglas de complejidad de contraseñas de Azure Active Directory. Si se trata de una contraseña "Almacenada", escriba en el formato {IAConnectPassword:StoredPasswordIdentifier} y establezca la entrada "contraseña almacenada" en true. Si se trata de una credencial genérica de Orchestrator, escriba en el formato {OrchestratorCredential:FriendlyName} y establezca la entrada "contraseña almacenada" en true.

La contraseña de la cuenta se almacena
AccountPasswordIsStoredPassword boolean

Establézcalo en true si la contraseña es un identificador de contraseña almacenado IA-Connect (por ejemplo, generado por la acción "Generar contraseña") o una credencial genérica de IA-Connect Orchestrator (por ejemplo, si usa IA-Connect con un flujo de PA).

El usuario debe cambiar la contraseña en el siguiente inicio de sesión
ResetPasswordOnNextLogon boolean

Establézcalo en true si desea obligar al usuario a cambiar su contraseña cuando inicie sesión (es decir, la nueva contraseña que se establece aquí es una contraseña única para que el usuario inicie sesión). Establézcalo en false si se trata de la contraseña que usará el usuario hasta que la cambie manualmente.

Crear buzón de archivo
Archive boolean

Establezca en true si desea crear además un buzón de archivo en Microsoft Exchange Online u Office 365.

Plan de buzón
MailboxPlan string

Plan de buzón opcional que se va a aplicar al buzón. Un plan de buzón especifica los permisos y características que están disponibles para un buzón. Para ver los planes de buzón disponibles, ejecute el script "Get-MailboxPlan" en el espacio de ejecución de PowerShell "Office 365" en el IA-Connect Inspector.

Región del buzón
MailboxRegion string

Región geográfica opcional en la que se va a crear el buzón, cuando se encuentra en un entorno multigeográfico.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON del resultado de la acción
PowerShellJSONOutput string

Salida de la nueva acción de buzón, en formato JSON.

Nuevo usuario: Id. de servicios en línea de Microsoft
NewUserMicrosoftOnlineServicesID string

El identificador de servicios en línea de Microsoft de la cuenta de usuario recién creada. Se trata de un identificador único para el usuario que podría usarse en otras acciones.

NUEVO GUID de buzón
NewMailboxGUID string

GUID del buzón recién creado. Se trata de un identificador único para el buzón que se podría usar en otras acciones.

Nueva dirección SMTP principal del buzón
NewMailboxPrimarySmtpAddress string

Dirección SMTP principal del buzón recién creado.

Crear buzón y cuenta de usuario de Microsoft Exchange Online

Cree un usuario habilitado para correo en Active Directory local y cree un buzón remoto asociado en Microsoft Exchange Online u Office 365. Use esta acción solo si el usuario no existe en Active Directory local. Si el usuario ya existe, use la acción "Crear buzón de Microsoft Exchange Online para un usuario". La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre
FirstName string

Nombre del usuario.

Apellido
LastName string

Apellidos o apellidos del usuario.

Unidad organizativa
OnPremisesOrganizationalUnit string

Unidad de organización (OU) en la que almacenar el usuario en formato de nombre distintivo (por ejemplo, OU=Target OU,OU=London,DC=mydomain,DC=local), formato GUID o como ruta de acceso (por ejemplo, MyUsers\London). Si se deja en blanco, el usuario se creará en la unidad organizativa "Usuarios".

Nombre
Name True string

Nombre del usuario de Active Directory. Aparece en la columna "Nombre" de usuarios y equipos de AD y en la parte superior de la pestaña Usuario "General". Este no es el nombre de inicio de sesión del usuario.

Nombre para mostrar
DisplayName string

Nombre para mostrar del usuario opcional.

Dirección de enrutamiento remoto
RemoteRoutingAddress string

Establezca esta opción para invalidar la dirección SMTP del buzón en Microsoft Exchange Online u Office 365 con la que está asociado este usuario. Si deja este campo en blanco (valor predeterminado), la dirección de enrutamiento remoto se calcula automáticamente en función de la sincronización de directorios entre el entorno local y Microsoft Exchange Online.

Alias
Alias string

Alias de Exchange (también conocido como alias de correo) para el usuario. Si la directiva de dirección de correo electrónico está habilitada, se usará para generar el componente de nombre de la dirección de correo electrónico SMTP principal (por ejemplo, alias@mydomain.com). Si la directiva de dirección de correo electrónico no está habilitada, es posible que desee establecer la dirección SMTP principal en su lugar.

Dirección SMTP principal
PrimarySmtpAddress string

Dirección de correo electrónico de devolución principal que se usa para el destinatario. Es poco probable que pueda establecer esto si la "directiva de dirección de correo electrónico" está habilitada, por lo que use "Alias" en su lugar (y la directiva creará la dirección SMTP principal desde el alias) o deshabilitará la directiva de dirección de correo electrónico.

Nombre principal del usuario
UserPrincipalName True string

Nombre de inicio de sesión de usuario en Active Directory. Por lo general, debe estar en el formato "name@domainFQDN" (por ejemplo, "TestUser1@domain.local"). El usuario puede iniciar sesión con este formato: name@domainFQDN.

Nombre de la cuenta SAM
SamAccountName string

Nombre de inicio de sesión de usuario (anterior a Windows 2000) en Active Directory. Esto tiene el formato "name" (por ejemplo, "TestUser1"). El usuario puede iniciar sesión con este formato: DOMAIN\name.

Contraseña de la cuenta
Password password

Contraseña de usuario. Debe especificarse y cumplir las reglas de complejidad de contraseñas de Active Directory. Si se trata de una contraseña "Almacenada", escriba en el formato {IAConnectPassword:StoredPasswordIdentifier} y establezca la entrada "contraseña almacenada" en true. Si se trata de una credencial genérica de Orchestrator, escriba en el formato {OrchestratorCredential:FriendlyName} y establezca la entrada "contraseña almacenada" en true.

La contraseña de la cuenta se almacena
AccountPasswordIsStoredPassword boolean

Establézcalo en true si la contraseña es un identificador de contraseña almacenado IA-Connect (por ejemplo, generado por la acción "Generar contraseña") o una credencial genérica de IA-Connect Orchestrator (por ejemplo, si usa IA-Connect con un flujo de PA).

El usuario debe cambiar la contraseña en el siguiente inicio de sesión
ResetPasswordOnNextLogon boolean

Establézcalo en true si desea obligar al usuario a cambiar su contraseña cuando inicie sesión (es decir, la nueva contraseña que se establece aquí es una contraseña única para que el usuario inicie sesión). Establézcalo en false si se trata de la contraseña que usará el usuario hasta que la cambie manualmente.

Es buzón compartido
SharedMailbox boolean

Establézcalo en true si el buzón que se va a crear debe ser un buzón compartido.

Directiva de dirección de correo electrónico habilitada
EmailAddressPolicyEnabled boolean

Establézcalo en true si desea actualizar automáticamente las direcciones de correo electrónico en función de la directiva de direcciones de correo electrónico aplicada a este destinatario. Si la directiva de dirección de correo electrónico está habilitada, esto generalmente afectará a la capacidad de establecer la dirección SMTP principal. Establézcalo en false para deshabilitar la característica, lo que le proporciona control total para establecer manualmente direcciones de correo electrónico. Deje en blanco si no desea establecer esta opción (es decir, deje el valor existente o predeterminado).

Crear buzón de archivo
Archive boolean

Establezca en true si desea crear además un buzón de archivo en Microsoft Exchange Online u Office 365.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON del resultado de la acción
PowerShellJSONOutput string

Salida de la nueva acción de buzón remoto, en formato JSON.

Nuevo DN de buzón
NewMailboxDN string

Nombre distintivo (DN) del buzón recién creado. Se trata de un identificador único para el buzón que se podría usar en acciones adicionales en este buzón.

NUEVO GUID de buzón
NewMailboxGUID string

GUID del buzón recién creado. Se trata de un identificador único para el buzón que se podría usar en acciones adicionales en este buzón.

Crear un buzón de Microsoft Exchange para un usuario

Crea un buzón de Microsoft Exchange para un usuario existente que aún no tiene un buzón.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

La identidad del usuario existente para la que desea crear un buzón. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Alias
Alias string

Alias de Exchange (también conocido como alias de correo) para el usuario. Si la directiva de dirección de correo electrónico está habilitada, se usará para generar el componente de nombre de la dirección de correo electrónico SMTP principal (por ejemplo, alias@mydomain.com). Si la directiva de dirección de correo electrónico no está habilitada, es posible que desee establecer la dirección SMTP principal en su lugar.

Nombre para mostrar
DisplayName string

Nombre para mostrar del buzón. Esto es visible en las listas de direcciones.

Controlador de dominio vinculado
LinkedDomainController string

Si va a crear un buzón vinculado, esto le permite especificar el controlador de dominio en el bosque donde reside la cuenta de usuario. Use el nombre de dominio completo (FQDN) del controlador de dominio.

Cuenta maestra vinculada
LinkedMasterAccount string

Si va a crear un buzón vinculado, esto le permite especificar la cuenta a la que está vinculado el buzón. Puede especificar la cuenta por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID o Nombre (por ejemplo, "User1").

Base de datos
Database string

Base de datos de Exchange que va a contener la nueva base de datos. Puede especificar la base de datos por Nombre distintivo, GUID o Nombre.

Dirección SMTP principal
PrimarySmtpAddress string

Dirección de correo electrónico de devolución principal que se usa para el destinatario. Es poco probable que pueda establecer esto si la "directiva de dirección de correo electrónico" está habilitada, por lo que use "Alias" en su lugar (y la directiva creará la dirección SMTP principal desde el alias) o deshabilitará la directiva de dirección de correo electrónico.

Directiva de dirección de correo electrónico habilitada
EmailAddressPolicyEnabled boolean

Establézcalo en true si desea actualizar automáticamente las direcciones de correo electrónico en función de la directiva de direcciones de correo electrónico aplicada a este destinatario. Si la directiva de dirección de correo electrónico está habilitada, esto generalmente afectará a la capacidad de establecer la dirección SMTP principal. Establézcalo en false para deshabilitar la característica, lo que le proporciona control total para establecer manualmente direcciones de correo electrónico. Deje en blanco si no desea establecer esta opción (es decir, deje el valor existente o predeterminado).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON del resultado de la acción
PowerShellJSONOutput string

Salida de la acción habilitar buzón, en formato JSON.

Nuevo DN de buzón
NewMailboxDN string

Nombre distintivo (DN) del buzón recién creado (habilitado). Se trata de un identificador único para el buzón que se podría usar en acciones adicionales en este buzón.

NUEVO GUID de buzón
NewMailboxGUID string

Guid del buzón recién creado (habilitado). Se trata de un identificador único para el buzón que se podría usar en acciones adicionales en este buzón.

Crear un nuevo grupo de distribución de Microsoft Exchange

Crea un nuevo grupo de distribución de Microsoft Exchange o un grupo de seguridad habilitado para correo.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre del grupo
Name True string

Nombre único del nuevo grupo.

Alias
Alias string

Alias (también conocido como alias de correo) para el nuevo grupo. Si no especifica una dirección SMTP, el alias se usará para generar el componente de nombre de la dirección de correo electrónico (por ejemplo, alias@mydomain.com).

Nombre para mostrar
DisplayName string

Nombre para mostrar del grupo. Esto es visible en las listas de direcciones.

Notas
Notes string

Notas opcionales sobre el objeto .

Administrado por
ManagedBy string

Propietario del grupo. Si no especifica un propietario, el usuario que creó el grupo se convertirá en el propietario. El propietario puede ser un buzón, un usuario de correo o un grupo de seguridad habilitado para correo. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Members
Members string

Lista separada por comas de miembros que se van a agregar al nuevo grupo. Puede especificar miembros por Nombre, Alias, Nombre distintivo (por ejemplo, CN=MyGroup,OU=Mis grupos,DC=mydomain,DC=local), Dirección de correo electrónico o GUID.

Unidad organizativa
OrganizationalUnit string

Unidad organizativa (OU) en Active Directory en la que se va a almacenar el grupo. Puede especificar una unidad organizativa en formato de nombre distintivo (por ejemplo, OU=Target OU,OU=London,DC=mydomain,DC=local), formato GUID o como ruta de acceso (por ejemplo, MyGroups\London). Si se deja en blanco, el grupo se creará en la unidad organizativa "Usuarios".

Dirección SMTP principal
PrimarySmtpAddress string

Dirección de correo electrónico de devolución principal que se usa para el nuevo grupo.

Restricción de salida de miembros
MemberDepartRestriction string

Permite especificar restricciones en un miembro que sale de un grupo de distribución. 'Open' es el valor predeterminado y permite a los miembros abandonar el grupo sin aprobación, 'Closed' restringe a los miembros salir del grupo. Esta opción se omite para los grupos de seguridad, ya que los usuarios no pueden quitarse de grupos de seguridad.

Restricción de unión a miembros
MemberJoinRestriction string

Permite especificar restricciones en un miembro que se une a un grupo de distribución una vez creado. "Open" permite a los miembros unirse al grupo sin aprobación, "Closed" (el valor predeterminado) restringe a los miembros de unirse al grupo, "ApprovalRequired" permite a un miembro solicitar unirse al grupo y se agregan si un propietario del grupo acepta la solicitud. Esta opción se omite para los grupos de seguridad, ya que los usuarios no pueden agregarse a grupos de seguridad.

Requerir autenticación de remitente
RequireSenderAuthenticationEnabled boolean

Establézcalo en true para especificar que el grupo solo aceptará mensajes de remitentes autenticados (internos). Establézcalo en false para aceptar mensajes de todos los remitentes.

Tipo de grupo
Type string

Especifique el tipo de grupo que se va a crear. 'Distribution' es el valor predeterminado y crea un grupo de distribución. "Seguridad" se usa para crear un grupo de seguridad habilitado para correo.

Excepción si el grupo ya existe
ErrorIfGroupAlreadyExists boolean

¿Debería producirse una excepción si el grupo ya existe? Establézcalo en false para no hacer nada si el grupo ya existe (por ejemplo, ya se ha creado). Se establece en true si el grupo ya existente es un error (es decir, no se esperaba que exista).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON del resultado de la acción
PowerShellJSONOutput string

Salida de la acción crear grupo de distribución, en formato JSON. Normalmente, contendrá los detalles del grupo creado.

El grupo ya existe
GroupAlreadyExists boolean

Si el grupo ya existe (y "Exception if group already exists" está establecido en false), se establecerá en true para informarle de que el grupo no se creó realmente porque ya existe.

Nuevo DN de grupo
NewGroupDN string

Nombre distintivo (DN) del grupo recién creado. Se trata de un identificador único para el grupo que se podría usar en acciones adicionales en este grupo.

NUEVO GUID de grupo
NewGroupGUID string

GUID del grupo recién creado (habilitado). Se trata de un identificador único para el grupo que se podría usar en acciones adicionales en este grupo.

Crear un nuevo grupo de distribución de Office 365

Crea un nuevo grupo de seguridad habilitado para correo o grupo de distribución de Microsoft Exchange Online u Office 365.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre del grupo
Name True string

Nombre único del nuevo grupo.

Alias
Alias string

Alias (también conocido como alias de correo) para el nuevo grupo. Si no especifica una dirección SMTP, el alias se usará para generar el componente de nombre de la dirección de correo electrónico (por ejemplo, alias@mydomain.com).

Nombre para mostrar
DisplayName string

Nombre para mostrar del grupo. Esto es visible en las listas de direcciones.

Notas
Notes string

Notas opcionales sobre el objeto .

Administrado por
ManagedBy string

Propietario del grupo. Si no especifica un propietario, el usuario que creó el grupo se convertirá en el propietario. El propietario puede ser un buzón, un usuario de correo o un grupo de seguridad habilitado para correo. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Members
Members string

Lista separada por comas de miembros que se van a agregar al nuevo grupo. Puede especificar miembros por Nombre, Alias, Nombre distintivo (por ejemplo, CN=MyGroup,OU=Mis grupos,DC=mydomain,DC=local), Dirección de correo electrónico o GUID.

Unidad organizativa
OrganizationalUnit string

Unidad organizativa (OU) en Azure Active Directory en la que se va a almacenar el grupo. Puede especificar una unidad organizativa en formato de nombre distintivo (por ejemplo, OU=Ou=Target OU,OU=London,DC=mydomain,DC=local) o formato GUID.

Dirección SMTP principal
PrimarySmtpAddress string

Dirección de correo electrónico de devolución principal que se usa para el nuevo grupo.

Restricción de salida de miembros
MemberDepartRestriction string

Permite especificar restricciones en un miembro que sale del grupo. 'Open' es el valor predeterminado y permite a los miembros abandonar el grupo sin aprobación, 'Closed' restringe a los miembros salir del grupo.

Restricción de unión a miembros
MemberJoinRestriction string

Permite especificar restricciones en un miembro que se une al grupo una vez creado. "Open" permite a los miembros unirse al grupo sin aprobación, "Closed" (el valor predeterminado) restringe a los miembros de unirse al grupo, "ApprovalRequired" permite a un miembro solicitar unirse al grupo y se agregan si un propietario del grupo acepta la solicitud.

Requerir autenticación de remitente
RequireSenderAuthenticationEnabled boolean

Establézcalo en true para especificar que el grupo solo aceptará mensajes de remitentes autenticados (internos). Establézcalo en false para aceptar mensajes de todos los remitentes.

Tipo de grupo
Type string

Especifique el tipo de grupo que se va a crear. 'Distribution' es el valor predeterminado y crea un grupo de distribución. "Seguridad" se usa para crear un grupo de seguridad habilitado para correo.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON del resultado de la acción
PowerShellJSONOutput string

Salida de la acción crear grupo de distribución, en formato JSON. Normalmente, contendrá los detalles del grupo creado.

El grupo ya existe
GroupAlreadyExists boolean

Si el grupo ya existe, se establecerá en true para informarle de que el grupo no se creó realmente.

DN del grupo creado
CreatedGroupDN string

Nombre distintivo (DN) del grupo creado (o el grupo existente).

GUID de grupo creado
CreatedGroupGUID string

GUID del grupo creado (o el grupo existente).

Identidad de grupo creada
CreatedGroupIdentity string

La identidad del grupo creado (o el grupo existente).

Desbloquear cuenta de Active Directory

Desbloquee una cuenta de Active Directory. Si la cuenta no está bloqueada, este comando no hace nada.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity True string

Identidad del usuario de Active Directory. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectoryUnlockADAccountByIdentityResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Desconectar de Microsoft Exchange

Desconecta IA-Connect de un servidor de Microsoft Exchange (conectado mediante la acción "Conectar a Microsoft Exchange"). No podrá volver a emitir acciones de Microsoft Exchange PowerShell hasta que vuelva a conectarse.

Parámetros

Nombre Clave Requerido Tipo Description
Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
CloseExchangePowerShellRunspaceResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Desconectar de Office 365

Desconecta IA-Connect de Office 365 mediante los módulos de PowerShell de Office 365 (conectados mediante la acción "Conectar a Office 365"). No podrá volver a emitir acciones de PowerShell de Office 365 hasta que vuelva a conectarse.

Parámetros

Nombre Clave Requerido Tipo Description
Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
CloseO365PowerShellRunspaceResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Desconexión de Active Directory

Si ha usado la acción "Open Active Directory PowerShell runspace with credentials" (Abrir el espacio de ejecución de PowerShell de Active Directory con credenciales) para ejecutar comandos de PowerShell de Active Directory como una cuenta de usuario alternativa o para un dominio alternativo, esta acción devuelve el agente de IA-Connect al comportamiento predeterminado de ejecutar acciones de Active Directory como la cuenta de usuario en la que se ejecuta el agente de IA-Connect.

Parámetros

Nombre Clave Requerido Tipo Description
Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
CloseActiveDirectoryPowerShellRunspaceResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Desconexión de Azure AD

Desconecta IA-Connect de Azure Active Directory (también conocido como Microsoft Entra ID, Azure AD o AAD). No podrá volver a emitir acciones de Azure AD hasta que se vuelva a conectar. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse originalmente.

Parámetros

Nombre Clave Requerido Tipo Description
Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
CloseAzureADv2PowerShellRunspaceResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Deshabilitación de la cuenta de usuario de Active Directory

Deshabilita una cuenta de usuario de Active Directory. Si una cuenta de usuario está deshabilitada, el usuario no puede iniciar sesión.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity True string

Identidad del usuario de Active Directory. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectoryDisableADUserByIdentityResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Deshabilitación del usuario de Azure AD

Deshabilita un usuario de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
UserObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Revocar tokens de actualización de usuario
RevokeUserRefreshTokens boolean

Establézcalo en true para revocar los tokens de actualización emitidos al usuario, lo que hará que las sesiones abiertas dejen de funcionar, normalmente dentro de la hora (cuando sus sesiones intentan usar un token de actualización para mantener activa su conexión).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
AzureADv2DisableUserResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Deshabilitar el buzón de Microsoft Exchange Online para un usuario

Deshabilite un buzón existente de Microsoft Exchange Online u Office 365 (remoto). La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Correo de Microsoft Exchange Online u Office 365 (remoto). Puede especificar un buzón de Microsoft Exchange Online u Office 365 (remoto) por id. de objeto de Active Directory, alias, nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, email address, GUID o User Principal Name (UPN).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON del resultado de la acción
PowerShellJSONOutput string

Salida de la acción deshabilitar buzón, en formato JSON.

Deshabilitar el buzón de Microsoft Exchange para un usuario

Deshabilite un buzón de Microsoft Exchange existente.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Microsoft Exchange. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON del resultado de la acción
PowerShellJSONOutput string

Salida de la acción deshabilitar buzón, en formato JSON.

Ejecución del script de PowerShell de Active Directory

Ejecuta un script de PowerShell en el espacio de ejecución de Active Directory en la sesión donde se ejecuta el agente de IA-Connect, donde el contenido del script se pasa al agente de IA-Connect como parte del comando. Esta es la acción recomendada para ejecutar su propio código personalizado de PowerShell de Active Directory. Esta acción también se puede usar para recuperar los resultados de una ejecución anterior de un script de PowerShell, que se ejecuta como un subproceso del Agente.

Parámetros

Nombre Clave Requerido Tipo Description
Contenido del script de PowerShell
PowerShellScriptContents string

Contenido del script de PowerShell que se va a ejecutar en el espacio de ejecución de Active Directory. IA-Connect ejecutará este script as-is pasando directamente al motor de automatización de PowerShell. En realidad, no se crea ningún script de PowerShell en disco. Como alternativa, puede ejecutar un script de PowerShell existente en el disco; para ello, escriba lo siguiente: return & 'scriptpath'. Por ejemplo: return & 'c:\scripts\ADTestScript.ps1'.

No se produce ningún error
IsNoResultAnError boolean

Si el comando de PowerShell no devuelve ningún dato, ¿esto sugiere un error?

Devolver tipos complejos
ReturnComplexTypes boolean

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Las entradas "Properties to return as collection", "Property names to serialize" (Nombres de propiedad para serializar) y "Property types to serialize" (Tipos de propiedad para serializar) permiten especificar qué propiedades "complejas" se deben devolver y el método utilizado para dar formato a los datos (en una base de propiedad por propiedad, elija el que mejor funciona). Esta entrada le permite especificar lo que se debe hacer con las propiedades restantes (es decir, propiedades que son "complejas" y no se denominan explícitamente). Si se establece en true, IA-Connect intentará devolver una representación de cadena de los datos mediante ToString(). Si se establece en false (valor predeterminado), IA-Connect no devolverá la propiedad .

Devolver un valor booleano como booleano
ReturnBooleanAsBoolean boolean

¿Deben devolverse propiedades booleanas como booleanos? Si es false, se devuelven como cadenas.

Devolver numérico como decimal
ReturnNumericAsDecimal boolean

¿Deben devolverse propiedades numéricas como numéricos? Si es false, se devuelven como cadenas.

Fecha de devolución como fecha
ReturnDateAsDate boolean

¿Deben devolverse las propiedades Date como fechas? Si es false, se devuelven como cadenas.

Propiedades que se van a devolver como colección
PropertiesToReturnAsCollectionJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por nombre) IA-Connect deben intentar devolver como una colección. En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Nombres de propiedad para serializar" y "Tipos de propiedad para serializar" (elija uno). Esta entrada se puede escribir en formato JSON o CSV. Por ejemplo: Para devolver las propiedades de matriz EmailAddresses y MemberOf, escriba [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (formato de tabla JSON), ["EmailAddresses", "MemberOf"] (formato de matriz JSON) o EmailAddresses,MemberOf (formato CSV).

Ejecutar script como subproceso
RunScriptAsThread boolean

Si se establece en false (valor predeterminado), el agente de IA-Connect ejecutará el script de PowerShell inmediatamente y devolverá los resultados al director cuando se complete el script. Si ejecuta un script de PowerShell largo o complejo, esta acción puede agotar el tiempo de espera. Si se establece en true, el agente de IA-Connect ejecutará el script de PowerShell como un subproceso del agente y el IA-Connect Director (o Orquestador, módulo de PowerShell, Blue Prism) puede supervisar el estado de este subproceso del Agente, esperando a que se complete. Esto permite que los scripts de PowerShell largos o complejos se ejecuten sin tiempos de espera. IA-Connect Agents 9.3 y versiones anteriores no pueden ejecutar scripts de PowerShell como subproceso del agente.

Recuperación de datos de salida para el identificador de subproceso
RetrieveOutputDataFromThreadId integer

Si anteriormente ejecutó un script de PowerShell como subproceso del Agente y estableció "Segundos para esperar el subproceso" en 0, proporcione el identificador del subproceso del agente para recuperar los resultados. La llamada anterior a esta acción proporcionará este identificador de subproceso del agente. Establezca en 0 (valor predeterminado) si simplemente ejecuta un script de PowerShell (y, por lo tanto, no recupera los resultados de un script de PowerShell anterior se ejecuta como un subproceso del Agente).

Segundos para esperar el subproceso
SecondsToWaitForThread integer

Si "Ejecutar script como subproceso" se establece en true, cuántos segundos esperarán a que se complete el subproceso del Agente. Si el subproceso del agente que ejecuta el script de PowerShell no se ha completado en este momento, se producirá una excepción. Establezca en 0 para omitir la espera: el agente seguirá ejecutando el script de PowerShell, pero también estará disponible para la siguiente acción. A continuación, puede recuperar los resultados del script más adelante mediante la acción "Esperar a que el subproceso del Agente se complete correctamente" para esperar a que se complete el subproceso del agente y, a continuación, volver a ejecutar esta acción "Ejecutar script de PowerShell" con la entrada "Recuperar datos de salida para el identificador de subproceso" establecido en el identificador del subproceso del agente.

El script contiene la contraseña almacenada
ScriptContainsStoredPassword boolean

Se establece en true si el script contiene un identificador de contraseña almacenado IA-Connect, con el formato {IAConnectPassword:StoredPasswordIdentifier} o una credencial genérica de IA-Connect Orchestrator, con el formato {OrchestratorCredential:FriendlyName}. La frase { } se reemplazará por la contraseña especificada, se escapará y colocará entre comillas simples (a menos que ya esté entre comillas en el script).

Salida detallada del registro
LogVerboseOutput boolean

Establézcalo en true para registrar cualquier salida detallada de PowerShell en los registros de IA-Connect. Esto podría ser útil para la depuración. Para registrar detalladamente en el script, use el siguiente PowerShell: Write-Verbose "Mi mensaje" -Verbose.

Nombres de propiedad para serializar
PropertyNamesToSerializeJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por nombre) IA-Connect deben serializarse como JSON, por lo que se devuelven como un tipo de cadena (que puede deserializar, una vez recibido). En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Propiedades para devolver como colección" y "Tipos de propiedad para serializar" (elija uno). Por ejemplo: Para serializar las propiedades EmailAddresses y MemberOf, escriba [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (formato de tabla JSON), ["EmailAddresses", "MemberOf"] (formato de matriz JSON) o EmailAddresses,MemberOf (formato CSV).

Tipos de propiedad para serializar
PropertyTypesToSerializeJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por tipo) IA-Connect deben serializarse como JSON, por lo que se devuelven como un tipo de cadena (que puede deserializar, una vez recibido). En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Propiedades para devolver como colección" y "Nombres de propiedad para serializar" (elija uno). Esta entrada es una colección con un único campo 'PropertyType'. Por ejemplo: Para serializar cualquier propiedad de tipo Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[], escriba [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] (formato de tabla JSON), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (formato de matriz JSON) o "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (formato CSV).

Nombre
Name string

Nombre del parámetro de PowerShell de entrada. Debe cumplir los formatos de nomenclatura de variables de PowerShell (es decir, se recomienda evitar espacios o símbolos especiales). Los nombres de variables de PowerShell no distinguen mayúsculas de minúsculas. Por ejemplo: MyVariable daría lugar a que se creara una variable $MyVariable.

Valor de cadena
StringValue string

Valor de cadena que se va a asignar al parámetro de PowerShell de entrada. Como alternativa, use de las otras entradas de valor si está especificando un valor booleano o numérico.

Valor entero
IntValue integer

Valor entero (número entero) que se va a asignar al parámetro de PowerShell de entrada. También puede usar las demás entradas de valor si está especificando una cadena, un valor booleano o numérico.

Valor booleano
BooleanValue boolean

Valor booleano (true o false) que se va a asignar al parámetro de PowerShell de entrada. Como alternativa, use de las otras entradas de valor si está especificando una cadena o un valor numérico.

Valor decimal
DecimalValue double

Valor decimal que se va a asignar al parámetro de PowerShell de entrada. También puede usar de las otras entradas de valor si está especificando una cadena, un valor booleano o entero.

Valor del objeto
ObjectValue object

Valor de objeto que se va a asignar al parámetro de PowerShell de entrada. Se convertirá en una variable de cadena serializada JSON en el script de PowerShell, por lo que se deserializará en un objeto mediante ConvertFrom-Json. También puede usar las demás entradas de valor si está especificando una cadena, un valor booleano o numérico.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de salida de PowerShell
PowerShellJSONOutput string

Salida del script de PowerShell, con formato JSON.

Identificador de subproceso
ThreadId integer

Si el script de PowerShell se ejecuta como un subproceso del Agente, esta salida contendrá el identificador del subproceso del agente que se puede usar para supervisar la ejecución del script de PowerShell y recuperar los resultados del script de PowerShell cuando se haya completado el script.

Ejecución del script de PowerShell de Azure AD

Ejecuta un script de PowerShell en el espacio de ejecución de Azure Active Directory (también conocido como Id. de Entra de Microsoft, Azure AD o AAD) en la sesión en la que se ejecuta el agente de IA-Connect, donde se pasa el contenido del script al agente de IA-Connect como parte del comando. Esta es la acción recomendada para ejecutar sus propios scripts personalizados de PowerShell de Azure AD. Esta acción también se puede usar para recuperar los resultados de una ejecución anterior de un script de PowerShell, que se ejecuta como un subproceso del Agente. Esta acción usa módulos de PowerShell para usuarios de Azure AD v2 o Microsoft Graph.

Parámetros

Nombre Clave Requerido Tipo Description
Contenido del script de PowerShell
PowerShellScriptContents string

Contenido del script de PowerShell que se va a ejecutar en el espacio de ejecución de Azure AD v2. IA-Connect ejecutará este script as-is pasando directamente al motor de automatización de PowerShell. En realidad, no se crea ningún script de PowerShell en disco. Como alternativa, puede ejecutar un script de PowerShell existente en el disco; para ello, escriba lo siguiente: return & 'scriptpath'. Por ejemplo: return & 'c:\scripts\AzureADTestScript.ps1'.

No se produce ningún error
IsNoResultAnError boolean

Si el comando de PowerShell no devuelve ningún dato, ¿esto sugiere un error?

Devolver tipos complejos
ReturnComplexTypes boolean

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Las entradas "Properties to return as collection", "Property names to serialize" (Nombres de propiedad para serializar) y "Property types to serialize" (Tipos de propiedad para serializar) permiten especificar qué propiedades "complejas" se deben devolver y el método utilizado para dar formato a los datos (en una base de propiedad por propiedad, elija el que mejor funciona). Esta entrada le permite especificar lo que se debe hacer con las propiedades restantes (es decir, propiedades que son "complejas" y no se denominan explícitamente). Si se establece en true, IA-Connect intentará devolver una representación de cadena de los datos mediante ToString(). Si se establece en false (valor predeterminado), IA-Connect no devolverá la propiedad .

Devolver un valor booleano como booleano
ReturnBooleanAsBoolean boolean

¿Deben devolverse propiedades booleanas como booleanos? Si es false, se devuelven como cadenas.

Devolver numérico como decimal
ReturnNumericAsDecimal boolean

¿Deben devolverse propiedades numéricas como numéricos? Si es false, se devuelven como cadenas.

Fecha de devolución como fecha
ReturnDateAsDate boolean

¿Deben devolverse las propiedades Date como fechas? Si es false, se devuelven como cadenas.

Propiedades que se van a devolver como colección
PropertiesToReturnAsCollectionJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por nombre) IA-Connect deben intentar devolver como una colección. En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Nombres de propiedad para serializar" y "Tipos de propiedad para serializar" (elija uno). Esta entrada se puede escribir en formato JSON o CSV. Por ejemplo: Para devolver las propiedades de matriz EmailAddresses y MemberOf, escriba [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (formato de tabla JSON), ["EmailAddresses", "MemberOf"] (formato de matriz JSON) o EmailAddresses,MemberOf (formato CSV).

Ejecutar script como subproceso
RunScriptAsThread boolean

Si se establece en false (valor predeterminado), el agente de IA-Connect ejecutará el script de PowerShell inmediatamente y devolverá los resultados al director cuando se complete el script. Si ejecuta un script de PowerShell largo o complejo, esta acción puede agotar el tiempo de espera. Si se establece en true, el agente de IA-Connect ejecutará el script de PowerShell como un subproceso del agente y el IA-Connect Director (o Orquestador, módulo de PowerShell, Blue Prism) puede supervisar el estado de este subproceso del Agente, esperando a que se complete. Esto permite que los scripts de PowerShell largos o complejos se ejecuten sin tiempos de espera. IA-Connect Agents 9.3 y versiones anteriores no pueden ejecutar scripts de PowerShell como subproceso del agente.

Recuperación de datos de salida para el identificador de subproceso
RetrieveOutputDataFromThreadId integer

Si anteriormente ejecutó un script de PowerShell como subproceso del Agente y estableció "Segundos para esperar el subproceso" en 0, proporcione el identificador del subproceso del agente para recuperar los resultados. La llamada anterior a esta acción proporcionará este identificador de subproceso del agente. Establezca en 0 (valor predeterminado) si simplemente ejecuta un script de PowerShell (y, por lo tanto, no recupera los resultados de un script de PowerShell anterior se ejecuta como un subproceso del Agente).

Segundos para esperar el subproceso
SecondsToWaitForThread integer

Si "Ejecutar script como subproceso" se establece en true, cuántos segundos esperarán a que se complete el subproceso del Agente. Si el subproceso del agente que ejecuta el script de PowerShell no se ha completado en este momento, se producirá una excepción. Establezca en 0 para omitir la espera: el agente seguirá ejecutando el script de PowerShell, pero también estará disponible para la siguiente acción. A continuación, puede recuperar los resultados del script más adelante mediante la acción "Esperar a que el subproceso del Agente se complete correctamente" para esperar a que se complete el subproceso del agente y, a continuación, volver a ejecutar esta acción "Ejecutar script de PowerShell" con la entrada "Recuperar datos de salida para el identificador de subproceso" establecido en el identificador del subproceso del agente.

El script contiene la contraseña almacenada
ScriptContainsStoredPassword boolean

Se establece en true si el script contiene un identificador de contraseña almacenado IA-Connect, con el formato {IAConnectPassword:StoredPasswordIdentifier} o una credencial genérica de IA-Connect Orchestrator, con el formato {OrchestratorCredential:FriendlyName}. La frase { } se reemplazará por la contraseña especificada, se escapará y colocará entre comillas simples (a menos que ya esté entre comillas en el script).

Salida detallada del registro
LogVerboseOutput boolean

Establézcalo en true para registrar cualquier salida detallada de PowerShell en los registros de IA-Connect. Esto podría ser útil para la depuración. Para registrar detalladamente en el script, use el siguiente PowerShell: Write-Verbose "Mi mensaje" -Verbose.

Nombres de propiedad para serializar
PropertyNamesToSerializeJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por nombre) IA-Connect deben serializarse como JSON, por lo que se devuelven como un tipo de cadena (que puede deserializar, una vez recibido). En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Propiedades para devolver como colección" y "Tipos de propiedad para serializar" (elija uno). Por ejemplo: Para serializar las propiedades EmailAddresses y MemberOf, escriba [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (formato de tabla JSON), ["EmailAddresses", "MemberOf"] (formato de matriz JSON) o EmailAddresses,MemberOf (formato CSV).

Tipos de propiedad para serializar
PropertyTypesToSerializeJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por tipo) IA-Connect deben serializarse como JSON, por lo que se devuelven como un tipo de cadena (que puede deserializar, una vez recibido). En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Propiedades para devolver como colección" y "Nombres de propiedad para serializar" (elija uno). Esta entrada es una colección con un único campo 'PropertyType'. Por ejemplo: Para serializar cualquier propiedad de tipo Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[], escriba [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] (formato de tabla JSON), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (formato de matriz JSON) o "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (formato CSV).

Nombre
Name string

Nombre del parámetro de PowerShell de entrada. Debe cumplir los formatos de nomenclatura de variables de PowerShell (es decir, se recomienda evitar espacios o símbolos especiales). Los nombres de variables de PowerShell no distinguen mayúsculas de minúsculas. Por ejemplo: MyVariable daría lugar a que se creara una variable $MyVariable.

Valor de cadena
StringValue string

Valor de cadena que se va a asignar al parámetro de PowerShell de entrada. Como alternativa, use de las otras entradas de valor si está especificando un valor booleano o numérico.

Valor entero
IntValue integer

Valor entero (número entero) que se va a asignar al parámetro de PowerShell de entrada. También puede usar las demás entradas de valor si está especificando una cadena, un valor booleano o numérico.

Valor booleano
BooleanValue boolean

Valor booleano (true o false) que se va a asignar al parámetro de PowerShell de entrada. Como alternativa, use de las otras entradas de valor si está especificando una cadena o un valor numérico.

Valor decimal
DecimalValue double

Valor decimal que se va a asignar al parámetro de PowerShell de entrada. También puede usar de las otras entradas de valor si está especificando una cadena, un valor booleano o entero.

Valor del objeto
ObjectValue object

Valor de objeto que se va a asignar al parámetro de PowerShell de entrada. Se convertirá en una variable de cadena serializada JSON en el script de PowerShell, por lo que se deserializará en un objeto mediante ConvertFrom-Json. También puede usar las demás entradas de valor si está especificando una cadena, un valor booleano o numérico.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de salida de PowerShell
PowerShellJSONOutput string

Salida del script de PowerShell, con formato JSON.

Identificador de subproceso
ThreadId integer

Si el script de PowerShell se ejecuta como un subproceso del Agente, esta salida contendrá el identificador del subproceso del agente que se puede usar para supervisar la ejecución del script de PowerShell y recuperar los resultados del script de PowerShell cuando se haya completado el script.

Ejecución del script de PowerShell de Exchange

Ejecuta un script de PowerShell en el espacio de ejecución de Exchange en la sesión en la que se ejecuta el agente de IA-Connect, donde el contenido del script se pasa al agente de IA-Connect como parte del comando. Esta es la acción recomendada para ejecutar su propio código personalizado de PowerShell de Exchange. Esta acción también se puede usar para recuperar los resultados de una ejecución anterior de un script de PowerShell, que se ejecuta como un subproceso del Agente.

Parámetros

Nombre Clave Requerido Tipo Description
Contenido del script de PowerShell
PowerShellScriptContents string

Contenido del script de PowerShell que se va a ejecutar en el espacio de ejecución de Exchange. IA-Connect ejecutará este script as-is pasando directamente al motor de automatización de PowerShell. En realidad, no se crea ningún script de PowerShell en disco. Como alternativa, puede ejecutar un script de PowerShell existente en el disco; para ello, escriba lo siguiente: return & 'scriptpath'. Por ejemplo: return & 'c:\scripts\ExchangeTestScript.ps1'.

No se produce ningún error
IsNoResultAnError boolean

Si el comando de PowerShell no devuelve ningún dato, ¿esto sugiere un error?

Devolver tipos complejos
ReturnComplexTypes boolean

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Las entradas "Properties to return as collection", "Property names to serialize" (Nombres de propiedad para serializar) y "Property types to serialize" (Tipos de propiedad para serializar) permiten especificar qué propiedades "complejas" se deben devolver y el método utilizado para dar formato a los datos (en una base de propiedad por propiedad, elija el que mejor funciona). Esta entrada le permite especificar lo que se debe hacer con las propiedades restantes (es decir, propiedades que son "complejas" y no se denominan explícitamente). Si se establece en true, IA-Connect intentará devolver una representación de cadena de los datos mediante ToString(). Si se establece en false (valor predeterminado), IA-Connect no devolverá la propiedad .

Devolver un valor booleano como booleano
ReturnBooleanAsBoolean boolean

¿Deben devolverse propiedades booleanas como booleanos? Si es false, se devuelven como cadenas.

Devolver numérico como decimal
ReturnNumericAsDecimal boolean

¿Deben devolverse propiedades numéricas como numéricos? Si es false, se devuelven como cadenas.

Fecha de devolución como fecha
ReturnDateAsDate boolean

¿Deben devolverse las propiedades Date como fechas? Si es false, se devuelven como cadenas.

Propiedades que se van a devolver como colección
PropertiesToReturnAsCollectionJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por nombre) IA-Connect deben intentar devolver como una colección. En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Nombres de propiedad para serializar" y "Tipos de propiedad para serializar" (elija uno). Esta entrada se puede escribir en formato JSON o CSV. Por ejemplo: Para devolver las propiedades de matriz EmailAddresses y MemberOf, escriba [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (formato de tabla JSON), ["EmailAddresses", "MemberOf"] (formato de matriz JSON) o EmailAddresses,MemberOf (formato CSV).

Ejecutar script como subproceso
RunScriptAsThread boolean

Si se establece en false (valor predeterminado), el agente de IA-Connect ejecutará el script de PowerShell inmediatamente y devolverá los resultados al director cuando se complete el script. Si ejecuta un script de PowerShell largo o complejo, esta acción puede agotar el tiempo de espera. Si se establece en true, el agente de IA-Connect ejecutará el script de PowerShell como un subproceso del agente y el IA-Connect Director (o Orquestador, módulo de PowerShell, Blue Prism) puede supervisar el estado de este subproceso del Agente, esperando a que se complete. Esto permite que los scripts de PowerShell largos o complejos se ejecuten sin tiempos de espera. IA-Connect Agents 9.3 y versiones anteriores no pueden ejecutar scripts de PowerShell como subproceso del agente.

Recuperación de datos de salida para el identificador de subproceso
RetrieveOutputDataFromThreadId integer

Si anteriormente ejecutó un script de PowerShell como subproceso del Agente y estableció "Segundos para esperar el subproceso" en 0, proporcione el identificador del subproceso del agente para recuperar los resultados. La llamada anterior a esta acción proporcionará este identificador de subproceso del agente. Establezca en 0 (valor predeterminado) si simplemente ejecuta un script de PowerShell (y, por lo tanto, no recupera los resultados de un script de PowerShell anterior se ejecuta como un subproceso del Agente).

Segundos para esperar el subproceso
SecondsToWaitForThread integer

Si "Ejecutar script como subproceso" se establece en true, cuántos segundos esperarán a que se complete el subproceso del Agente. Si el subproceso del agente que ejecuta el script de PowerShell no se ha completado en este momento, se producirá una excepción. Establezca en 0 para omitir la espera: el agente seguirá ejecutando el script de PowerShell, pero también estará disponible para la siguiente acción. A continuación, puede recuperar los resultados del script más adelante mediante la acción "Esperar a que el subproceso del Agente se complete correctamente" para esperar a que se complete el subproceso del agente y, a continuación, volver a ejecutar esta acción "Ejecutar script de PowerShell" con la entrada "Recuperar datos de salida para el identificador de subproceso" establecido en el identificador del subproceso del agente.

El script contiene la contraseña almacenada
ScriptContainsStoredPassword boolean

Se establece en true si el script contiene un identificador de contraseña almacenado IA-Connect, con el formato {IAConnectPassword:StoredPasswordIdentifier} o una credencial genérica de IA-Connect Orchestrator, con el formato {OrchestratorCredential:FriendlyName}. La frase { } se reemplazará por la contraseña especificada, se escapará y colocará entre comillas simples (a menos que ya esté entre comillas en el script).

Salida detallada del registro
LogVerboseOutput boolean

Establézcalo en true para registrar cualquier salida detallada de PowerShell en los registros de IA-Connect. Esto podría ser útil para la depuración. Para registrar detalladamente en el script, use el siguiente PowerShell: Write-Verbose "Mi mensaje" -Verbose.

Nombres de propiedad para serializar
PropertyNamesToSerializeJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por nombre) IA-Connect deben serializarse como JSON, por lo que se devuelven como un tipo de cadena (que puede deserializar, una vez recibido). En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Propiedades para devolver como colección" y "Tipos de propiedad para serializar" (elija uno). Por ejemplo: Para serializar las propiedades EmailAddresses y MemberOf, escriba [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (formato de tabla JSON), ["EmailAddresses", "MemberOf"] (formato de matriz JSON) o EmailAddresses,MemberOf (formato CSV).

Tipos de propiedad para serializar
PropertyTypesToSerializeJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por tipo) IA-Connect deben serializarse como JSON, por lo que se devuelven como un tipo de cadena (que puede deserializar, una vez recibido). En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Propiedades para devolver como colección" y "Nombres de propiedad para serializar" (elija uno). Esta entrada es una colección con un único campo 'PropertyType'. Por ejemplo: Para serializar cualquier propiedad de tipo Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[], escriba [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] (formato de tabla JSON), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (formato de matriz JSON) o "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (formato CSV).

Nombre
Name string

Nombre del parámetro de PowerShell de entrada. Debe cumplir los formatos de nomenclatura de variables de PowerShell (es decir, se recomienda evitar espacios o símbolos especiales). Los nombres de variables de PowerShell no distinguen mayúsculas de minúsculas. Por ejemplo: MyVariable daría lugar a que se creara una variable $MyVariable.

Valor de cadena
StringValue string

Valor de cadena que se va a asignar al parámetro de PowerShell de entrada. Como alternativa, use de las otras entradas de valor si está especificando un valor booleano o numérico.

Valor entero
IntValue integer

Valor entero (número entero) que se va a asignar al parámetro de PowerShell de entrada. También puede usar las demás entradas de valor si está especificando una cadena, un valor booleano o numérico.

Valor booleano
BooleanValue boolean

Valor booleano (true o false) que se va a asignar al parámetro de PowerShell de entrada. Como alternativa, use de las otras entradas de valor si está especificando una cadena o un valor numérico.

Valor decimal
DecimalValue double

Valor decimal que se va a asignar al parámetro de PowerShell de entrada. También puede usar de las otras entradas de valor si está especificando una cadena, un valor booleano o entero.

Valor del objeto
ObjectValue object

Valor de objeto que se va a asignar al parámetro de PowerShell de entrada. Se convertirá en una variable de cadena serializada JSON en el script de PowerShell, por lo que se deserializará en un objeto mediante ConvertFrom-Json. También puede usar las demás entradas de valor si está especificando una cadena, un valor booleano o numérico.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de salida de PowerShell
PowerShellJSONOutput string

Salida del script de PowerShell, con formato JSON.

Identificador de subproceso
ThreadId integer

Si el script de PowerShell se ejecuta como un subproceso del Agente, esta salida contendrá el identificador del subproceso del agente que se puede usar para supervisar la ejecución del script de PowerShell y recuperar los resultados del script de PowerShell cuando se haya completado el script.

Ejecutar script de PowerShell de Office 365

Ejecuta un script de PowerShell en el espacio de ejecución de Office 365 en la sesión donde se ejecuta el agente de IA-Connect, donde el contenido del script se pasa al agente de IA-Connect como parte del comando. Esta es la acción recomendada para ejecutar su propio código personalizado de PowerShell de Office 365 Exchange Online. Esta acción también se puede usar para recuperar los resultados de una ejecución anterior de un script de PowerShell, que se ejecuta como un subproceso del Agente.

Parámetros

Nombre Clave Requerido Tipo Description
Contenido del script de PowerShell
PowerShellScriptContents string

Contenido del script de PowerShell que se va a ejecutar en el espacio de ejecución de Office 365. IA-Connect ejecutará este script as-is pasando directamente al motor de automatización de PowerShell. En realidad, no se crea ningún script de PowerShell en disco. Como alternativa, puede ejecutar un script de PowerShell existente en el disco; para ello, escriba lo siguiente: return & 'scriptpath'. Por ejemplo: return & 'c:\scripts\O365TestScript.ps1'.

No se produce ningún error
IsNoResultAnError boolean

Si el comando de PowerShell no devuelve ningún dato, ¿esto sugiere un error?

Devolver tipos complejos
ReturnComplexTypes boolean

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Las entradas "Properties to return as collection", "Property names to serialize" (Nombres de propiedad para serializar) y "Property types to serialize" (Tipos de propiedad para serializar) permiten especificar qué propiedades "complejas" se deben devolver y el método utilizado para dar formato a los datos (en una base de propiedad por propiedad, elija el que mejor funciona). Esta entrada le permite especificar lo que se debe hacer con las propiedades restantes (es decir, propiedades que son "complejas" y no se denominan explícitamente). Si se establece en true, IA-Connect intentará devolver una representación de cadena de los datos mediante ToString(). Si se establece en false (valor predeterminado), IA-Connect no devolverá la propiedad .

Devolver un valor booleano como booleano
ReturnBooleanAsBoolean boolean

¿Deben devolverse propiedades booleanas como booleanos? Si es false, se devuelven como cadenas.

Devolver numérico como decimal
ReturnNumericAsDecimal boolean

¿Deben devolverse propiedades numéricas como numéricos? Si es false, se devuelven como cadenas.

Fecha de devolución como fecha
ReturnDateAsDate boolean

¿Deben devolverse las propiedades Date como fechas? Si es false, se devuelven como cadenas.

Propiedades que se van a devolver como colección
PropertiesToReturnAsCollectionJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por nombre) IA-Connect deben intentar devolver como una colección. En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Nombres de propiedad para serializar" y "Tipos de propiedad para serializar" (elija uno). Esta entrada se puede escribir en formato JSON o CSV. Por ejemplo: Para devolver las propiedades de matriz EmailAddresses y MemberOf, escriba [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (formato de tabla JSON), ["EmailAddresses", "MemberOf"] (formato de matriz JSON) o EmailAddresses,MemberOf (formato CSV).

Ámbito local de PowerShell
LocalScope boolean

Debe ejecutarse el comando subyacente de PowerShell de Office 365 en el ámbito local. De forma predeterminada, esto no se establece y, por tanto, PowerShell vuelve a los valores predeterminados.

Ejecutar script como subproceso
RunScriptAsThread boolean

Si se establece en false (valor predeterminado), el agente de IA-Connect ejecutará el script de PowerShell inmediatamente y devolverá los resultados al director cuando se complete el script. Si ejecuta un script de PowerShell largo o complejo, esta acción puede agotar el tiempo de espera. Si se establece en true, el agente de IA-Connect ejecutará el script de PowerShell como un subproceso del agente y el IA-Connect Director (o Orquestador, módulo de PowerShell, Blue Prism) puede supervisar el estado de este subproceso del Agente, esperando a que se complete. Esto permite que los scripts de PowerShell largos o complejos se ejecuten sin tiempos de espera. IA-Connect Agents 9.3 y versiones anteriores no pueden ejecutar scripts de PowerShell como subproceso del agente.

Recuperación de datos de salida para el identificador de subproceso
RetrieveOutputDataFromThreadId integer

Si anteriormente ejecutó un script de PowerShell como subproceso del Agente y estableció "Segundos para esperar el subproceso" en 0, proporcione el identificador del subproceso del agente para recuperar los resultados. La llamada anterior a esta acción proporcionará este identificador de subproceso del agente. Establezca en 0 (valor predeterminado) si simplemente ejecuta un script de PowerShell (y, por lo tanto, no recupera los resultados de un script de PowerShell anterior se ejecuta como un subproceso del Agente).

Segundos para esperar el subproceso
SecondsToWaitForThread integer

Si "Ejecutar script como subproceso" se establece en true, cuántos segundos esperarán a que se complete el subproceso del Agente. Si el subproceso del agente que ejecuta el script de PowerShell no se ha completado en este momento, se producirá una excepción. Establezca en 0 para omitir la espera: el agente seguirá ejecutando el script de PowerShell, pero también estará disponible para la siguiente acción. A continuación, puede recuperar los resultados del script más adelante mediante la acción "Esperar a que el subproceso del Agente se complete correctamente" para esperar a que se complete el subproceso del agente y, a continuación, volver a ejecutar esta acción "Ejecutar script de PowerShell" con la entrada "Recuperar datos de salida para el identificador de subproceso" establecido en el identificador del subproceso del agente.

El script contiene la contraseña almacenada
ScriptContainsStoredPassword boolean

Se establece en true si el script contiene un identificador de contraseña almacenado IA-Connect, con el formato {IAConnectPassword:StoredPasswordIdentifier} o una credencial genérica de IA-Connect Orchestrator, con el formato {OrchestratorCredential:FriendlyName}. La frase { } se reemplazará por la contraseña especificada, se escapará y colocará entre comillas simples (a menos que ya esté entre comillas en el script).

Salida detallada del registro
LogVerboseOutput boolean

Establézcalo en true para registrar cualquier salida detallada de PowerShell en los registros de IA-Connect. Esto podría ser útil para la depuración. Para registrar detalladamente en el script, use el siguiente PowerShell: Write-Verbose "Mi mensaje" -Verbose.

Nombres de propiedad para serializar
PropertyNamesToSerializeJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por nombre) IA-Connect deben serializarse como JSON, por lo que se devuelven como un tipo de cadena (que puede deserializar, una vez recibido). En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Propiedades para devolver como colección" y "Tipos de propiedad para serializar" (elija uno). Por ejemplo: Para serializar las propiedades EmailAddresses y MemberOf, escriba [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (formato de tabla JSON), ["EmailAddresses", "MemberOf"] (formato de matriz JSON) o EmailAddresses,MemberOf (formato CSV).

Tipos de propiedad para serializar
PropertyTypesToSerializeJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por tipo) IA-Connect deben serializarse como JSON, por lo que se devuelven como un tipo de cadena (que puede deserializar, una vez recibido). En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Propiedades para devolver como colección" y "Nombres de propiedad para serializar" (elija uno). Esta entrada es una colección con un único campo 'PropertyType'. Por ejemplo: Para serializar cualquier propiedad de tipo Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[], escriba [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] (formato de tabla JSON), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (formato de matriz JSON) o "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (formato CSV).

Nombre
Name string

Nombre del parámetro de PowerShell de entrada. Debe cumplir los formatos de nomenclatura de variables de PowerShell (es decir, se recomienda evitar espacios o símbolos especiales). Los nombres de variables de PowerShell no distinguen mayúsculas de minúsculas. Por ejemplo: MyVariable daría lugar a que se creara una variable $MyVariable.

Valor de cadena
StringValue string

Valor de cadena que se va a asignar al parámetro de PowerShell de entrada. Como alternativa, use de las otras entradas de valor si está especificando un valor booleano o numérico.

Valor entero
IntValue integer

Valor entero (número entero) que se va a asignar al parámetro de PowerShell de entrada. También puede usar las demás entradas de valor si está especificando una cadena, un valor booleano o numérico.

Valor booleano
BooleanValue boolean

Valor booleano (true o false) que se va a asignar al parámetro de PowerShell de entrada. Como alternativa, use de las otras entradas de valor si está especificando una cadena o un valor numérico.

Valor decimal
DecimalValue double

Valor decimal que se va a asignar al parámetro de PowerShell de entrada. También puede usar de las otras entradas de valor si está especificando una cadena, un valor booleano o entero.

Valor del objeto
ObjectValue object

Valor de objeto que se va a asignar al parámetro de PowerShell de entrada. Se convertirá en una variable de cadena serializada JSON en el script de PowerShell, por lo que se deserializará en un objeto mediante ConvertFrom-Json. También puede usar las demás entradas de valor si está especificando una cadena, un valor booleano o numérico.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de salida de PowerShell
PowerShellJSONOutput string

Salida del script de PowerShell, con formato JSON.

Identificador de subproceso
ThreadId integer

Si el script de PowerShell se ejecuta como un subproceso del Agente, esta salida contendrá el identificador del subproceso del agente que se puede usar para supervisar la ejecución del script de PowerShell y recuperar los resultados del script de PowerShell cuando se haya completado el script.

Eliminación de la seguridad de Azure AD o del grupo de Microsoft 365

Quite un grupo de seguridad de Azure Active Directory o un grupo de Microsoft 365. Esta acción no puede quitar grupos de seguridad habilitados para correo o listas de distribución: use la acción "Quitar grupo de distribución de Office 365" en su lugar. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de objeto de grupo o nombre para mostrar
GroupObjectId True string

Identificador o nombre para mostrar de un grupo de Azure Active Directory. Puede especificar un grupo por Nombre para mostrar (por ejemplo, "Usuarios financieros") o ObjectId (por ejemplo, UUID/valor GUID).

Excepción si el grupo no existe
ErrorIfGroupDoesNotExist boolean

¿Debería producirse una excepción si el grupo no existe? Establézcalo en false para no hacer nada si el grupo no existe (por ejemplo, es posible que ya se haya eliminado). Se establece en true si el grupo no existente es un error (es decir, se esperaba que exista).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
El grupo existía
GroupExisted boolean

Si el grupo existía y se eliminó, se establecerá en true. Si el grupo no existe (y "Error si el grupo no existe" se estableció en false, por lo que no se generó ninguna excepción), se establecerá en false para informarle de que el grupo no existía y, por lo tanto, IA-Connect no tenía que realizar ninguna acción.

Eliminación de la unidad organizativa de Active Directory

Quita una unidad organizativa (OU) de Active Directory. La unidad organizativa no se puede eliminar si hay objetos (por ejemplo, usuarios, grupos o equipos) en la unidad organizativa.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de unidad organizativa
OUIdentity True string

Identidad de la unidad organizativa de Active Directory. Puede especificar una unidad organizativa por nombre distintivo (por ejemplo, OU=Servers,OU=London,DC=mydomain,DC=local), formato GUID o como ruta de acceso (por ejemplo, London\Servers).

Eliminar incluso si está protegido
DeleteEvenIfProtected boolean

Establézcalo en true para eliminar la unidad organizativa, incluso si está protegida frente a la eliminación. Establézcalo en false para eliminar solo la unidad organizativa si no está protegida contra la eliminación y genera una excepción si la unidad organizativa está protegida.

Se produce una excepción si la unidad organizativa no existe
RaiseExceptionIfOUDoesNotExist boolean

Si se establece en true y la unidad organizativa no existe, se generará una excepción. Si se establece en false y la unidad organizativa no existe, la acción notificará que se ha realizado correctamente, pero la salida notificará que no se eliminaron unidades organizativas.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Número de unidades organizativas eliminadas
NumberOfOUsDeleted integer

Esta salida contendrá el número de unidades organizativas de AD eliminadas que deben ser 0 o 1.

Eliminación de todas las licencias de usuario de Azure AD

Quita todas las licencias de usuario (SKU) de Azure AD asignadas a un usuario. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
ObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
AzureADv2RemoveAllAzureADUserLicenseResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Eliminación del objeto de Active Directory de varios grupos

Quita un objeto de Active Directory (normalmente un usuario, grupo o equipo) de varios grupos de Active Directory existentes. IA-Connect quita el objeto de tantos grupos como sea posible e informa sobre el resultado. Si el objeto no es miembro de uno o varios de los grupos especificados, se cuenta como correcto.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de objeto
UserIdentity True string

Objeto (normalmente un usuario, grupo o equipo) que se va a quitar de uno o varios grupos. Puede especificar un usuario o grupo por Nombre distintivo (por ejemplo, CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID o SAMAccountName/pre-2K (por ejemplo, "User1"). Puede especificar un equipo por Nombre distintivo o nombre de equipo (antes de 2K) seguido de $ (por ejemplo, VM01$).

Grupos de AD que se van a quitar
GroupNamesJSON string

Lista de los grupos de AD de los que se va a quitar el objeto, en formato JSON o CSV. Por ejemplo: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (formato de tabla JSON), ["Group 1", "Group 2"] (formato de matriz JSON) o Group 1,Group 2 (formato CSV). Puede especificar un usuario o grupo por Nombre distintivo (por ejemplo, CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID o SAMAccountName/pre-2K (por ejemplo, "User1"). Puede especificar un equipo por Nombre distintivo o nombre de equipo (antes de 2K) seguido de $ (por ejemplo, VM01$).

Excepción si se produce un error en la eliminación de algún grupo
ExceptionIfAnyGroupsFailToRemove boolean

Si se establece en true: se generará una excepción (error) si un único grupo no puede quitar (es decir, 100% correcto es un requisito). Si no se produce ninguna excepción, esta acción notificará cuántos grupos se quitaron correctamente y cuántos no se pudieron quitar.

Excepción si todos los grupos no pueden quitar
ExceptionIfAllGroupsFailToRemove boolean

Si se establece en true: solo se generará una excepción (error) si todos los grupos no se pueden quitar (es decir, sin éxitos y algunos errores). Si no se produce ninguna excepción, esta acción notificará cuántos grupos se quitaron correctamente y cuántos no se pudieron quitar.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Número máximo de grupos por llamada
MaxGroupsPerCall integer

Si se especifica un gran número de grupos de AD para la eliminación, esto puede provocar un tiempo de espera. Al establecer el valor "Grupos máximos por llamada" en 1 o superior, el IA-Connect Orchestrator dividirá esta acción en varias llamadas al director de IA-Connect y al agente con el número máximo especificado de grupos por llamada. Primero disponible en IA-Connect 9.3. Por ejemplo: si establece un valor de 5 y 14 grupos se solicitan para su eliminación, Orchestrator lo dividirá en solicitudes de 5, 5, 4.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Los grupos de AD se quitaron correctamente
ADGroupsRemovedSuccessfully integer

Número de grupos de AD del que se quitó correctamente el objeto.

Los grupos de AD no se pudieron quitar
ADGroupsFailedToRemove integer

Número de grupos de AD de los que no se pudo quitar el objeto.

Mensaje de error Quitar grupos de AD
RemoveADGroupsMasterErrorMessage string

Si el objeto no se pudo quitar de algunos de los grupos de AD y no se generó ninguna excepción, este mensaje de error proporciona detalles del problema.

Eliminación del permiso de buzón de Microsoft Exchange del usuario

Quite los permisos de buzón de un usuario de buzón, usuario o grupo de seguridad especificados.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Microsoft Exchange. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Usuario
User True string

Usuario que se va a quitar de los permisos del buzón. Puede especificar un usuario por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Derechos de acceso
AccessRights True string

Derechos de acceso que se van a quitar de los permisos del usuario en el buzón. Las opciones disponibles son "ChangeOwner", "ChangePermission", "DeleteItem", "ExternalAccount", "FullAccess" y "ReadPermission". Para quitar varios permisos, especifíquelos como una lista separada por comas.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ExchangeRemoveMailboxPermissionResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Eliminación del usuario de Active Directory

Quita un usuario de Active Directory.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity True string

Identidad del usuario de Active Directory. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Eliminación de la protección frente a la eliminación accidental
RemoveProtectionFromAccidentalDeletion boolean

Establézcalo en true para intentar quitar la protección de la eliminación accidental, antes de intentar quitar el usuario.

Quitar incluso si el usuario tiene sub objetos
DeleteEvenIfUserHasSubObjects boolean

Si una cuenta de usuario tiene subobjetos (es decir, el usuario no es un objeto hoja), se producirá un error en el comando normal para quitar el usuario. Establezca esta entrada en true si desea revertir a un método de eliminación alternativo si se detectan subobjementos.

Forzar eliminación recursiva
ForceDeleteRecursive boolean

Si una cuenta de usuario tiene subobjetos (es decir, el usuario no es un objeto hoja), se producirá un error en el comando normal para quitar el usuario. Establezca esta entrada en true si desea realizar una eliminación de subobjetos recursivos, sin intentar quitar el usuario normalmente. Esto podría ser útil si la detección de reserva no funciona.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectoryRemoveADUserByIdentityResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Eliminación del usuario de Active Directory de todos los grupos

Quita un usuario de Active Directory de todos los grupos de Active Directory de los que son miembros. IA-Connect quita al usuario de tantos grupos como sea posible e informa sobre el resultado. Esta acción solo funciona con cuentas de usuario, no puede usar esta acción para quitar una pertenencia a grupos o equipos.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity string

Usuario que se va a quitar de todos los grupos. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Grupos de AD que se van a excluir
GroupsToExcludeJSON string

Lista de grupos de AD que se van a excluir de la eliminación, en formato JSON o CSV. Por ejemplo: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (formato de tabla JSON), ["Group 1", "Group 2"] (formato de matriz JSON) o Group 1,Group 2 (formato CSV). Puede especificar un usuario o grupo por Nombre distintivo (por ejemplo, CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID o SAMAccountName/pre-2K (por ejemplo, "User1"). Puede especificar un equipo por Nombre distintivo o nombre de equipo (antes de 2K) seguido de $ (por ejemplo, VM01$).

Excepción si no existe un grupo excluido
ExceptionIfExcludedGroupDoesNotExist boolean

Si se establece en true: se generará una excepción (error) si uno de los grupos excluidos no existe (IA-Connect tiene que buscar el grupo para obtener el DN del grupo). Si se establece en false (valor predeterminado): si no existe un grupo excluido, se omitirá, ya que el usuario no puede ser posiblemente miembro de ese grupo.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Ejecutar como subproceso
RunAsThread boolean

Si se establece en false, el agente de IA-Connect ejecutará la acción inmediatamente y devolverá los resultados cuando se complete la acción, pero producirá un error si tarda más tiempo de espera del comando de trabajo o RPA. Si se establece en true, el agente de IA-Connect ejecutará esta acción como subproceso del agente y la supervisará hasta que se complete. Esto permite que la acción se ejecute durante más tiempo que el tiempo de espera del comando worker/RPA.

Recuperación de datos de salida para el identificador de subproceso
RetrieveOutputDataFromThreadId integer

Si anteriormente ejecutó esta acción como un subproceso del Agente y estableció "Segundos para esperar el subproceso" en 0, proporcione el identificador del subproceso del agente para recuperar los resultados. La llamada anterior a esta acción proporcionará este identificador de subproceso del agente. Establezca en 0 (valor predeterminado) si simplemente ejecuta esta acción (y, por tanto, no recupera los resultados de una instancia anterior de esta acción se ejecuta como un subproceso del Agente).

Segundos para esperar el subproceso
SecondsToWaitForThread integer

Si "Ejecutar como subproceso" se establece en true, cuántos segundos se esperarán a que se complete el subproceso del agente. Si el subproceso del Agente que ejecuta esta acción no se ha completado en este momento, se producirá una excepción. Establézcalo en 0 para omitir la espera: el agente seguirá ejecutando la acción, pero también estará disponible para la siguiente acción. A continuación, puede recuperar los resultados de la acción más adelante mediante la acción "Esperar a que el subproceso del Agente se complete correctamente" para esperar a que se complete el subproceso del agente y, a continuación, vuelva a ejecutar esta acción "Quitar usuario de Active Directory de todos los grupos" con la entrada "Recuperar datos de salida para el identificador de subproceso" establecido en el identificador del subproceso del agente.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Los grupos de AD se quitaron correctamente
ADGroupsRemovedSuccessfully integer

Número de grupos de AD del que el usuario se quitó correctamente.

Los grupos de AD no se pudieron quitar
ADGroupsFailedToRemove integer

Número de grupos de AD de los que el usuario no pudo quitar.

Grupos de AD excluidos de la eliminación
ADGroupsExcludedFromRemoval integer

Número de grupos de AD excluidos de la eliminación.

Mensaje de error Quitar grupos de AD
RemoveADGroupsMasterErrorMessage string

Si el usuario no pudo quitar de algunos de los grupos de AD, este mensaje de error proporciona detalles del problema.

Identificador de subproceso
ThreadId integer

Si esta acción se ejecuta como un subproceso del Agente, esta salida contendrá el identificador del subproceso del agente que se puede usar para supervisar la ejecución de la acción y recuperar los resultados cuando se haya completado la acción.

Eliminación del usuario de Azure AD

Quite un usuario de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
ObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Excepción si el usuario no existe
ErrorIfUserDoesNotExist boolean

¿Debería producirse una excepción si el usuario no existe? Establézcalo en false para simplemente no hacer nada si el usuario no existe (por ejemplo, es posible que ya se haya eliminado). Se establece en true si el usuario no existente es un error (es decir, se esperaba que exista).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
El usuario existía
UserExisted boolean

Si el usuario existía y se eliminó, se establecerá en true. Si el usuario no existe (y "Error si el usuario no existe" se estableció en false, por lo que no se generó ninguna excepción), se establecerá en false para informarle de que el usuario no existía y, por lo tanto, IA-Connect no tenía que realizar ninguna acción.

Eliminación del usuario de Azure AD de la asignación de roles de administrador

Quite un usuario de Azure Active Directory (u otro objeto) de una asignación de roles de administrador de Azure Active Directory existente. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
UserObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Id. de objeto de rol o nombre para mostrar
RoleObjectId True string

Identificador o nombre para mostrar de un rol de administrador de Azure Active Directory. Puede especificar un rol de administrador de AAD por Nombre para mostrar (por ejemplo, "Desarrollador de aplicaciones") o ObjectId (por ejemplo, UUID/VALOR GUID).

Id. de ámbito de directorio
DirectoryScopeId string

Identificador de ámbito de directorio opcional que debe coincidir la asignación de roles especificada para la eliminación. Por ejemplo: / representa todo el inquilino (y solo dará lugar a asignaciones de roles con nombre con un identificador de ámbito de directorio de / que se va a quitar), /GUID representa un registro de aplicación, /administrativeUnits/GUID representa una unidad administrativa. Si desea quitar una asignación de roles, independientemente del ámbito de directorio, especifique * o un valor en blanco.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Usuario quitado del rol
UserRemovedFromRole boolean

True si el usuario ha quitado del rol. False si el usuario no se asignó al rol (por lo que no había nada que hacer).

Eliminación del usuario de Azure AD de todas las asignaciones de roles de administrador

Quita un usuario de Azure Active Directory (u otro objeto) de todos los roles de administrador de Azure Active Directory a los que están asignados. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
UserObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Excepción si se produce un error en la eliminación de algún rol
ExceptionIfAnyRolesFailToRemove boolean

Si se establece en true: se generará una excepción (error) si no se puede quitar cualquier rol de administrador único (es decir, 100% correcto es un requisito). Si no se produce ninguna excepción, esta acción notificará cuántos roles se quitaron correctamente y cuántos no se pudieron quitar.

Excepción si no se pueden quitar todos los roles
ExceptionIfAllRolesFailToRemove boolean

Si se establece en true (valor predeterminado): se generará una excepción (error) si no se pudieron quitar todos los roles de administrador (es decir, sin éxitos y algunos errores). Si no se produce ninguna excepción, esta acción notificará cuántos roles se quitaron correctamente y cuántos no se pudieron quitar.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Roles de Azure AD eliminados correctamente
AzureADRolesRemovedSuccessfully integer

Número de roles de Azure AD del que el usuario se quitó correctamente.

No se pudieron quitar los roles de Azure AD
AzureADRolesFailedToRemove integer

Número de roles de Azure AD de los que el usuario no pudo quitar.

Eliminación del mensaje de error maestro de roles de Azure AD
RemoveAzureADRolesErrorMessage string

Si el usuario no pudo quitar de algunos de los roles de Azure AD y no se produjo ninguna excepción, este mensaje de error proporciona detalles del problema.

Eliminación del usuario de Azure AD de todos los grupos

Quita un usuario de Azure Active Directory de todos los grupos de Azure Active Directory de los que son miembros. Esta acción no puede modificar listas de distribución ni grupos de seguridad habilitados para correo: use las acciones de Office 365 Exchange Online en su lugar. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
UserObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Excepción si se produce un error en la eliminación de algún grupo
ExceptionIfAnyGroupsFailToRemove boolean

Si se establece en true: se generará una excepción (error) si un único grupo no puede quitar (es decir, 100% correcto es un requisito). Es posible que algunos grupos (por ejemplo: grupos de Office 365) no se quiten, por lo que podría ser común una excepción. Si no se produce ninguna excepción, esta acción notificará cuántos grupos se eliminaron correctamente y cuántos no se pudieron eliminar.

Excepción si todos los grupos no pueden quitar
ExceptionIfAllGroupsFailToRemove boolean

Si se establece en true: se generará una excepción (error) si todos los grupos no se pueden quitar (es decir, sin éxitos y algunos errores). Si no se produce ninguna excepción, esta acción notificará cuántos grupos se eliminaron correctamente y cuántos no se pudieron eliminar.

Número máximo de grupos de Azure AD por llamada
MaxAzureADGroupsPerCall integer

Si el usuario es miembro de un gran número de grupos de Azure AD, esto puede provocar un tiempo de espera. Al establecer el valor "Número máximo de grupos de Azure AD por llamada" en 1 o superior, el IA-Connect Orchestrator dividirá esta acción en varias llamadas al director y al agente de IA-Connect con el número máximo especificado de grupos por llamada. Por ejemplo: Si establece un valor de 5 y 14 grupos, el orquestador lo dividirá en solicitudes de 5, 5, 4.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Los grupos de Azure AD se quitaron correctamente
AzureADGroupsRemovedSuccessfully integer

Número de grupos de Azure AD del que el usuario se quitó correctamente.

Los grupos de Azure AD no se pudieron quitar
AzureADGroupsFailedToRemove integer

Número de grupos de Azure AD de los que el usuario no pudo quitar.

Eliminación del mensaje de error maestro de grupos de Azure AD
RemoveAzureADGroupsErrorMessage string

Si el usuario no pudo quitar de algunos de los grupos de Azure AD y no se generó ninguna excepción, este mensaje de error proporciona detalles del problema.

Eliminación del usuario de Azure AD de varios grupos

Quita un usuario de Azure Active Directory de varios grupos de Azure Active Directory existentes en los que los grupos se especifican mediante el identificador de objeto o el nombre para mostrar. IA-Connect quita al usuario de tantos grupos como sea posible e informa sobre el resultado. Esta acción no puede modificar listas de distribución ni grupos de seguridad habilitados para correo: use las acciones de Office 365 Exchange Online en su lugar. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
UserObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Grupos de Azure AD que se van a quitar
GroupNamesJSON string

Lista de identificadores o nombres para mostrar de grupos de Azure AD de los que se va a quitar el usuario, en formato JSON o CSV. Por ejemplo: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (formato de tabla JSON), ["Group 1", "Group 2"] (formato de matriz JSON) o Group 1,Group 2 (formato CSV).

Excepción si se produce un error en la eliminación de algún grupo
ExceptionIfAnyGroupsFailToRemove boolean

Si se establece en true: se generará una excepción (error) si un único grupo no puede quitar (es decir, 100% correcto es un requisito). Es posible que algunos grupos (por ejemplo: grupos de Office 365) no se quiten, por lo que podría ser común una excepción. Si no se produce ninguna excepción, esta acción notificará cuántos grupos se eliminaron correctamente y cuántos no se pudieron eliminar.

Excepción si todos los grupos no pueden quitar
ExceptionIfAllGroupsFailToRemove boolean

Si se establece en true: se generará una excepción (error) si todos los grupos no se pueden quitar (es decir, sin éxitos y algunos errores). Si no se produce ninguna excepción, esta acción notificará cuántos grupos se eliminaron correctamente y cuántos no se pudieron eliminar.

Comprobar primero las pertenencias a grupos de usuarios
CheckUserGroupMembershipsFirst boolean

Si se establece en true, IA-Connect comprobará las pertenencias a grupos del usuario antes de intentar quitarlas de cada grupo. Si el usuario no es miembro de un grupo determinado, IA-Connect simplemente notificará el éxito de ese grupo sin tener que hacer nada. Si se establece en false, IA-Connect quitará inmediatamente al usuario de cada grupo especificado sin comprobarlo, lo que producirá un error si el usuario no está en el grupo.

Número máximo de grupos de Azure AD por llamada
MaxAzureADGroupsPerCall integer

Si el usuario es miembro de un gran número de grupos de Azure AD, esto puede provocar un tiempo de espera. Al establecer el valor "Número máximo de grupos de Azure AD por llamada" en 1 o superior, el IA-Connect Orchestrator dividirá esta acción en varias llamadas al director y al agente de IA-Connect con el número máximo especificado de grupos por llamada. Por ejemplo: Si establece un valor de 5 y 14 grupos, el orquestador lo dividirá en solicitudes de 5, 5, 4.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Los grupos de Azure AD se quitaron correctamente
AzureADGroupsRemovedSuccessfully integer

Número de grupos de Azure AD del que el usuario se quitó correctamente.

Los grupos de Azure AD no se pudieron quitar
AzureADGroupsFailedToRemove integer

Número de grupos de Azure AD de los que el usuario no pudo quitar.

Eliminación del mensaje de error maestro de grupos de Azure AD
RemoveAzureADGroupsErrorMessage string

Si el usuario no pudo quitar de algunos de los grupos de Azure AD y no se generó ninguna excepción, este mensaje de error proporciona detalles del problema.

Eliminación del usuario de Azure AD de varios roles de administrador

Quita un usuario de Azure Active Directory (u otro objeto) de uno o varios roles de administrador de Azure Active Directory existentes. Esta acción recorre en iteración la lista de asignaciones de roles del usuario y quita los elementos coincidentes, por lo que si especifica roles no existentes que se van a quitar, esto no desencadena un error (ya que si el usuario no está en ese rol, no se intenta nada). Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
UserObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Identificadores de objeto de rol o nombres para mostrar
RolesJSON string

Lista de los roles de administrador que se van a asignar al usuario, en formato JSON o CSV. Por ejemplo: [{"Role": "Application Developer"}, {"Role": "Exchange Administrator"}] (formato de tabla JSON), ["Application Developer", "Exchange Administrator"] (formato de matriz JSON) o Desarrollador de aplicaciones,Administrador de Exchange (formato CSV). Puede especificar un rol de administrador de AAD por Nombre para mostrar (por ejemplo, "Desarrollador de aplicaciones") o ObjectId (por ejemplo, UUID/VALOR GUID).

Id. de ámbito de directorio
DirectoryScopeId string

Identificador de ámbito de directorio opcional que deben coincidir las asignaciones de roles especificadas para la eliminación. Por ejemplo: / representa todo el inquilino (y solo dará lugar a asignaciones de roles con nombre con un identificador de ámbito de directorio de / que se va a quitar), /GUID representa un registro de aplicación, /administrativeUnits/GUID representa una unidad administrativa. Si desea quitar una asignación de roles con nombre, independientemente del ámbito de directorio, especifique * o un valor en blanco.

Excepción si se produce un error en la eliminación de algún rol
ExceptionIfAnyRolesFailToRemove boolean

Si se establece en true: se generará una excepción (error) si un único rol de administrador de Azure AD no puede quitar (es decir, 100% correcto es un requisito). Si no se produce ninguna excepción, esta acción notificará cuántos roles de administrador de Azure AD se quitaron correctamente y cuántos no se pudieron quitar.

Excepción si no se pueden quitar todos los roles
ExceptionIfAllRolesFailToRemove boolean

Si se establece en true: solo se generará una excepción (error) si todos los roles de administrador de Azure AD no pueden quitar (es decir, sin éxito y algunos errores). Si no se produce ninguna excepción, esta acción notificará cuántos roles de administrador de Azure AD se quitaron correctamente y cuántos no se pudieron quitar.

Excepción si no existe un rol
ExceptionIfRoleDoesNotExist boolean

Si se establece en true: se generará una excepción (error) si uno de los roles especificados para la eliminación no existe. Si se establece en false (valor predeterminado): si no existe un rol especificado para la eliminación, se omitirá, ya que el usuario no se puede asignar a él.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Roles de Azure AD eliminados correctamente
AzureADRolesRemovedSuccessfully integer

Número de roles de Azure AD quitados. Esto solo cuenta los roles que se quitaron realmente (los roles en los que el usuario no estaba en no contar).

No se pudieron quitar los roles de Azure AD
AzureADRolesFailedToRemove integer

Número de roles de Azure AD que no se pudieron quitar.

Mensaje de error Quitar roles de Azure AD
RemoveAzureADRolesMasterErrorMessage string

Si algunos roles no se han quitado y no se ha producido ninguna excepción, este mensaje de error proporciona detalles del problema.

Eliminación del usuario de Azure AD del grupo

Quita un usuario de Azure Active Directory de un grupo de Azure Active Directory. Esta acción no puede modificar listas de distribución ni grupos de seguridad habilitados para correo: use las acciones de Office 365 Exchange Online en su lugar. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
UserObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Id. de objeto de grupo o nombre para mostrar
GroupObjectId True string

Identificador o nombre para mostrar de un grupo de Azure Active Directory. Puede especificar un grupo por Nombre para mostrar (por ejemplo, "Usuarios financieros") o ObjectId (por ejemplo, UUID/valor GUID).

Comprobar primero las pertenencias a grupos de usuarios
CheckUserGroupMembershipsFirst boolean

Si se establece en true, IA-Connect comprobará las pertenencias a grupos del usuario antes de intentar quitarlas del grupo. Si el usuario no es miembro del grupo, IA-Connect simplemente notificará el éxito sin tener que hacer nada. Si se establece en false, IA-Connect quitará inmediatamente al usuario del grupo sin comprobarlo, lo que producirá un error si el usuario no está en el grupo.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
AzureADv2RemoveUserFromGroupResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Es el usuario de Azure AD asignado al rol de administrador.

Devuelve si se asigna un usuario de Azure Active Directory a un rol de administrador de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
UserObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Id. de objeto de rol o nombre para mostrar
RoleObjectId True string

Identificador o nombre para mostrar de un rol de administrador de Azure Active Directory. Puede especificar un rol de administrador de AAD por Nombre para mostrar (por ejemplo, "Desarrollador de aplicaciones") o ObjectId (por ejemplo, UUID/VALOR GUID).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
El usuario se asigna al rol
UserIsAssignedToRole boolean

Si el usuario está asignado al rol de administrador de Azure Active Directory.

Esperar un buzón de Office 365

Espere a que exista un buzón de Microsoft Exchange Online u Office 365 especificado. Esto es habitual si está esperando que una configuración de sincronización o licencia de AD surta efecto. Si el buzón ya existía, la acción devolverá inmediatamente correctamente.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identificador de un buzón de Microsoft Exchange Online u Office 365. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Detalles del tipo de destinatario
RecipientTypeDetails string

Tipo de buzón que se va a buscar. Si este campo se deja en blanco, todos los tipos de buzón se incluirán en la búsqueda.

Número de veces que se va a comprobar
NumberOfTimesToCheck True integer

Número de veces que se va a comprobar que el buzón existe. Cada comprobación está separada por una cantidad de tiempo configurable.

Segundos entre intentos
SecondsBetweenTries True integer

Cuántos segundos hay que esperar entre cada comprobación.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de resultados de búsqueda
PowerShellJSONOutput string

Las propiedades del buzón ubicado si ya existían o existían después de esperar, en formato JSON.

Recuento de buzones encontrados
CountOfMailboxesFound integer

Número de buzones encontrados que coinciden con la identidad de búsqueda. 1 representaría una espera correcta (o el buzón ya existía). 0 representaría el buzón no existente, incluso después de esperar.

Establecer el envío de buzón de Exchange en nombre de

Especifique quién puede enviar en nombre de este buzón existente.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Microsoft Exchange. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Concesión de envío en nombre a
GrantSendOnBehalfTo True string

Identificación de un usuario, grupo o buzón que puede enviar correos electrónicos en nombre de este buzón. Puede especificar un usuario por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ExchangeSetMailboxSendOnBehalfOfPermissionResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Establecer el usuario de Active Directory protegido contra la eliminación accidental

Establece una cuenta de Active Directory que se va a proteger (o no protegida) de la eliminación accidental. Si protege una cuenta frente a la eliminación accidental, no podrá eliminarla hasta que quite la protección.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity True string

Identidad del usuario de Active Directory. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Protección contra la eliminación accidental
ProtectedFromAccidentalDeletion True boolean

Establézcalo en true para proteger a un usuario de la eliminación accidental. Establézcalo en false para quitar la protección frente a la eliminación accidental.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectorySetADUserProtectedFromAccidentalDeletionByIdentityResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Establecer Exchange para ver todo el bosque de Active Directory

Especifique si se busca o ve todo el bosque de Active Directory (incluidos los subdominios) al realizar acciones de Exchange. Es posible que tenga que usar esta acción si tiene varios dominios vinculados.

Parámetros

Nombre Clave Requerido Tipo Description
Visualización de todo el bosque
ViewEntireForest True boolean

Establézcalo en true si desea buscar en todo el bosque de Active Directory, false si solo desea buscar en el dominio de Active Directory actual.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ExchangeSetADServerToViewEntireForestResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Establecer las propiedades en un buzón de Microsoft Exchange

Establezca las propiedades de un buzón de Microsoft Exchange existente.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Microsoft Exchange. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Cuenta deshabilitada
AccountDisabled boolean

Establézcalo en true si desea deshabilitar la cuenta, false si desea habilitar la cuenta o no especifica un valor para dejar sin modificar la configuración actual.

Alias
Alias string

Alias de Exchange (también conocido como alias de correo) para el usuario. Si la directiva de dirección de correo electrónico está habilitada, se usará para generar el componente de nombre de la dirección de correo electrónico SMTP principal (por ejemplo, alias@mydomain.com). Si la directiva de dirección de correo electrónico no está habilitada, es posible que desee establecer la dirección SMTP principal en su lugar. Deje en blanco si no desea cambiar el valor actual.

Nombre para mostrar
DisplayName string

Nombre para mostrar del buzón. Esto es visible en las listas de direcciones.

Dirección SMTP principal
PrimarySmtpAddress string

Dirección de correo electrónico de devolución principal que se usa para el destinatario. Es poco probable que pueda establecer esto si la "directiva de dirección de correo electrónico" está habilitada, por lo que use "Alias" en su lugar (y la directiva creará la dirección SMTP principal desde el alias) o deshabilitará la directiva de dirección de correo electrónico. Deje en blanco si no desea cambiar el valor actual.

Oculta de las listas de direcciones
HiddenFromAddressListsEnabled boolean

Establézcalo en true para ocultar el buzón de las listas de direcciones, false para mostrar el buzón en listas de direcciones o no especifique un valor para dejar sin modificar la configuración actual.

Atributo personalizado 1
CustomAttribute1 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 2
CustomAttribute2 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 3
CustomAttribute3 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 4
CustomAttribute4 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 5
CustomAttribute5 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 6
CustomAttribute6 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 7
CustomAttribute7 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 8
CustomAttribute8 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 9
CustomAttribute9 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 10
CustomAttribute10 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 11
CustomAttribute11 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 12
CustomAttribute12 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 13
CustomAttribute13 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 14
CustomAttribute14 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 15
CustomAttribute15 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Directiva de dirección de correo electrónico habilitada
EmailAddressPolicyEnabled boolean

Establézcalo en true si desea actualizar automáticamente las direcciones de correo electrónico en función de la directiva de direcciones de correo electrónico aplicada a este destinatario. Si la directiva de dirección de correo electrónico está habilitada, esto generalmente afectará a la capacidad de establecer la dirección SMTP principal. Establézcalo en false para deshabilitar la característica, lo que le proporciona control total para establecer manualmente direcciones de correo electrónico. Deje en blanco si no desea establecer esta opción (es decir, deje el valor existente o predeterminado).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ExchangeSetMailboxResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Establecer las propiedades en un buzón de Microsoft Exchange Online

Establezca las propiedades de un buzón existente de Microsoft Exchange Online u Office 365 (remoto). La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Correo de Microsoft Exchange Online u Office 365 (remoto). Puede especificar un buzón de Microsoft Exchange Online u Office 365 (remoto) por id. de objeto de Active Directory, alias, nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, email address, GUID o User Principal Name (UPN).

Alias
Alias string

Alias de Exchange (también conocido como alias de correo) para el usuario. Si la directiva de dirección de correo electrónico está habilitada, se usará para generar el componente de nombre de la dirección de correo electrónico SMTP principal (por ejemplo, alias@mydomain.com). Si la directiva de dirección de correo electrónico no está habilitada, es posible que desee establecer la dirección SMTP principal en su lugar. Deje en blanco si no desea cambiar el valor actual.

Nombre para mostrar
DisplayName string

Nombre para mostrar del buzón. Esto es visible en las listas de direcciones. Deje en blanco si no desea cambiar el valor actual.

Dirección SMTP principal
PrimarySmtpAddress string

Dirección de correo electrónico de devolución principal que se usa para el destinatario. Es poco probable que pueda establecer esto si la "directiva de dirección de correo electrónico" está habilitada, por lo que use "Alias" en su lugar (y la directiva creará la dirección SMTP principal desde el alias) o deshabilitará la directiva de dirección de correo electrónico. Deje en blanco si no desea cambiar el valor actual.

Tipo de buzón
Type string

Tipo de buzón de correo. Deje en blanco si no desea cambiar el valor actual.

Oculta de las listas de direcciones
HiddenFromAddressListsEnabled boolean

Establézcalo en true para ocultar el buzón de las listas de direcciones, false para mostrar el buzón en listas de direcciones o no especifique un valor para dejar sin modificar la configuración actual.

Atributo personalizado 1
CustomAttribute1 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 2
CustomAttribute2 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 3
CustomAttribute3 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 4
CustomAttribute4 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 5
CustomAttribute5 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 6
CustomAttribute6 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 7
CustomAttribute7 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 8
CustomAttribute8 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 9
CustomAttribute9 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 10
CustomAttribute10 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 11
CustomAttribute11 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 12
CustomAttribute12 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 13
CustomAttribute13 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 14
CustomAttribute14 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Atributo personalizado 15
CustomAttribute15 string

Valor del campo de atributo personalizado. Deje en blanco si no desea especificar un valor. Si desea establecer el valor en blanco (es decir, ya tiene un valor y desea restablecerlo), use la acción "Restablecer".

Directiva de dirección de correo electrónico habilitada
EmailAddressPolicyEnabled boolean

Establézcalo en true si desea actualizar automáticamente las direcciones de correo electrónico en función de la directiva de direcciones de correo electrónico aplicada a este destinatario. Si la directiva de dirección de correo electrónico está habilitada, esto generalmente afectará a la capacidad de establecer la dirección SMTP principal. Establézcalo en false para deshabilitar la característica, lo que le proporciona control total para establecer manualmente direcciones de correo electrónico. Deje en blanco si no desea establecer esta opción (es decir, deje el valor existente o predeterminado).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ExchangeSetRemoteMailboxResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Establecer las propiedades en un buzón de Office 365

Establezca las propiedades en un buzón de Correo de Microsoft Exchange Online u Office 365.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identificador de un buzón de Microsoft Exchange Online u Office 365. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Cuenta deshabilitada
AccountDisabled boolean

Establézcalo en true si desea deshabilitar la cuenta, false si desea habilitar la cuenta o no especifica un valor para dejar sin modificar la configuración actual.

Alias
Alias string

Alias de Exchange (también conocido como alias de correo) para el usuario.

Nombre para mostrar
DisplayName string

Nombre para mostrar del buzón. Esto es visible en las listas de direcciones.

Oculta de las listas de direcciones
HiddenFromAddressListsEnabled boolean

Establézcalo en true para ocultar el buzón de las listas de direcciones, false para mostrar el buzón en listas de direcciones o no especifique un valor para dejar sin modificar la configuración actual.

Atributo personalizado 1
CustomAttribute1 string

Valor del campo atributo personalizado 1.

Atributo personalizado 2
CustomAttribute2 string

Valor del campo atributo personalizado 2.

Atributo personalizado 3
CustomAttribute3 string

Valor del campo atributo personalizado 3.

Atributo personalizado 4
CustomAttribute4 string

Valor del campo atributo personalizado 4.

Tipo de buzón
Type string

Tipo de buzón de correo. Deje en blanco si no desea cambiar el valor actual.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
O365SetO365MailboxResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Establecer respuestas automáticas (fuera de la oficina) para un buzón de Microsoft Exchange

Establecer respuestas automáticas (fuera de la oficina) para un buzón de Microsoft Exchange. Esta acción no funcionará para el buzón remoto en Microsoft Exchange Online u Office 365: Use la acción "Establecer respuestas automáticas (fuera de Office) para un buzón de Office 365" en su lugar.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Microsoft Exchange. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Estado de respuesta automática
AutoReplyState True string

Permite habilitar o deshabilitar respuestas automáticas.

Mensaje interno
InternalMessage string

Mensaje de respuesta automática (fuera de la oficina) que se va a enviar a remitentes internos. Establézcalo en blanco para quitar el mensaje.

Audiencia externa
ExternalAudience string

Permite especificar si las respuestas automáticas se envían a audiencias externas. De forma predeterminada, las respuestas se envían a todos los remitentes externos.

Mensaje externo
ExternalMessage string

Mensaje de respuesta automática (fuera de la oficina) que se va a enviar a remitentes externos, si la audiencia externa se estableció en "All" o "Known". Establézcalo en blanco para quitar el mensaje.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ExchangeSetMailboxAutoReplyConfigurationResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Establecer respuestas automáticas (fuera de office) para un buzón de Office 365

Establecer respuestas automáticas (fuera de office) para un buzón de Microsoft Exchange Online u Office 365.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identificador de un buzón de Microsoft Exchange Online u Office 365. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Estado de respuesta automática
AutoReplyState True string

Permite habilitar o deshabilitar respuestas automáticas.

Mensaje interno
InternalMessage string

Mensaje de respuesta automática (fuera de la oficina) que se va a enviar a remitentes internos. Establézcalo en blanco para quitar el mensaje.

Audiencia externa
ExternalAudience string

Permite especificar si las respuestas automáticas se envían a audiencias externas. De forma predeterminada, las respuestas se envían a todos los remitentes externos.

Mensaje externo
ExternalMessage string

Mensaje de respuesta automática (fuera de la oficina) que se va a enviar a remitentes externos, si la audiencia externa se estableció en "All" o "Known". Establézcalo en blanco para quitar el mensaje.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
O365SetO365MailboxAutoReplyConfigurationResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Establecimiento de la fecha de finalización de la expiración de la cuenta de usuario de Active Directory

Establece el final de la fecha de expiración de la cuenta para una cuenta de usuario de Active Directory. Este es el último día completo en el que se puede usar la cuenta, por lo que técnicamente la cuenta expira al principio del día siguiente. El agente de IA-Connect es consciente de esto y agrega automáticamente 1 día a la fecha de entrada proporcionada al almacenar la fecha en Active Directory.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity True string

Identidad del usuario de Active Directory. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Año
Year True integer

El año en el que debe expirar la cuenta. Por ejemplo: 2023.

Mes
Month True integer

Número del mes que debe expirar la cuenta. Enero = 1 de diciembre = 12. Por ejemplo: 6.

Day
Day True integer

Número del día que debe expirar la cuenta. Primer día del mes = 1. Por ejemplo: 19.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectorySetADUserAccountExpirationEndOfDateResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Establecimiento de la licencia de usuario de Azure AD

Agrega o quita una licencia de usuario (SKU) de Azure AD. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
ObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Licencia para agregar
LicenseToAdd string

Una única SKU de licencia de Azure AD que se va a agregar. Esto se puede escribir como un identificador de SKU (un GUID) o un número de parte de SKU (una palabra). Por ejemplo: TEAMS_EXPLORATORY. Si desea habilitar varias licencias, llame a esta acción una vez por licencia.

Planes de licencia para agregar
LicensePlansChoice string

Algunas licencias tienen planes: si desea habilitar todos los planes (o no lo sabe), elija "Todo". Si desea habilitar solo determinados planes con nombre, elija "Opt-in" y escriba los planes para habilitar en el campo "Planes de licencia CSV". Si desea habilitar todos los planes excepto los que especifique, elija "Rechazar" y escriba los planes para deshabilitar en el campo "CSV de planes de licencia".

Planes de licencia
LicensePlansCSV string

Lista separada por comas (CSV) de los planes de licencia (un componente de la licencia) para habilitar o deshabilitar. Si deja este campo en blanco, se habilitarán todos los planes de licencia. Esto se puede escribir como un identificador de SKU (un GUID) o un número de parte de SKU (una palabra). Por ejemplo: YAMMER_ENTERPRISE,SHAREPOINTSTANDARD.

Licencias para quitar
LicensesToRemoveCSV string

Lista separada por comas de las SKU de licencia de Azure AD que se van a quitar. Esto se puede escribir como una lista separada por comas del identificador de SKU (un GUID) o un número de parte de SKU (una palabra). Por ejemplo: TEAMS_EXPLORATORY,FLOW_FREE.

Ubicación de uso
UsageLocation string

Código de país de dos letras (ISO 3166). Necesario para los usuarios a los que se asignarán licencias debido a un requisito legal. Por ejemplo: EE. UU. (Estados Unidos), JP (Japón), GB (Reino Unido), FR (Francia), IN (India). Consulte https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes. Si no establece este valor, el usuario ya debe tener establecida su ubicación de uso o la licencia no se aplicará.

Ámbito local de PowerShell
LocalScope boolean

Si el comando de PowerShell subyacente de Azure AD v2 se ejecuta en el ámbito local. De forma predeterminada, esto no se establece y, por tanto, PowerShell vuelve a los valores predeterminados.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
AzureADv2SetAzureADUserLicenseResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Establecimiento del administrador del usuario de Azure AD

Establezca el administrador de un usuario de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
ObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Administrador
Manager string

Para agregar un administrador, especifique el identificador de objeto del administrador del usuario (por ejemplo, el valor UUID/GUID) o el UPN (por ejemplo, myboss@mydomain.com). Para quitar el administrador del usuario, establezca este campo en blanco.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
AzureADv2SetAzureADUserManagerResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Establecimiento del servidor de Active Directory

Establece un servidor de Active Directory específico que se usará para todas las acciones adicionales de Active Directory.

Parámetros

Nombre Clave Requerido Tipo Description
Elección predefinida del servidor de AD
PredefinedADServerChoice string

PDC de usuario: se usará el emulador de PDC para el dominio al que pertenece el usuario que ha iniciado sesión actualmente. PDC del equipo: se usará el emulador de PDC para el dominio en el que pertenece el equipo (en el que se ejecuta la sesión de IA-Connect). Manual: escriba el controlador de dominio (DC) de Active Directory en el campo "Servidor de AD". Si este campo está en blanco y el campo "Servidor de AD" tiene un valor, ese valor se usará.

Servidor de AD
ADServer string

Este campo solo se usa si la opción "Servidor de AD predefinido" está establecida en "Manual" (o en blanco). Nombre o Nombre de dominio completo (FQDN) de un controlador de dominio de Active Directory (DC) con el que se debe ponerse en contacto con todas las acciones adicionales de Active Directory. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectorySetADServerResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Está conectado a Active Directory

Informa si IA-Connect está conectado a Active Directory. De forma predeterminada, IA-Connect se conecta automáticamente al dominio del equipo en el que se ejecuta el agente de IA-Connect es miembro, con la cuenta de la que se ejecuta el agente de IA-Connect como. Use la acción "Conectar a Active Directory con credenciales" para conectarse mediante credenciales alternativas o a un dominio alternativo.

Parámetros

Nombre Clave Requerido Tipo Description
Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Conectado a Active Directory
ActiveDirectoryRunspaceOpen boolean

Se establece en true si IA-Connect está conectado a Active Directory. Esto siempre debe devolver true, ya que IA-Connect se conecta automáticamente al dominio del que se ejecuta el agente.

Conexión de acceso directo local
ActiveDirectoryLocalPassthroughRunspace boolean

Establézcalo en true si IA-Connect está conectado al dominio del que se ejecuta el agente de IA-Connect es miembro, con la cuenta de la que se ejecuta el agente de IA-Connect como.

Servidor de Active Directory
ActiveDirectoryServer string

El servidor de Active Directory al que está conectado. Si está en blanco, IA-Connect usa el controlador de dominio de Active Directory predeterminado para el equipo que ejecuta el agente, en función de la configuración del sitio de AD.

Dominio DNS de Active Directory
ActiveDirectoryDNSDomain string

El dominio DNS de Active Directory para el dominio IA-Connect está conectado. Si está en blanco, IA-Connect usa el dominio de Active Directory predeterminado para el equipo que ejecuta el agente. Por ejemplo: mydomain.local.

DN de dominio de Active Directory
ActiveDirectoryDomainDN string

El DN de dominio de Active Directory para el IA-Connect de dominio está conectado. Si está en blanco, IA-Connect usa el dominio de Active Directory predeterminado para el equipo que ejecuta el agente. Por ejemplo: DC=mydomain,DC=local.

Nombre de usuario autenticado
AuthenticatedUsername string

El nombre de usuario autenticado IA-Connect usa para la conexión a Active Directory. Si está en blanco, IA-Connect usa la cuenta en la que se ejecuta el agente de IA-Connect.

Está conectado a Azure AD

Informa si IA-Connect está conectado a Azure Active Directory (también conocido como Id. de Microsoft Entra, Azure AD o AAD). Use una de las acciones "Conectar a Azure AD" para conectarse.

Parámetros

Nombre Clave Requerido Tipo Description
Recuperación del identificador de proceso del espacio de ejecución de PowerShell
RetrievePowerShellRunSpacePID boolean

Si se establece en true: el agente de IA-Connect recuperará información sobre el identificador de proceso del proceso que hospeda el espacio de ejecución de PowerShell. Esta información se proporcionará en las salidas "Id. de proceso del espacio de ejecución de PowerShell" y "Is Agent hosting PowerShell runspace".

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
El espacio de ejecución de PowerShell de Azure AD está abierto
AzureADv2RunspaceOpen boolean

Establézcalo en true si IA-Connect está conectado a Azure AD. Esto podría usar los módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph.

Azure AD API
AzureADAPI string

Nombre de la API de Azure AD que se va a usar. Esto se establece en "AzureADv2" si usa el módulo de PowerShell de Azure AD v2 o "MSGraphUsersPS" si usa el módulo de PowerShell Usuarios de Microsoft Graph.

Identificador de proceso del espacio de ejecución de PowerShell
PowerShellRunspacePID integer

Identificador de proceso del espacio de ejecución (PID) de PowerShell. Si el agente de IA-Connect hospeda el espacio de ejecución de PowerShell, este valor será el PID del agente de IA-Connect. Si el espacio de ejecución de PowerShell está aislado, este valor será el PID del proceso de aislamiento.

¿Es el agente que hospeda el espacio de ejecución de PowerShell?
IsAgentHostingPowerShellRunSpace boolean

Devuelve true, si el agente de IA-Connect hospeda el espacio de ejecución de PowerShell (es decir, si el identificador de proceso del espacio de ejecución de PowerShell es el PID del agente).

Está conectado a Microsoft Exchange

Informa si IA-Connect está conectado a un servidor de Microsoft Exchange. Use la acción "Conectar a Microsoft Exchange" para conectarse.

Parámetros

Nombre Clave Requerido Tipo Description
Pruebas de comunicaciones
TestCommunications boolean

Si se establece en false: IA-Connect no emitirá un comando de prueba para confirmar que la conexión del servidor Exchange es funcional y se basará en el último estado conocido. Si se establece en true (valor predeterminado): IA-Connect emitirá un comando de prueba para confirmar que la conexión del servidor Exchange es funcional.

Recuperación del identificador de proceso del espacio de ejecución de PowerShell
RetrievePowerShellRunSpacePID boolean

Si se establece en true: el agente de IA-Connect recuperará información sobre el identificador de proceso del proceso que hospeda el espacio de ejecución de PowerShell. Esta información se proporcionará en las salidas "Id. de proceso del espacio de ejecución de PowerShell" y "Is Agent hosting PowerShell runspace".

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Conectado a Microsoft Exchange
ExchangeRunspaceOpen boolean

Establézcalo en true si IA-Connect está conectado a Microsoft Exchange.

Método de conexión de Exchange
ExchangeConnectionMethod string

Contiene el método de conexión actual de Exchange: Local o Remoto.

Identificador de proceso del espacio de ejecución de PowerShell
PowerShellRunspacePID integer

Identificador de proceso del espacio de ejecución (PID) de PowerShell. Si el agente de IA-Connect hospeda el espacio de ejecución de PowerShell, este valor será el PID del agente de IA-Connect. Si el espacio de ejecución de PowerShell está aislado, este valor será el PID del proceso de aislamiento.

¿Es el agente que hospeda el espacio de ejecución de PowerShell?
IsAgentHostingPowerShellRunSpace boolean

Devuelve true, si el agente de IA-Connect hospeda el espacio de ejecución de PowerShell (es decir, si el identificador de proceso del espacio de ejecución de PowerShell es el PID del agente).

Está conectado a Office 365

Informa si IA-Connect está conectado a Office 365 con los módulos de PowerShell de Office 365. Use la acción "Conectar a Office 365" para conectarse.

Parámetros

Nombre Clave Requerido Tipo Description
Pruebas de comunicaciones
TestCommunications boolean

Si se establece en false: IA-Connect no emitirá un comando de prueba para confirmar que la conexión de Exchange Online de Office 365 es funcional y se basará en el último estado conocido. Si se establece en true (valor predeterminado): IA-Connect emitirá un comando de prueba para confirmar que la conexión de Office 365 Exchange Online es funcional.

Recuperación del identificador de proceso del espacio de ejecución de PowerShell
RetrievePowerShellRunSpacePID boolean

Si se establece en true: el agente de IA-Connect recuperará información sobre el identificador de proceso del proceso que hospeda el espacio de ejecución de PowerShell. Esta información se proporcionará en las salidas "Id. de proceso del espacio de ejecución de PowerShell" y "Is Agent hosting PowerShell runspace".

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Conectado a Office 365
O365RunspaceOpen boolean

Establezca en true si IA-Connect está conectado a Office 365 mediante los módulos de PowerShell de Office 365.

Método de conexión de Office 365
Office365ConnectionMethod string

Contiene el método de conexión actual de Office 365: EXOV1 o EXOV2.

Identificador de proceso del espacio de ejecución de PowerShell
PowerShellRunspacePID integer

Identificador de proceso del espacio de ejecución (PID) de PowerShell. Si el agente de IA-Connect hospeda el espacio de ejecución de PowerShell, este valor será el PID del agente de IA-Connect. Si el espacio de ejecución de PowerShell está aislado, este valor será el PID del proceso de aislamiento.

¿Es el agente que hospeda el espacio de ejecución de PowerShell?
IsAgentHostingPowerShellRunSpace boolean

Devuelve true, si el agente de IA-Connect hospeda el espacio de ejecución de PowerShell (es decir, si el identificador de proceso del espacio de ejecución de PowerShell es el PID del agente).

Habilitación de la cuenta de usuario de Active Directory

Habilita una cuenta de usuario de Active Directory. Si la cuenta no está deshabilitada, este comando no hace nada.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity True string

Identidad del usuario de Active Directory. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectoryEnableADUserByIdentityResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Habilitación del usuario de Azure AD

Habilita un usuario de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
UserObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
AzureADv2EnableUserResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Incorporación de un usuario de Azure AD a varios grupos

Agrega un usuario de Azure Active Directory a varios grupos de Azure Active Directory existentes en los que los grupos se especifican mediante el identificador de objeto o el nombre para mostrar. IA-Connect agrega el usuario a tantos grupos como sea posible e informa sobre el resultado. Esta acción no puede modificar listas de distribución ni grupos de seguridad habilitados para correo: use las acciones de Office 365 Exchange Online en su lugar. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
UserObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Grupos de Azure AD que se van a agregar
GroupNamesJSON string

Una lista de los identificadores o los nombres para mostrar de los grupos de Azure AD a los que agregar el usuario, en formato JSON o CSV. Por ejemplo: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (formato de tabla JSON), ["Group 1", "Group 2"] (formato de matriz JSON) o Group 1,Group 2 (formato CSV).

Excepción si algún grupo no puede agregar
ExceptionIfAnyGroupsFailToAdd boolean

Si se establece en true: se generará una excepción (error) si un único grupo no puede agregar (es decir, 100% correcto es un requisito). Algunos grupos (por ejemplo: grupos de Office 365) podrían no agregarse, por lo que una excepción podría ser común. Si no se produce ninguna excepción, esta acción notificará cuántos grupos se agregaron correctamente y cuántos no se pudieron agregar.

Excepción si no se pueden agregar todos los grupos
ExceptionIfAllGroupsFailToAdd boolean

Si se establece en true: se generará una excepción (error) solo si todos los grupos no pueden agregar (es decir, sin éxitos y algunos errores). Si no se produce ninguna excepción, esta acción notificará cuántos grupos se agregaron correctamente y cuántos no se pudieron agregar.

Comprobar primero las pertenencias a grupos de usuarios
CheckUserGroupMembershipsFirst boolean

Si se establece en true, IA-Connect comprobará las pertenencias a grupos del usuario antes de intentar agregarlas al grupo. Si el usuario ya es miembro del grupo, IA-Connect simplemente notificará el éxito sin tener que hacer nada. Si se establece en false, IA-Connect agregará inmediatamente el usuario al grupo sin comprobarlo, lo que producirá un error si el usuario ya está en el grupo.

Número máximo de grupos de Azure AD por llamada
MaxAzureADGroupsPerCall integer

Si se especifica un gran número de grupos de Azure AD para agregar, esto podría provocar un tiempo de espera. Al establecer el valor "Número máximo de grupos de Azure AD por llamada" en 1 o superior, el IA-Connect Orchestrator dividirá esta acción en varias llamadas al director y al agente de IA-Connect con el número máximo especificado de grupos por llamada. Por ejemplo: Si establece un valor de 5 y 14 grupos, el orquestador lo dividirá en solicitudes de 5, 5, 4.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Grupos de Azure AD agregados correctamente
AzureADGroupsAddedSuccessfully integer

Número de grupos de Azure AD al que el usuario se agregó correctamente.

Los grupos de Azure AD no se pudieron agregar
AzureADGroupsFailedToAdd integer

Número de grupos de Azure AD a los que el usuario no pudo agregar.

Adición de un mensaje de error maestro de grupos de Azure AD
AddAzureADGroupsMasterErrorMessage string

Si el usuario no pudo agregar a algunos de los grupos de Azure AD y no se produjo ninguna excepción, este mensaje de error proporciona detalles del problema.

Modificación de la carpeta principal del usuario de Active Directory

Establece la carpeta principal, directorio o unidad para un usuario de Active Directory.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity True string

Identidad del usuario de Active Directory. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Unidad de casa
HomeDrive string

Si el directorio principal o la carpeta está en un recurso compartido de red, especifique una letra de unidad que se asignará a esa ubicación. La letra de unidad suele ser un solo carácter entre "F" y "Z". Si el directorio principal o la carpeta es local, deje este valor en blanco. Si va a establecer el directorio principal o la carpeta en blanco, deje este valor en blanco.

Directorio principal
HomeDirectory string

Especifique la ruta de acceso de la carpeta principal o directorio. Si también especifica una letra de unidad principal, la unidad principal se asignará a esta carpeta o directorio. Si establece el directorio principal o la carpeta en blanco, establezca este valor en blanco.

Crear carpeta
CreateFolder boolean

Establézcalo en true si desea crear la carpeta principal o el directorio si no existe.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectorySetADUserHomeFolderByIdentityResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Modificación de la propiedad booleana de usuario de Active Directory

Modifique una propiedad booleana individual (true/false) de un usuario de Active Directory. Esto le permite modificar una configuración de usuario muy específica, incluidas las propiedades personalizadas.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity True string

Identidad del usuario de Active Directory. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Nombre de propiedad
PropertyName True string

Nombre de la propiedad de usuario individual que se va a modificar. Las propiedades booleanas comunes son: enabled, mTSAllowLogon, msExchHideFromAddressLists.

Valor de propiedad
PropertyValue boolean

Valor true/false que se va a asignar a la propiedad especificada. Si necesita establecer el valor en NULL, use la acción "Modificar propiedades de cadena de usuario de Active Directory" en su lugar, con un valor de propiedades en blanco y estableciendo "Reemplazar valor" en "Sí".

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectoryModifyADUserBooleanPropertyByIdentityResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Modificación de las propiedades de la cadena de usuario de Active Directory

Modifique las propiedades de cadena individuales de un usuario de Active Directory. Esto le permite modificar la configuración de usuario muy específica, incluidas las propiedades personalizadas. También puede establecer propiedades de usuario individuales en blanco.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity True string

Identidad del usuario de Active Directory. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Propiedad
Property string
Importancia
Value string
Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Reemplazar valor
ReplaceValue boolean

Establezca en true para reemplazar los valores. Establezca en false para agregar el valor. Agregar no funcionará si el valor ya existe (esto solo afecta a las propiedades personalizadas), mientras que reemplazar se puede usar para crear un nuevo valor o reemplazar un valor existente.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectoryModifyADUserStringPropertyByIdentityResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Modificación de las propiedades de usuario comunes de Active Directory

Modifique las propiedades comunes de un usuario de Active Directory. Solo puede asignar valores a propiedades, no establecerlos en blanco. Para establecer las propiedades en blanco, use la acción "Modificar propiedades de cadena de usuario de Active Directory".

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity True string

Identidad del usuario de Active Directory. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

City
City string

La propiedad "Ciudad" del usuario (en la pestaña "Dirección" de usuarios y equipos de AD).

Empresa
Company string

La propiedad "Compañía" del usuario (en la pestaña "Organización" de usuarios y equipos de AD).

Código de país
Country string

La propiedad "País" del usuario (en la pestaña "Dirección" de usuarios y equipos de AD). Debe ser un código de país de dos caracteres (por ejemplo, GB para Reino Unido, EE. UU. para Estados Unidos, FR para Francia, ES para España, JP para Japón). Esto se asigna a la propiedad 'c' en el esquema de Active Directory. IA-Connect no asignará automáticamente "Código de país" a "Cadena de país" y "Country ISO 3166 value", por lo que deberá usar una tabla de búsqueda.

Cadena de país
CountryString string

Nombre completo de la propiedad "País" del usuario (en la pestaña "Dirección" de usuarios y equipos de AD). Esta es la cadena de visualización localizada completa (por ejemplo, "Reino Unido", "Estados Unidos", "Francia", "España" o "Japón"). Esto se asigna a la propiedad 'co' en el esquema de Active Directory. IA-Connect no asignará automáticamente "Cadena de país" a "Código de país" y "País ISO 3166 valor", por lo que deberá usar una tabla de búsqueda.

Valor iso 3166 de país
CountryISO3166 string

El código ISO3166 para la propiedad "País" del usuario (en la pestaña "Dirección" de usuarios y equipos de AD). Se trata de un valor entero de 3 dígitos (por ejemplo, 826 para Reino Unido, 840 para Estados Unidos, 250 para Francia, 724 para España, 392 para Japón). Esto se asigna a la propiedad 'countryCode' en el esquema de Active Directory. IA-Connect no asignará automáticamente el valor "Country ISO 3166" a "Country code" (Código de país) y "Country string" (Cadena de país), por lo que deberá usar una tabla de búsqueda.

Departamento
Department string

La propiedad "Departamento" del usuario (en la pestaña "Organización" de usuarios y equipos de AD).

Description
Description string

La propiedad "Descripción" del usuario (en la pestaña "General" de usuarios y equipos de AD).

Nombre para mostrar
DisplayName string

Nombre para mostrar del usuario (en la pestaña "General" de usuarios y equipos de AD).

Dirección de correo electrónico
EmailAddress string

La propiedad "Correo electrónico" del usuario (en la pestaña "General" de usuarios y equipos de AD).

Nombre
GivenName string

Nombre del usuario (en la pestaña "General" de usuarios y equipos de AD).

Número de teléfono principal
HomePhone string

Propiedad "Inicio" del número de teléfono del usuario (en la pestaña "Teléfonos" de usuarios y equipos de AD).

Initials
Initials string

Iniciales del usuario (en la pestaña "General" de usuarios y equipos de AD).

Número de teléfono IP
IPPhone string

La propiedad "Teléfono IP" del usuario (en la pestaña "Teléfonos" de usuarios y equipos de AD).

Administrador
Manager string

La propiedad Administrador del usuario (en la pestaña "Organización" de usuarios y equipos de AD). Puede especificar un administrador en formato de nombre distintivo (por ejemplo, CN=MrBig,OU=Londres,DC=mydomain,DC=local), formato GUID, SID o SAMAccountName (por ejemplo, "MrBig").

Número de teléfono móvil
MobilePhone string

Propiedad de número de teléfono "Móvil" del usuario (en la pestaña "Teléfonos" de usuarios y equipos de AD).

Notas
Notes string

La propiedad "Notas" del usuario (en la pestaña "Teléfonos" de usuarios y equipos de AD). Esto se asigna a la propiedad "info" en el esquema de Active Directory.

Oficina
Office string

La propiedad "Office" del usuario (en la pestaña "General" de usuarios y equipos de AD).

Número de teléfono (oficina)
OfficePhone string

La propiedad "Número de teléfono" del usuario (en la pestaña "General" de usuarios y equipos de AD).

Código postal/Código postal
PostalCode string

La propiedad "Código postal/postal" del usuario (en la pestaña "Dirección" de los usuarios y equipos de AD).

Ruta de acceso al perfil
ProfilePath string

Propiedad "Ruta de acceso de perfil" del usuario (en la pestaña "Perfil" de usuarios y equipos de AD).

Script de inicio de sesión
ScriptPath string

La propiedad "Script de inicio de sesión" del usuario (en la pestaña "Perfil" de usuarios y equipos de AD).

Estado o provincia
State string

La propiedad "Estado o provincia" del usuario (en la pestaña "Dirección" de los usuarios y equipos de AD).

Dirección postal
StreetAddress string

La propiedad "Dirección postal" del usuario (en la pestaña "Dirección" de los usuarios y equipos de AD).

Apellido
Surname string

Propiedad "Apellidos" del usuario (en la pestaña "General" de usuarios y equipos de AD).

Puesto
Title string

La propiedad "Título del trabajo" del usuario (en la pestaña "Organización" de usuarios y equipos de AD).

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectoryModifyADUserPropertiesResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Modificación de las propiedades de usuario de Azure AD

Modifique las propiedades comunes de un usuario de Azure Active Directory. Solo puede asignar valores a propiedades, no establecerlos en blanco, ya que un valor en blanco se interpreta como una intención de dejar el valor sin cambios. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
ObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Nombre
FirstName string

Nombre del usuario.

Apellido
LastName string

Nombre de familia / apellido / apellido del usuario.

Nombre para mostrar
DisplayName string

Nombre para mostrar completo para este usuario.

City
City string

Nombre de la ciudad en la que reside el usuario o donde se encuentra su oficina.

Nombre de la compañía
CompanyName string

Nombre de la empresa para la que trabaja el usuario.

País o región
Country string

País o región en el que reside el usuario o donde se encuentra su oficina.

Departamento
Department string

Nombre del departamento para el que trabaja el usuario dentro de la Compañía.

Número de fax
FaxNumber string

Número de teléfono de fax (facsimile) del usuario.

Puesto
JobTitle string

Puesto del usuario.

Número de teléfono móvil
MobilePhone string

Número de teléfono móvil del usuario.

Oficina
Office string

Ubicación de la oficina donde trabaja el usuario.

Número de teléfono
PhoneNumber string

Número de teléfono del usuario.

Código postal
PostalCode string

El código postal o postal donde reside el usuario, o la oficina en la que trabaja.

Lenguaje preferido
PreferredLanguage string

Idioma preferido del usuario. Normalmente, esto se escribe como un código de dos letras de idioma (ISO 639-1), seguido de un guión, seguido de un código de país de dos letras mayúsculas (ISO 3166). Por ejemplo: en-US, en-GB, fr-FR, ja-JP.

Estado o provincia
State string

El estado, provincia o condado en el que reside el usuario o donde se encuentra su oficina.

Dirección postal
StreetAddress string

La dirección postal donde reside el usuario o su dirección postal de oficina.

Ubicación de uso
UsageLocation string

Código de país de dos letras (ISO 3166). Necesario para los usuarios a los que se asignarán licencias debido a un requisito legal. Por ejemplo: EE. UU. (Estados Unidos), JP (Japón), GB (Reino Unido), FR (Francia), IN (India). Consulte https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes.

Grupo de edad
AgeGroup string

Grupo de edad del usuario, con fines de control parental.

Consentimiento proporcionado para el menor
ConsentProvidedForMinor string

Si el "Grupo de edad" es "Menor", este campo le permite especificar si el consentimiento se ha proporcionado para el menor, con fines de control parental.

Alias de correo
MailNickName string

Alias de correo del usuario.

Id. de empleado
EmployeeId string

Identificador del empleado. Puede usarlo para distinguir de forma única entre cada usuario de su organización.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
AzureADv2SetAzureADUserResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Modificar direcciones de correo electrónico de buzón de Microsoft Exchange

Modifique las direcciones de correo electrónico en un buzón de Microsoft Exchange. Puede agregar, quitar y reemplazar las direcciones de correo electrónico principal y de alias.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Microsoft Exchange. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Alias
Alias string

Alias de Exchange (también conocido como alias de correo) para el usuario. Si la directiva de dirección de correo electrónico está habilitada, se usará para generar el componente de nombre de la dirección de correo electrónico SMTP principal (por ejemplo, alias@mydomain.com). Si la directiva de dirección de correo electrónico no está habilitada, es posible que desee establecer la dirección SMTP principal en su lugar. Deje en blanco si no desea cambiar el valor actual.

Dirección SMTP principal
PrimarySmtpAddress string

Dirección de correo electrónico de devolución principal que se usa para el destinatario. Es poco probable que pueda establecer esto si la "directiva de dirección de correo electrónico" está habilitada, por lo que use "Alias" en su lugar (y la directiva creará la dirección SMTP principal desde el alias) o deshabilitará la directiva de dirección de correo electrónico. Deje en blanco si no desea cambiar el valor actual.

Directiva de dirección de correo electrónico habilitada
EmailAddressPolicyEnabled boolean

Establézcalo en true si desea actualizar automáticamente las direcciones de correo electrónico en función de la directiva de direcciones de correo electrónico aplicada a este destinatario. Si la directiva de dirección de correo electrónico está habilitada, esto generalmente afectará a la capacidad de establecer la dirección SMTP principal. Establézcalo en false para deshabilitar la característica, lo que le proporciona control total para establecer manualmente direcciones de correo electrónico. Deje en blanco si no desea establecer esta opción (es decir, deje el valor existente o predeterminado).

Direcciones de correo electrónico que se van a agregar
EmailAddressesToAddList array of string

Lista de direcciones de correo electrónico adicionales (no principales) que se asignarán al buzón.

Reemplazar direcciones de correo electrónico
ReplaceEmailAddresses boolean

Establézcalo en true si desea que la lista proporcionada de direcciones de correo electrónico reemplace todas las direcciones de correo electrónico existentes (no incluida la dirección SMTP principal). Establézcalo en false si desea que la lista proporcionada de direcciones de correo electrónico se agregue a las direcciones existentes.

Direcciones de correo electrónico que se van a quitar
EmailAddressesToRemoveList array of string

Lista de direcciones de correo electrónico adicionales (no principales) que se van a quitar del buzón (si están presentes). Esto solo tiene un propósito si "Reemplazar direcciones de correo electrónico" está establecido en false o si no agrega ninguna dirección de correo electrónico.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Direcciones de correo electrónico de buzón
MailboxEmailAddresses array of string

Las direcciones de correo electrónico del buzón después de realizar la acción de modificación. La dirección de correo electrónico SMTP principal aparecerá como SMTP:emailaddress, las direcciones de correo electrónico SMTP secundarias (proxy) aparecerán como smtp:emailaddress, las direcciones de correo electrónico X.400 aparecerán como direcciones x400:address y mensajería unificada de Exchange (EUM) como eum:address.

Modificar direcciones de correo electrónico de buzón de Microsoft Exchange Online

Modifique las direcciones de correo electrónico en un buzón existente de Microsoft Exchange Online u Office 365 (remoto). Puede agregar, quitar y reemplazar las direcciones de correo electrónico principal y de alias. La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Correo de Microsoft Exchange Online u Office 365 (remoto). Puede especificar un buzón de Microsoft Exchange Online u Office 365 (remoto) por id. de objeto de Active Directory, alias, nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, email address, GUID o User Principal Name (UPN).

Alias
Alias string

Alias de Exchange (también conocido como alias de correo) para el usuario. Si la directiva de dirección de correo electrónico está habilitada, se usará para generar el componente de nombre de la dirección de correo electrónico SMTP principal (por ejemplo, alias@mydomain.com). Si la directiva de dirección de correo electrónico no está habilitada, es posible que desee establecer la dirección SMTP principal en su lugar. Deje en blanco si no desea cambiar el valor actual.

Dirección SMTP principal
PrimarySmtpAddress string

Dirección de correo electrónico de devolución principal que se usa para el destinatario. Es poco probable que pueda establecer esto si la "directiva de dirección de correo electrónico" está habilitada, por lo que use "Alias" en su lugar (y la directiva creará la dirección SMTP principal desde el alias) o deshabilitará la directiva de dirección de correo electrónico. Deje en blanco si no desea cambiar el valor actual.

Directiva de dirección de correo electrónico habilitada
EmailAddressPolicyEnabled boolean

Establézcalo en true si desea actualizar automáticamente las direcciones de correo electrónico en función de la directiva de direcciones de correo electrónico aplicada a este destinatario. Si la directiva de dirección de correo electrónico está habilitada, esto generalmente afectará a la capacidad de establecer la dirección SMTP principal. Establézcalo en false para deshabilitar la característica, lo que le proporciona control total para establecer manualmente direcciones de correo electrónico. Deje en blanco si no desea establecer esta opción (es decir, deje el valor existente o predeterminado).

Direcciones de correo electrónico que se van a agregar
EmailAddressesToAddList array of string

Lista de direcciones de correo electrónico adicionales (no principales) que se asignarán al buzón.

Reemplazar direcciones de correo electrónico
ReplaceEmailAddresses boolean

Establézcalo en true si desea que la lista proporcionada de direcciones de correo electrónico reemplace todas las direcciones de correo electrónico existentes (no incluida la dirección SMTP principal). Establézcalo en false si desea que la lista proporcionada de direcciones de correo electrónico se agregue a las direcciones existentes.

Direcciones de correo electrónico que se van a quitar
EmailAddressesToRemoveList array of string

Lista de direcciones de correo electrónico adicionales (no principales) que se van a quitar del buzón (si están presentes). Esto solo tiene un propósito si "Reemplazar direcciones de correo electrónico" está establecido en false o si no agrega ninguna dirección de correo electrónico.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Direcciones de correo electrónico de buzón
MailboxEmailAddresses array of string

Las direcciones de correo electrónico del buzón después de realizar la acción de modificación. La dirección de correo electrónico SMTP principal aparecerá como SMTP:emailaddress, las direcciones de correo electrónico SMTP secundarias (proxy) aparecerán como smtp:emailaddress, las direcciones de correo electrónico X.400 aparecerán como direcciones x400:address y mensajería unificada de Exchange (EUM) como eum:address.

Mover el usuario de Active Directory a la unidad organizativa

Mueve un usuario de Active Directory a una unidad organizativa (OU) de Active Directory existente.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity True string

Identidad del usuario de Active Directory. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Ruta de acceso de destino
TargetPath True string

Ruta de acceso a la unidad organizativa (OU) de destino en formato de nombre distintivo (por ejemplo, OU=Target OU,OU=London,DC=mydomain,DC=local), formato GUID o como ruta de acceso (por ejemplo, MyUsers\London).

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectoryMoveADUserToOUByIdentityResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Obtención de asignaciones de roles de administrador de usuarios de Azure AD

Devuelve una lista de roles de administrador de Azure Active Directory a los que se asigna el usuario especificado. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
ObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Recuperación de nombres de roles de administrador
RetrieveAdminRoleNames boolean

Si se establece en true, el agente de IA-Connect recuperará los nombres de cada rol además de los identificadores de rol. Esto tarda más tiempo, pero proporciona información más legible. Si se establece en false, el agente de IA-Connect no recuperará los nombres de rol.

Devolver identificadores de asignación
ReturnAssignmentIds boolean

Si se establece en true, el agente de IA-Connect recuperará los identificadores de asignación de cada asignación de roles. Los identificadores de asignación solo son necesarios si piensa realizar algunas acciones personalizadas en la asignación de roles (en lugar de usar acciones de IA-Connect integradas).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de asignaciones de roles
PowerShellJSONOutput string

La lista de roles de administrador de Azure AD a los que se asigna el usuario, en formato JSON.

Recuento de asignaciones de roles encontradas
CountOfRoleAssignmentsFound integer

Número de roles de administrador de Azure AD a los que está asignado el usuario.

Obtención de grupos de Azure AD

Devuelve los detalles de los grupos de Azure Active Directory (también conocidos como Identificador de Entra de Microsoft, Azure AD o AAD). Puede buscar por identificador de objeto o mediante un filtro. Una búsqueda de id. de objeto debe devolver 0 o 1 resultados. Una búsqueda de filtro podría devolver 0 o más resultados. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de objeto de grupo
ObjectId string

Identificador de objeto de un grupo de Azure Active Directory que se va a buscar. Puede especificar un grupo por Nombre para mostrar (por ejemplo, "Usuarios financieros") o ObjectId (por ejemplo, UUID/valor GUID).

Nombre de propiedad de filtro
FilterPropertyName string

Como alternativa a la búsqueda por identificador de objeto de grupo, proporcione el nombre de la propiedad para filtrar los grupos por. Los nombres de propiedad de grupo comunes son: Description, DisplayName y Mail. Si usa un filtro, también debe rellenar los campos "Comparación de propiedades filter" y "Valor de propiedad Filter".

Comparación de propiedades de filtro
FilterPropertyComparison string

Si la búsqueda por filtro como alternativa a la búsqueda por id. de objeto de grupo, escriba el tipo de comparación aquí (por ejemplo: Si el nombre de la propiedad de filtro es "DisplayName", la comparación podría ser "equals" o "starts with"). Si desea escribir un filtro sin formato (en formato ODATA 3), elija un tipo de comparación de "Raw: Enter filter manualmente" y escriba el filtro completo en el campo "Filter property value".

Valor de la propiedad Filter
FilterPropertyValue string

Si la búsqueda por filtro como alternativa a la búsqueda por id. de objeto de grupo, escriba el valor de la propiedad filter aquí (por ejemplo: Si el nombre de la propiedad de filtro es "DisplayName", el valor de la propiedad de filtro podría ser "Usuarios de Londres").

No se produce ninguna excepción
NoResultIsAnException boolean

Establézcalo en true para generar una excepción si no se encuentra ningún grupo. Establézcalo en false para simplemente notificar un recuento de 0 si no se encuentra ningún grupo. Tenga en cuenta que la opción "false" puede no funcionar cuando se usa con Identity en idiomas que no son en inglés, por lo que considere la posibilidad de buscar mediante filtros en su lugar.

Propiedades que se van a devolver
PropertiesToReturn string

Lista separada por comas (CSV) de todas las propiedades de grupo que se van a devolver (recuperar). Si está en blanco (valor predeterminado), IA-Connect devolverá un conjunto predeterminado de propiedades de grupo comunes. Si usa los módulos de PowerShell de usuarios de Microsoft Graph, la entrada le permite limitar las propiedades devueltas o devolver propiedades adicionales. Si usa Azure AD v2, la entrada solo le permite limitar las propiedades devueltas.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de resultados de búsqueda
PowerShellJSONOutput string

Lista de grupos que coinciden con el identificador o filtro del objeto de búsqueda, en formato JSON.

Recuento de grupos encontrados
CountOfGroupsFound integer

Número de grupos encontrados que coinciden con el identificador o filtro del objeto de búsqueda.

Obtención de la pertenencia a grupos de usuarios de Active Directory

Devuelve una lista de grupos de Active Directory de los que es miembro el usuario especificado, menos el grupo principal (normalmente "Usuarios de dominio") ya que técnicamente no es miembro. Esta acción solo funciona con cuentas de usuario, no puede usar esta acción para consultar la pertenencia a grupos de grupos o equipos.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity True string

Usuario que se va a consultar para la pertenencia a grupos. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de pertenencia a grupos
GroupMembershipJSON string

La lista de grupos de AD del que el usuario es miembro, en formato JSON.

Recuento de grupos encontrados
CountOfGroupsFound integer

El número de grupos de AD del que el usuario es miembro, menos el grupo principal (normalmente "Usuarios del dominio") que no se cuenta.

Obtención de la pertenencia a grupos de usuarios de Azure AD

Devuelve una lista de grupos de Azure Active Directory de los que es miembro el usuario especificado. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
ObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Propiedades que se van a devolver
PropertiesToReturn string

Lista separada por comas (CSV) de todas las propiedades de grupo que se van a devolver (recuperar). Si está en blanco (valor predeterminado), IA-Connect devolverá todas las propiedades del grupo.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de pertenencia a grupos
PowerShellJSONOutput string

La lista de grupos de Azure AD del que el usuario es miembro, en formato JSON.

Recuento de grupos encontrados
CountOfGroupsFound integer

El número de grupos de Azure AD del que es miembro el usuario.

Obtención de la unidad organizativa de Active Directory del DN del usuario

Función de utilidad. Dado el nombre distintivo (DN) de un usuario de Active Directory, devuelve la unidad organizativa (OU) en la que se encuentra el usuario.

Parámetros

Nombre Clave Requerido Tipo Description
DN de usuario
UserDN True string

Nombre distintivo del usuario de búsqueda (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Unidad organizativa del usuario
UserOU string

Unidad organizativa (OU) en la que se encuentra el usuario.

Obtención de licencias de usuario de Azure AD

Recupera una lista de licencias (SKU) asignadas a un usuario de Azure AD. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
ObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de licencia de usuario
UserLicenseSKUJSONOutput string

La lista de SKU de licencia de Azure AD asignadas al usuario, en formato JSON.

Recuento de SKU de licencia de usuario encontradas
CountOfUserLicenseSKUsFound integer

Número de SKU de licencia de Azure AD asignadas al usuario.

Obtención de miembros del grupo de Azure AD

Devuelve una lista de miembros de un grupo de Azure Active Directory. Los miembros pueden ser usuarios, grupos, dispositivos o entidades de servicio o aplicaciones empresariales. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de objeto de grupo o UPN
GroupObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Propiedades que se van a devolver
PropertiesToReturn string

Lista separada por comas (CSV) de todas las propiedades de miembro que se van a devolver (recuperar). Si está en blanco (valor predeterminado), IA-Connect devolverá AccountEnabled, DirSyncEnabled, DisplayName, Mail, MailNickName, ObjectId, ObjectType, SecurityEnabled, UserPrincipalName. Escriba * para recibir todas las propiedades.

Tipos de objeto miembro que se van a devolver
MemberObjectTypesToReturn string

Lista separada por comas (CSV) de todos los tipos de objetos de miembro que se van a devolver (recuperar). Si está en blanco (valor predeterminado), IA-Connect devolverá todos los tipos de objetos de miembro que pueden ser uno o varios de los siguientes: Usuario,Grupo,Dispositivo,ServicePrincipal.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de miembros de grupo
PowerShellJSONOutput string

La lista de miembros del grupo de AD, en formato JSON.

Recuento de miembros del grupo encontrados
CountOfGroupMembersFound integer

Número de miembros del grupo de Azure AD.

Obtención de planes de servicio de licencia de usuario de Azure AD

Recupera una lista de planes de licencias asignados a una licencia de usuario (SKU) de Azure AD especificada. Por ejemplo: si el usuario tiene asignada la licencia de FLOW_FREE, esto le permitirá ver qué planes de servicio han aprovisionado en esa licencia. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
ObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Número de parte de SKU de licencia
LicenseSKUPartNumber True string

Número de pieza de la SKU de licencia. Por ejemplo: FLOW_FREE o SPE_E3.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de planes de servicio de SKU de licencia de usuario
UserLicenseSKUServicePlansJSONOutput string

La lista de planes de servicio asignados a la SKU de licencia de Azure AD especificada asignada al usuario, en formato JSON.

Recuento de planes de servicio de SKU de licencia encontrados
CountOfUserLicenseSKUServicePlansFound integer

Número de planes de servicio de Azure AD asignados a la SKU de licencia especificada asignada al usuario.

Obtención de SKU de licencia de Azure AD

Devuelve una lista de unidades de almacenamiento de existencias (SKU) de licencia de Azure Active Directory a las que se suscribe la instancia de Azure AD conectada. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Expand (propiedad)
ExpandProperty string

Propiedad de licencia opcional que se va a expandir e incluir en la salida. Si expande "PrepaidUnits", la información de licencia, incluido el número total de licencias habilitadas, se incluirá en la salida. Si expande "ServicePlans", cada plan de servicio individual dentro de una SKU se devolverá como un elemento de línea de salida independiente. Solo puede expandir una propiedad a la vez.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de la SKU de licencia
LicenseSKUJSONOutput string

La lista de unidades de mantenimiento de existencias suscritas, en formato JSON.

Recuento de SKU encontradas
CountOfSKUsFound integer

Número de unidades de almacenamiento de existencias (SKU) suscritas a Azure AD.

Obtención de un usuario de Active Directory

Devuelve las propiedades de un usuario de Active Directory especificado. Puede buscar por identidad (para buscar un solo usuario) o mediante un filtro (para localizar uno o varios usuarios).

Parámetros

Nombre Clave Requerido Tipo Description
identidad
Identity string

Identidad del usuario de Active Directory. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Nombre de propiedad de filtro
FilterPropertyName string

Como alternativa a la búsqueda por identidad, proporcione el nombre de la propiedad para filtrar los usuarios por. Los nombres de propiedad comunes son: city, company, country, department, description, displayname, division, emailaddress, enabled, givenname, homedirectory, homedrive, homephone, initials, manager, office, organization, postalcode, profilepath, samaccountname, scriptpath, state, streetaddress, surname, title, userprincipalname. Si establece la entrada "Comparación de propiedades de filtro" en Raw o LDAP, puede dejar esta entrada en blanco.

Comparación de propiedades de filtro
FilterPropertyComparison string

Si la búsqueda por filtro como alternativa a la búsqueda por identidad, escriba el tipo de comparación aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", la comparación podría ser "equals" o "like"). Si desea escribir un filtro sin formato (en formato OPATH), elija un tipo de comparación de "Raw: Enter filter manualmente" y escriba el filtro completo en el campo "Filter property value". Si desea escribir un filtro LDAP, elija un tipo de comparación de "LDAP: Escriba filtro LDAP" y escriba el filtro completo en el campo "Valor de la propiedad Filter".

Valor de la propiedad Filter
FilterPropertyValue string

Como alternativa a la búsqueda por identidad, el valor del "Nombre de la propiedad Filter" para filtrar los usuarios por.

Base de unidad organizativa de búsqueda
SearchOUBase string

Unidad organizativa (OU) de nivel superior en la que se va a buscar. Solo se admite al buscar mediante un filtro, no por identidad. Si no se especifica, se busca en todo el dominio. La unidad organizativa base de búsqueda se puede especificar en formato de nombre distintivo (por ejemplo, OU=Londres,OU=MyUsers,DC=mydomain,DC=local), formato GUID o como ruta de acceso (por ejemplo, MyUsers\London).

Subárbol base de la unidad organizativa de búsqueda
SearchOUBaseSubtree boolean

Si se establece en true (valor predeterminado) y se proporciona una base de unidad organizativa de búsqueda, se buscará en la base de unidad organizativa de búsqueda y en todas las subuso. Si se establece en false y se proporciona una base de unidad organizativa de búsqueda, solo se buscará en la base de unidad organizativa de búsqueda. Esta entrada no se usa si no se proporciona una base de unidad organizativa de búsqueda o si busca por identidad.

Propiedades que se van a recuperar
Properties string

Lista separada por comas de propiedades de usuario adicionales que se van a recuperar. Entre las propiedades comunes se incluyen: city, company, country, department, description, displayname, division, emailaddress, enabled, givenname, homedirectory, homedrive, homephone, initials, manager, office, organization, postalcode, profilepath, samaccountname, scriptpath, state, streetaddress, surname, title, userprincipalname. Si deja este campo en blanco, se devuelve un conjunto predeterminado de propiedades.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Propiedades que se van a devolver como colección
PropertiesToReturnAsCollectionJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por nombre) IA-Connect deben intentar devolver como una colección. En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Nombres de propiedad para serializar" y "Tipos de propiedad para serializar" (elija uno). Esta entrada se puede escribir en formato JSON o CSV. Por ejemplo: Para devolver las propiedades de matriz EmailAddresses y MemberOf, escriba [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (formato de tabla JSON), ["EmailAddresses", "MemberOf"] (formato de matriz JSON) o EmailAddresses,MemberOf (formato CSV).

Nombres de propiedad para serializar
PropertyNamesToSerializeJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por nombre) IA-Connect deben serializarse como JSON, por lo que se devuelven como un tipo de cadena (que puede deserializar, una vez recibido). En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Propiedades para devolver como colección" y "Tipos de propiedad para serializar" (elija uno). Por ejemplo: Para serializar las propiedades EmailAddresses y MemberOf, escriba [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (formato de tabla JSON), ["EmailAddresses", "MemberOf"] (formato de matriz JSON) o EmailAddresses,MemberOf (formato CSV).

Tipos de propiedad para serializar
PropertyTypesToSerializeJSON string

Si los datos devueltos de PowerShell contienen propiedades "complejas" (por ejemplo, colecciones de valores, matrices, tablas o clases), estas propiedades no se devuelven, de forma predeterminada, en la respuesta de IA-Connect PowerShell. Esta opción permite especificar qué propiedades "complejas" (por tipo) IA-Connect deben serializarse como JSON, por lo que se devuelven como un tipo de cadena (que puede deserializar, una vez recibido). En función de la propiedad, su tipo y sus valores, también debe considerar el uso de las entradas alternativas "Propiedades para devolver como colección" y "Nombres de propiedad para serializar" (elija uno). Esta entrada es una colección con un único campo 'PropertyType'. Por ejemplo: Para serializar cualquier propiedad de tipo Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[], escriba [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] (formato de tabla JSON), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (formato de matriz JSON) o "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (formato CSV).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de resultados de búsqueda
PowerShellJSONOutput string

Lista de usuarios (y sus propiedades solicitadas) que coinciden con la identidad de búsqueda, en formato JSON.

Recuento de usuarios encontrados
CountOfUsersFound integer

Número de usuarios encontrados que coinciden con la identidad de búsqueda. Normalmente, 0 o 1 si busca por identidad, o 0 o más si busca por propiedad de filtro.

Obtención de usuarios de Azure AD

Devuelve los detalles de los usuarios de Azure Active Directory (también conocidos como Id. de Microsoft Entra, Azure AD o AAD). Puede buscar por identificador de objeto o mediante un filtro. Una búsqueda de id. de objeto debe devolver 0 o 1 resultados. Una búsqueda de filtro podría devolver 0 o más resultados. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
ObjectId string

Identificador de objeto de un usuario de Azure Active Directory que se va a buscar. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Nombre de propiedad de filtro
FilterPropertyName string

Como alternativa a la búsqueda por identificador de objeto de usuario, proporcione el nombre de la propiedad por la que filtrar los usuarios. Los nombres de propiedad comunes son: UserPrincipalName y DisplayName. Si usa un filtro, también debe rellenar los campos "Comparación de propiedades filter" y "Valor de propiedad Filter".

Comparación de propiedades de filtro
FilterPropertyComparison string

Si la búsqueda por filtro como alternativa a la búsqueda por identificador de objeto de usuario, escriba el tipo de comparación aquí (por ejemplo: Si el nombre de la propiedad de filtro es "UserPrincipalName", la comparación podría ser "equals" o "starts with"). Si desea escribir un filtro sin formato (en formato ODATA 3), elija un tipo de comparación de "Raw: Enter filter manualmente" y escriba el filtro completo en el campo "Filter property value".

Valor de la propiedad Filter
FilterPropertyValue string

Si la búsqueda por filtro como alternativa a la búsqueda por identificador de objeto de usuario, escriba el valor de la propiedad filter aquí (por ejemplo: Si el nombre de la propiedad de filtro es "UserPrincipalName", el valor de la propiedad de filtro podría ser "JohnDoe@mydomain.com").

No se produce ninguna excepción
NoResultIsAnException boolean

Establézcalo en true para generar una excepción si no se encuentra ningún usuario. Establézcalo en false para simplemente notificar un recuento de 0 si no se encuentra ningún buzón. Tenga en cuenta que la opción "false" puede no funcionar cuando se usa con Identity en idiomas que no son en inglés, por lo que considere la posibilidad de buscar mediante filtros en su lugar.

Propiedades que se van a devolver
PropertiesToReturn string

Lista separada por comas de propiedades de usuario que se van a devolver (recuperar). Entre las propiedades comunes se incluyen: AccountEnabled, City, CompanyName, Country, Department, DisplayName, GivenName, JobTitle, PostalCode, State, StreetAddress, Surname, UserPrincipalName. Si deja este campo en blanco, se recupera un conjunto predeterminado de propiedades. Si especifica las propiedades que se van a recuperar, solo se recuperarán esas propiedades. No tiene ningún efecto si se usan los módulos de PowerShell de Azure AD v2.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de resultados de búsqueda
PowerShellJSONOutput string

Lista de usuarios que coinciden con el filtro de búsqueda, en formato JSON.

Recuento de usuarios encontrados
CountOfUsersFound integer

Número de usuarios encontrados que coinciden con el id. del objeto de búsqueda, UPN o filtro.

Obtención del FQDN de dominio de Active Directory desde DN

Función de utilidad. Dado el nombre distintivo (DN) de un usuario de Active Directory, devuelve el dominio de Active Directory que contiene el usuario.

Parámetros

Nombre Clave Requerido Tipo Description
DN de usuario
DN True string

Nombre distintivo del usuario de búsqueda (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
FQDN de dominio
DomainFQDN string

Dominio de Active Directory que contiene el usuario.

Obtener buzón de Office 365

Devuelve las propiedades del buzón especificado de Microsoft Exchange Online u Office 365.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity string

Identificador de un buzón de Microsoft Exchange Online u Office 365. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Nombre de propiedad de filtro
FilterPropertyName string

Como alternativa a la búsqueda por identidad, proporcione el nombre de la propiedad para filtrar los buzones por. Los nombres de propiedad comunes son: Name, Alias, PrimarySMTPAddress, DisplayName, SamAccountName. Si usa un filtro, también debe rellenar los campos "Comparación de propiedades filter" y "Valor de propiedad Filter".

Comparación de propiedades de filtro
FilterPropertyComparison string

Si la búsqueda por filtro como alternativa a la búsqueda por identidad, escriba el tipo de comparación aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", la comparación podría ser "equals" o "like"). Si desea escribir un filtro sin formato (en formato OPATH), elija un tipo de comparación de "Raw: Enter filter manualmente" y escriba el filtro completo en el campo "Filter property value".

Valor de la propiedad Filter
FilterPropertyValue string

Si busca por filtro como alternativa a la búsqueda por identidad, escriba el valor de la propiedad filter aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", el valor de la propiedad de filtro podría ser "JohnDoe").

Detalles del tipo de destinatario
RecipientTypeDetails string

Tipo de buzón que se va a buscar. Si este campo se deja en blanco, todos los tipos de buzón se incluirán en la búsqueda.

No se produce ninguna excepción
NoResultIsAnException boolean

Establézcalo en true para generar una excepción si no se encuentra ningún buzón. Establézcalo en false para simplemente notificar un recuento de 0 si no se encuentra ningún buzón. Tenga en cuenta que la opción "false" puede no funcionar cuando se usa con Identity en idiomas que no son en inglés, por lo que considere la posibilidad de buscar mediante filtros en su lugar.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de resultados de búsqueda
PowerShellJSONOutput string

Lista de buzones (y sus propiedades) que coinciden con la identidad de búsqueda, en formato JSON.

Recuento de buzones encontrados
CountOfMailboxesFound integer

Número de buzones encontrados que coinciden con la identidad de búsqueda. Normalmente 1.

Obtener el siguiente nombre de cuenta disponible

En los detalles relacionados con el formato de nomenclatura para los nombres de cuentas de Active Directory y Exchange, se proporcionan los detalles del siguiente nombre de cuenta de reserva disponible. Se usa para determinar qué cuenta de Active Directory y Exchange se va a crear para un usuario determinado. Esta acción no crea ninguna cuenta, proporciona información sobre la disponibilidad del nombre.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre
FirstName string

Nombre del usuario. Deje en blanco si el nombre de un usuario no se usa para construir nombres de cuenta (raros).

Segundo nombre
MiddleName string

Nombre intermedio del usuario (opcional). Deje en blanco si el nombre intermedio de un usuario no se usa para construir nombres de cuenta.

Apellido
LastName string

Apellido/familia/nombre del usuario. Deje en blanco si el apellido de un usuario no se usa para construir nombres de cuenta.

Campo A
FieldA string

Campo adicional que se usa para construir nombres de cuenta. Deje en blanco si no se requiere ningún campo adicional para construir un nombre de cuenta.

Campo B
FieldB string

Campo adicional que se usa para construir nombres de cuenta. Deje en blanco si no se requiere ningún campo adicional para construir un nombre de cuenta.

Campo C
FieldC string

Campo adicional que se usa para construir nombres de cuenta. Deje en blanco si no se requiere ningún campo adicional para construir un nombre de cuenta.

Campo D
FieldD string

Campo adicional que se usa para construir nombres de cuenta. Deje en blanco si no se requiere ningún campo adicional para construir un nombre de cuenta.

Valor de inicio M
VariableMStartValue integer

Opcionalmente, permite establecer el valor inicial de la variable {M} que se puede usar en el formato de propiedad para representar una variable que aumenta con cada iteración.

N valor de inicio
VariableNStartValue integer

Opcionalmente, permite establecer el valor inicial de la variable {N} que se puede usar en el formato de propiedad para representar una variable que aumenta con cada iteración.

Valor de inicio X
VariableXStartValue integer

Opcionalmente, permite establecer el valor inicial de la variable {X} que se puede usar en el formato de propiedad para representar una variable que aumenta con cada iteración.

Número máximo de intentos
MaxAttempts integer

El número máximo de intentos (probar valores diferentes) antes de IA-Connect deja de intentar encontrar una cuenta disponible.

La reserva provoca la prueba de retest
FallbackCausesRetest boolean

Si se establece en true: si alguna comprobación de disponibilidad de alguna regla requiere revertir a un formato diferente, las pruebas volverán a iniciarse desde la parte superior de la lista para asegurarse de que todas las propiedades usen el mismo formato (por ejemplo, principal, principal, principal o reserva, reserva, reserva). Esto mantiene los resultados sincronizados y es el valor recomendado. Solo se establece en false si sabe exactamente lo que está haciendo.

Lista de números que no se van a usar
NumbersNotToUse string

Lista separada por comas de números que no se van a usar para los valores de M, N o X. Por ejemplo: '13, 666'.

Caracteres que se van a quitar de las entradas
CharactersToRemoveFromInputs string

Cadena que contiene todos los caracteres que desea quitar de las entradas (por ejemplo, si el nombre de un usuario contiene caracteres no válidos). Por ejemplo: !@&?^*.

Eliminación de diacríticos de las entradas
RemoveDiacriticsFromInputs boolean

Si se establece en true, IA-Connect intentará quitar todos los diacríticos de los campos de entrada, reemplazando los caracteres por un diacrítico con el mismo carácter menos el diacrítico. Por ejemplo: reemplazando "agudo énfasis a" por "a". En escenarios en los que no hay ninguna asignación directa a un carácter simple, se quita el carácter. Por ejemplo: se quita el sharp S alemán.

Eliminación de entradas no alfanuméricas de entradas
RemoveNonAlphaNumericFromInputs boolean

Si se establece en true, IA-Connect quitará todos los caracteres no alfanuméricos de los campos de entrada.

Secuencia A1
SequenceA1 string

Lista separada por comas de cadenas que se usarán para la variable {A1} que se puede usar en el formato de propiedad para representar un valor que cambia con cada intento de encontrar una cuenta disponible. Por ejemplo: si especifica 'A,B,C,D,E,F' para este valor, el formato '{FirstName}{A1}' comprobaría la disponibilidad de {FirstName}A seguido de {FirstName}B, etc.

Propiedad
PropertyToCheck string

Qué propiedad de cuenta se va a comprobar si hay disponibilidad

Formato
PropertyNameFormat string

Formato del valor de esta propiedad. Por ejemplo: {FirstName}. {LastName} o {FirstName first 1}. {LastName}

Dar formato a la reserva
PropertyNameFallbackFormat string

Formato de reserva para el valor de esta propiedad si ya se ha tomado el valor. Por ejemplo: {FirstName}. {LastName}{NN} o {FirstName first 1}. {LastName}{NN}

Formato de segunda reserva
PropertyNameFallbackFormat2 string

El segundo formato de reserva para el valor de esta propiedad si ya se ha tomado el valor y la primera reserva. Por ejemplo: {FirstName}. {LastName}{NN} o {FirstName first 1}. {LastName}{NN}

Longitud máxima del valor
PropertyNameMaxLength integer

Longitud máxima del valor de este campo antes de que se deba cortar algo

Campo que se va a cortar si la longitud máxima
PropertyNameMaxLengthFieldToCut string

Si se supera la longitud máxima del valor de este campo, se debe cortar la entrada. Por ejemplo: elija LastName si desea cortar del apellido / nombre de familia / apellido para acortar el valor de la propiedad.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
SamAccountName de usuario de AD
ActiveDirectorySAMAccountName string

El usuario de Active Directory disponible SAMAccountName (si era una de las propiedades para comprobar la disponibilidad).

Nombre de la cuenta de usuario de AD
ActiveDirectoryAccountName string

Nombre de cuenta de usuario de Active Directory disponible (si era una de las propiedades para comprobar la disponibilidad).

Nombre principal de usuario de AD
ActiveDirectoryUPN string

Nombre principal de usuario de Active Directory disponible (si era una de las propiedades para comprobar la disponibilidad).

Dirección de correo electrónico de usuario de AD
ActiveDirectoryEmailAddress string

Dirección de correo electrónico de Active Directory disponible (si era una de las propiedades para comprobar la disponibilidad).

Dirección de correo electrónico del buzón de Exchange
ExchangeMailboxAddress string

La dirección de buzón de correo electrónico de Exchange disponible (si era una de las propiedades para comprobar la disponibilidad).

Alias de buzón de Exchange
ExchangeMailboxAlias string

Alias de buzón de Exchange disponible (si se trata de una de las propiedades para comprobar la disponibilidad).

Dirección de buzón remoto de Exchange
ExchangeRemoteMailboxAddress string

La dirección del buzón remoto de Exchange disponible (si era una de las propiedades para comprobar la disponibilidad).

Nombre principal de usuario de Azure AD
AzureADUPN string

El nombre principal de usuario de Azure Active Directory disponible (si era una de las propiedades para comprobar la disponibilidad).

Nombre principal de usuario de Office 365
Office365UPN string

Nombre principal de usuario de Office 365 disponible (si era una de las propiedades para comprobar la disponibilidad).

Dirección de correo electrónico del buzón de Office 365
Office365MailboxEmailAddress string

La dirección de buzón de correo electrónico de Office 365 disponible (si era una de las propiedades para comprobar la disponibilidad).

Valor final M
MValue integer

Valor final de la variable M, si se usó.

N valor final
NValue integer

Valor final de la variable N, si se usó.

Valor final X
XValue integer

Valor final de la variable X, si se usó.

Índice de formato usado
FormatIndexUsed integer

Índice del formato que se usó para buscar coincidencias con las propiedades. 1 = Formato principal, 2 = Formato de reserva, 3 = Segundo formato de reserva. Esto le permite saber si el formato inicial dio lugar a una cuenta disponible o si IA-Connect tenía que revertir a un formato proporcionado diferente.

Obtener grupo de Active Directory

Devuelve las propiedades de un grupo o grupos de Active Directory especificados. Puede buscar por identidad (para buscar un único grupo) o mediante un filtro (para buscar uno o varios grupos).

Parámetros

Nombre Clave Requerido Tipo Description
identidad
Identity string

Identidad del grupo de Active Directory. Puede especificar un grupo por Nombre distintivo (por ejemplo, CN=Group1,OU=Mis grupos,DC=mydomain,DC=local), GUID, SID o SAMAccountName/nombre de pre-2K (por ejemplo, "Group1"). No puede usar el nombre para mostrar o el nombre del grupo (aunque el nombre del grupo suele ser el mismo que el nombre anterior a 2K que se puede usar).

Nombre de propiedad de filtro
FilterPropertyName string

Como alternativa a la búsqueda por identidad, proporcione el nombre de la propiedad para filtrar los grupos por. Los nombres de propiedad comunes para una búsqueda de grupo son: name, description, samaccountname.

Comparación de propiedades de filtro
FilterPropertyComparison string

Si la búsqueda por filtro como alternativa a la búsqueda por identidad, escriba el tipo de comparación aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", la comparación podría ser "equals" o "like"). Si desea escribir un filtro sin formato (en formato OPATH), elija un tipo de comparación de "Raw: Enter filter manualmente" y escriba el filtro completo en el campo "Filter property value". Si desea escribir un filtro LDAP, elija un tipo de comparación de "LDAP: Escriba filtro LDAP" y escriba el filtro completo en el campo "Valor de la propiedad Filter".

Valor de la propiedad Filter
FilterPropertyValue string

Como alternativa a la búsqueda por identidad, el valor de "Filter property name" (Filtrar nombre de propiedad) para filtrar los grupos por.

Base de unidad organizativa de búsqueda
SearchOUBase string

Unidad organizativa (OU) de nivel superior en la que se va a buscar. Solo se admite al buscar mediante un filtro, no por identidad. Si no se especifica, se busca en todo el dominio. La unidad organizativa se puede especificar en formato de nombre distintivo (por ejemplo, OU=Londres,OU=MyGroups,DC=mydomain,DC=local), formato GUID o como ruta de acceso (por ejemplo, MyGroups\London).

Subárbol base de la unidad organizativa de búsqueda
SearchOUBaseSubtree boolean

Si se establece en true (valor predeterminado) y se proporciona una base de unidad organizativa de búsqueda, se buscará en la base de unidad organizativa de búsqueda y en todas las subuso. Si se establece en false y se proporciona una base de unidad organizativa de búsqueda, solo se buscará en la base de unidad organizativa de búsqueda. Esta entrada no se usa si no se proporciona una base de unidad organizativa de búsqueda o si busca por identidad.

Generar excepción si el grupo no existe
RaiseExceptionIfGroupDoesNotExist boolean

Si se establece en true y el grupo no existe, se generará una excepción. Si se establece en false y el grupo no existe, la acción notificará correctamente, pero la salida notificará que no se encontró ningún grupo.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de resultados de búsqueda
PowerShellJSONOutput string

Lista de grupos (y sus propiedades solicitadas) que coinciden con la identidad de búsqueda.

Recuento de grupos encontrados
CountOfGroupsFound integer

Número de grupos encontrados que coinciden con la identidad de búsqueda. Los valores esperados son 0 o 1 para una búsqueda de identidades o cualquier valor para una búsqueda de filtro.

Obtener grupo de distribución de Office 365

Devuelve las propiedades de los grupos de distribución de Microsoft Exchange Online u Office 365 especificados o grupos de seguridad habilitados para correo. Puede buscar por Identidad o mediante un filtro. Una búsqueda de identidad debe devolver 0 o 1 resultados. Una búsqueda de filtro podría devolver 0 o más resultados.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del grupo de distribución
Identity string

Identidad del grupo de distribución o del grupo de seguridad habilitado para correo. Puede especificar un grupo de distribución por Nombre, Alias, Nombre distintivo (por ejemplo, CN=MyGroup,OU=Mis grupos,DC=mydomain,DC=local), Dirección de correo electrónico o GUID.

Nombre de propiedad de filtro
FilterPropertyName string

Como alternativa a la búsqueda por identidad, proporcione el nombre de la propiedad para filtrar los grupos de distribución por. Los nombres de propiedad comunes son: DisplayName, Name, GroupType, PrimarySMTPAddress. Si usa un filtro, también debe rellenar los campos "Comparación de propiedades filter" y "Valor de propiedad Filter".

Comparación de propiedades de filtro
FilterPropertyComparison string

Si la búsqueda por filtro como alternativa a la búsqueda por identidad, escriba el tipo de comparación aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", la comparación podría ser "equals" o "like"). Si desea escribir un filtro sin formato (en formato OPATH), elija un tipo de comparación de "Raw: Enter filter manualmente" y escriba el filtro completo en el campo "Filter property value".

Valor de la propiedad Filter
FilterPropertyValue string

Si busca por filtro como alternativa a la búsqueda por identidad, escriba el valor de la propiedad filter aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", el valor de la propiedad de filtro podría ser "JohnDoe").

No se produce ninguna excepción
NoResultIsAnException boolean

Establézcalo en true para generar una excepción si no se encuentra ningún grupo de distribución. Establézcalo en false para simplemente notificar un recuento de 0 si no se encuentra ningún grupo de distribución. Tenga en cuenta que la opción "false" puede no funcionar cuando se usa con Identity en idiomas que no son en inglés, por lo que considere la posibilidad de buscar mediante filtros en su lugar.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de resultados de búsqueda
PowerShellJSONOutput string

Salida del script de PowerShell, con formato JSON.

Recuento de grupos encontrados
CountOfGroupsFound integer

Número de grupos de distribución o grupos de seguridad habilitados para correo que coinciden con la identidad de búsqueda. Normalmente 1.

Obtener información de dominio de Active Directory

Recupera información sobre un dominio de Active Directory.

Parámetros

Nombre Clave Requerido Tipo Description
Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory al que enviar la solicitud de dominio. A continuación, el controlador de dominio obtendrá la información solicitada para el dominio especificado.

Identidad de dominio predefinida
PredefinedIdentity string

Usuario: la información se recuperará para el dominio al que pertenece el usuario que ha iniciado sesión actualmente. Equipo: la información se recuperará para el dominio al que pertenece el equipo (en el que se ejecuta la sesión de IA-Connect). Manual: escriba el dominio de Active Directory en el campo "Identidad de dominio". Si este campo está en blanco y el campo "Identidad de dominio" tiene un valor, se usará ese valor.

Identidad de dominio
Identity string

Este campo solo se usa si la "identidad de dominio predefinida" está establecida en "Manual" (o en blanco). Identidad de un dominio de Active Directory para el que se va a recuperar la información del dominio. Puede especificar un dominio de Active Directory por nombre distintivo (por ejemplo, DC=mydomain,DC=local), GUID, SID, nombre de dominio DNS (por ejemplo, mydomain.local) o nombre NetBIOS (por ejemplo, MYDOMAIN).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Nombre distintivo
DistinguishedName string

Nombre distintivo (DN) del dominio.

Nombre raíz dns
DNSRoot string

Nombre de la raíz DNS de nivel superior del dominio.

Modo de dominio
DomainMode string

Modo o nivel del dominio (por ejemplo, Windows2003Domain o Windows2016Domain).

SID de dominio
DomainSID string

Identificador de seguridad (SID) del dominio.

Forest
Forest string

Nombre del bosque de Active Directory (el contenedor lógico superior).

Maestro de infraestructura
InfrastructureMaster string

Nombre del controlador de dominio (DC) con el rol maestro de infraestructura.

Nombre netBIOS de dominio
NetBIOSName string

Nombre NetBIOS del dominio (por ejemplo, MYDOMAIN).

GUID de dominio
ObjectGUID string

GUID del dominio.

Emulador de PDC
PDCEmulator string

Nombre del controlador de dominio (DC) con el rol del emulador de PDC.

Maestro rid
RIDMaster string

Nombre del controlador de dominio (DC) con el rol maestro rid.

Obtener miembros del grupo de Active Directory

Devuelve una lista de miembros de un grupo de Active Directory.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de grupo
GroupIdentity True string

Identidad del grupo de Active Directory. Puede especificar un grupo por Nombre distintivo (por ejemplo, CN=Group1,OU=Mis grupos,DC=mydomain,DC=local), GUID, SID o SAMAccountName/nombre de pre-2K (por ejemplo, "Group1"). No puede usar el nombre para mostrar o el nombre del grupo (aunque el nombre del grupo suele ser el mismo que el nombre anterior a 2K que se puede usar).

Recursivo
Recursive boolean

Si se establece en false (valor predeterminado), solo se devolverán miembros directos del grupo. Si se establece en true, se devolverán miembros directos y miembros de miembros, básicamente devolver todos los miembros de AD en todos los niveles.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de miembros de grupo
GroupMembersJSON string

La lista de miembros del grupo de AD, en formato JSON.

Recuento de miembros del grupo encontrados
CountOfGroupMembersFound integer

Número de miembros del grupo de AD.

Obtener miembros del grupo de distribución de Microsoft Exchange

Recupere una lista de los miembros de un grupo de distribución de Microsoft Exchange.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del grupo de distribución
Identity True string

Identidad del grupo de distribución que se va a buscar. Puede especificar un grupo de distribución por Nombre, Alias, Nombre distintivo (por ejemplo, CN=MyGroup,OU=Mis grupos,DC=mydomain,DC=local), Dirección de correo electrónico o GUID.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Miembros del grupo de distribución
DistributionGroupMembersJSON string

Lista de miembros del grupo de distribución de Exchange, en formato JSON.

Recuento de miembros de grupos de distribución
CountOfDistributionGroupsMembers integer

Número de miembros del grupo de distribución de Microsoft Exchange.

Obtener miembros del grupo de distribución de Office 365

Recupere una lista de los miembros de un grupo de distribución de Microsoft Exchange Online u Office 365 o un grupo de seguridad habilitado para correo.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del grupo de distribución
GroupIdentity True string

Identidad del grupo de distribución que se va a buscar. Puede especificar un grupo de distribución por Nombre, Alias, Nombre distintivo (por ejemplo, CN=MyGroup,OU=Mis grupos,DC=mydomain,DC=local), Dirección de correo electrónico o GUID.

Propiedades que se van a recuperar
PropertiesToRetrieveJSON string

Lista de propiedades de miembro que se van a recuperar, en formato JSON o CSV. Por ejemplo: ["Identity", "DistinguishedName"] (formato de matriz JSON) o "Identity","DistinguishedName" (formato CSV). Entre las propiedades de miembro comunes se incluyen: Alias, DisplayName, DistinguishedName, Identity, Name, PrimarySMTPAddress, RecipientType y SamAccountName. Si deja este campo en blanco, se recupera un conjunto predeterminado de propiedades.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Miembros del grupo de distribución
O365DistributionGroupMembersJSON string

Lista de miembros del grupo de distribución de Microsoft Exchange Online u Office 365 o del grupo de seguridad habilitado para correo electrónico, en formato JSON.

Recuento de miembros de grupos de distribución
O365CountOfDistributionGroupsMembers integer

Número de miembros del grupo de seguridad habilitado para correo o grupo de distribución de Microsoft Exchange Online u Office 365.

Quitar el buzón de Office 365 de todos los grupos de distribución

Quite un buzón de todos los grupos de distribución de Microsoft Exchange Online u Office 365 o grupos de seguridad habilitados para correo de los que es miembro.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
MailboxIdentity string

La identidad del buzón de correo que se va a quitar de todos los grupos de distribución o grupos de seguridad habilitados para correo es miembro. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Omitir la comprobación del administrador de grupos de seguridad
BypassSecurityGroupManagerCheck boolean

Si la cuenta de automatización del agente de IA-Connect no es propietario de un grupo de distribución o un grupo de seguridad habilitado para correo, no podrá quitar un miembro de ese grupo. Si establece esta opción en true (el valor predeterminado), se omitirá la comprobación del propietario, pero requiere que la cuenta de automatización esté en el grupo de roles "Administración de la organización" de Exchange o que tenga asignado el rol "Administración de roles", es un único rol para concederle permisos para modificar cualquier grupo de Office 355 Exchange Online en lugar de ser propietario de todos los grupos que necesita modificar.

Excepción si se produce un error en la eliminación de algún grupo
ExceptionIfAnyGroupsFailToRemove boolean

Si se establece en true: se generará una excepción (error) si el buzón no se puede quitar de cualquier grupo individual (es decir, 100% correcto es un requisito). Si no se produce ninguna excepción, esta acción notificará cuántos grupos se quitaron correctamente y cuántos no se pudieron quitar.

Excepción si todos los grupos no pueden quitar
ExceptionIfAllGroupsFailToRemove boolean

Si se establece en true (valor predeterminado): se generará una excepción (error) si el buzón no se puede quitar de todos los grupos (es decir, sin éxitos y algunos errores). Si no se produce ninguna excepción, esta acción notificará cuántos grupos se quitaron correctamente y cuántos no se pudieron quitar.

DN de grupo que se van a excluir
GroupDNsToExcludeJSON string

Lista de nombres distintivos (DN) de grupo que se van a excluir de la eliminación, en formato JSON o CSV. Por ejemplo: [{"GroupDN": "Group DN 1"}, {"GroupName": "Group DN 2"}] (formato de tabla JSON), ["Group DN 1", "Group DN 2"] (formato de matriz JSON) o "Group DN 1","Group DN 2" (formato CSV).

Ejecutar como subproceso
RunAsThread boolean

Si se establece en false, el agente de IA-Connect ejecutará la acción inmediatamente y devolverá los resultados cuando se complete la acción, pero producirá un error si tarda más tiempo de espera del comando de trabajo o RPA. Si se establece en true, el agente de IA-Connect ejecutará esta acción como subproceso del agente y la supervisará hasta que se complete. Esto permite que la acción se ejecute durante más tiempo que el tiempo de espera del comando worker/RPA.

Recuperación de datos de salida para el identificador de subproceso
RetrieveOutputDataFromThreadId integer

Si anteriormente ejecutó esta acción como un subproceso del Agente y estableció "Segundos para esperar el subproceso" en 0, proporcione el identificador del subproceso del agente para recuperar los resultados. La llamada anterior a esta acción proporcionará este identificador de subproceso del agente. Establezca en 0 (valor predeterminado) si simplemente ejecuta esta acción (y, por tanto, no recupera los resultados de una instancia anterior de esta acción se ejecuta como un subproceso del Agente).

Segundos para esperar el subproceso
SecondsToWaitForThread integer

Si "Ejecutar como subproceso" se establece en true, cuántos segundos se esperarán a que se complete el subproceso del agente. Si el subproceso del Agente que ejecuta esta acción no se ha completado en este momento, se producirá una excepción. Establézcalo en 0 para omitir la espera: el agente seguirá ejecutando la acción, pero también estará disponible para la siguiente acción. A continuación, puede recuperar los resultados de la acción en un momento posterior mediante la acción "Esperar a que el subproceso del Agente se complete correctamente" para esperar a que se complete el subproceso del Agente y, a continuación, volver a ejecutar esta acción "Quitar buzón de Office 365 de todos los grupos de distribución" con la entrada "Recuperar datos de salida para el identificador de subproceso" establecido en el identificador del subproceso del agente.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Grupos de O365 eliminados correctamente
O365GroupsRemovedSuccessfully integer

El número de grupos de O365 del que se quitó correctamente el buzón.

Los grupos de O365 no se pudieron quitar
O365GroupsFailedToRemove integer

El número de grupos de O365 del que no se pudo quitar el buzón.

Grupos de O365 excluidos de la eliminación
O365GroupsExcludedFromRemoval integer

Número de grupos de O365 excluidos de la eliminación (es decir, coincide con uno de los DN de grupo especificados que se van a excluir).

Quitar mensaje de error maestro de grupos de O365
RemoveO365GroupsErrorMessage string

Si el buzón no se pudo quitar de algunos grupos de O365 y no se generó ninguna excepción, este mensaje de error proporciona detalles del problema.

Identificador de subproceso
ThreadId integer

Si esta acción se ejecuta como un subproceso del Agente, esta salida contendrá el identificador del subproceso del agente que se puede usar para supervisar la ejecución de la acción y recuperar los resultados cuando se haya completado la acción.

Quitar el permiso de buzón de Office 365 del usuario

Quite los permisos de buzón de Correo de Microsoft Exchange Online u Office 365 de un usuario, usuario o grupo de seguridad especificados.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identificador de un buzón de Microsoft Exchange Online u Office 365. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Usuario
User True string

El usuario de buzón, el usuario o el grupo de seguridad habilitado para correo para quitar de los permisos de buzón. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Derechos de acceso
AccessRights True string

Derechos de acceso que se van a quitar de los permisos del usuario en el buzón. Las opciones disponibles son "ChangeOwner", "ChangePermission", "DeleteItem", "ExternalAccount", "FullAccess" y "ReadPermission". Para quitar varios permisos, especifíquelos como una lista separada por comas.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
O365RemoveMailboxPermissionResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Quitar grupo de Active Directory

Quita un grupo de Active Directory. Si hay objetos (por ejemplo, usuarios, grupos o equipos) en el grupo, esos objetos se quitarán como parte de la eliminación del grupo.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de grupo
GroupIdentity True string

Identidad del grupo de Active Directory. Puede especificar un grupo por Nombre distintivo (por ejemplo, CN=Group1,OU=Mis grupos,DC=mydomain,DC=local), GUID, SID o SAMAccountName/nombre de pre-2K (por ejemplo, "Group1"). No puede usar el nombre para mostrar o el nombre del grupo (aunque el nombre del grupo suele ser el mismo que el nombre anterior a 2K que se puede usar).

Eliminar incluso si está protegido
DeleteEvenIfProtected boolean

Establézcalo en true para eliminar el grupo, incluso si está protegido contra la eliminación. Establézcalo en false para eliminar solo el grupo si no está protegido contra la eliminación y genera una excepción si el grupo está protegido.

Generar excepción si el grupo no existe
RaiseExceptionIfGroupDoesNotExist boolean

Si se establece en true y el grupo no existe, se generará una excepción. Si se establece en false y el grupo no existe, la acción notificará que la acción se realizó correctamente, pero la salida notificará que no se eliminaron grupos.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Número de grupos eliminados
NumberOfGroupsDeleted integer

Esta salida contendrá el número de grupos de AD eliminados que deben ser 0 o 1.

Quitar grupo de distribución de Microsoft Exchange

Quitar un grupo de distribución de Microsoft Exchange.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del grupo de distribución
Identity True string

Identidad del grupo de distribución. Puede especificar un grupo de distribución por Nombre, Alias, Nombre distintivo (por ejemplo, CN=MyGroup,OU=Mis grupos,DC=mydomain,DC=local), Dirección de correo electrónico o GUID.

Omitir la comprobación del administrador de grupos de seguridad
BypassSecurityGroupManagerCheck boolean

De forma predeterminada, si la cuenta de automatización del agente de IA-Connect no es propietario del grupo de distribución, no podrá quitar el grupo de distribución. Como alternativa, puede establecer esta opción en true y se quitará esa comprobación, pero requiere que la cuenta de automatización esté en el grupo de roles "Administración de la organización" de Exchange o que tenga asignado el rol "Administración de roles": se trata de un único rol para concederle permisos para modificar cualquier grupo de distribución de Exchange en lugar de ser propietario de todos los grupos de distribución que necesita modificar.

Excepción si el grupo no existe
ErrorIfGroupDoesNotExist boolean

¿Debería producirse una excepción si el grupo no existe? Establézcalo en false para no hacer nada si el grupo no existe (por ejemplo, es posible que ya se haya eliminado). Se establece en true si el grupo no existente es un error (es decir, se esperaba que exista).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ExchangeRemoveDistributionGroupResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Quitar grupo de distribución de Office 365

Quite un grupo de seguridad habilitado para correo electrónico o un grupo de distribución de Microsoft Exchange Online u Office 365.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del grupo de distribución
Identity True string

Identidad del grupo de distribución o del grupo de seguridad habilitado para correo que se va a quitar. Puede especificar un grupo de distribución por Nombre, Alias, Nombre distintivo (por ejemplo, CN=MyGroup,OU=Mis grupos,DC=mydomain,DC=local), Dirección de correo electrónico o GUID.

Omitir la comprobación del administrador de grupos de seguridad
BypassSecurityGroupManagerCheck boolean

Si la cuenta de automatización del agente de IA-Connect no es propietario del grupo de distribución o del grupo de seguridad habilitado para correo, no podrá quitar el grupo. Si establece esta opción en true (el valor predeterminado), se omitirá la comprobación del propietario, pero requiere que la cuenta de automatización esté en el grupo de roles "Administración de la organización" de Exchange o que tenga asignado el rol "Administración de roles", es un único rol para concederle permisos para modificar cualquier grupo de Office 355 Exchange Online en lugar de ser propietario de todos los grupos que necesita modificar.

Excepción si el grupo no existe
ErrorIfGroupDoesNotExist boolean

¿Debería producirse una excepción si el grupo no existe? Establézcalo en false para no hacer nada si el grupo no existe (por ejemplo, es posible que ya se haya eliminado). Se establece en true si el grupo no existente es un error (es decir, se esperaba que exista).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
O365RemoveDistributionGroupResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Quitar miembro de Microsoft Exchange del grupo de distribución

Quite un miembro (por ejemplo, un usuario) de un grupo de distribución de Exchange. Si el miembro no está en el grupo, no se realiza ninguna acción.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del grupo de distribución
Identity True string

Identidad del grupo de distribución al que se va a agregar. Puede especificar un grupo de distribución por Nombre, Alias, Nombre distintivo (por ejemplo, CN=MyGroup,OU=Mis grupos,DC=mydomain,DC=local), Dirección de correo electrónico o GUID.

Miembro que se va a quitar
Member True string

Identidad del miembro que se va a quitar del grupo de distribución. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Omitir la comprobación del administrador de grupos de seguridad
BypassSecurityGroupManagerCheck boolean

De forma predeterminada, si la cuenta de automatización del agente de IA-Connect no es propietario del grupo de distribución, no podrá modificar el grupo de distribución. Como alternativa, puede establecer esta opción en true y se quitará esa comprobación, pero requiere que la cuenta de automatización esté en el grupo de roles "Administración de la organización" de Exchange o que tenga asignado el rol "Administración de roles": se trata de un único rol para concederle permisos para modificar cualquier grupo de distribución de Exchange en lugar de ser propietario de todos los grupos de distribución que necesita modificar.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ExchangeRemoveDistributionGroupMemberResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Quitar miembro de Office 365 del grupo de distribución

Quite un miembro de un grupo de distribución de Microsoft Exchange Online u Office 365 o un grupo de seguridad habilitado para correo.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del grupo de distribución
GroupIdentity True string

Identidad del grupo de distribución o del grupo de seguridad habilitado para correo que se va a quitar. Puede especificar un grupo de distribución por Nombre, Alias, Nombre distintivo (por ejemplo, CN=MyGroup,OU=Mis grupos,DC=mydomain,DC=local), Dirección de correo electrónico o GUID.

Miembro que se va a quitar
Member True string

Identidad del miembro que se va a quitar del grupo de distribución o del grupo de seguridad habilitado para correo. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Omitir la comprobación del administrador de grupos de seguridad
BypassSecurityGroupManagerCheck boolean

Si la cuenta de automatización del agente de IA-Connect no es propietario del grupo de distribución o del grupo de seguridad habilitado para correo, no podrá quitar un miembro del grupo. Si establece esta opción en true (el valor predeterminado), se omitirá la comprobación del propietario, pero requiere que la cuenta de automatización esté en el grupo de roles "Administración de la organización" de Exchange o que tenga asignado el rol "Administración de roles", es un único rol para concederle permisos para modificar cualquier grupo de Office 355 Exchange Online en lugar de ser propietario de todos los grupos que necesita modificar.

Excepción si el miembro no está en el grupo
ExceptionIfMemberNotInGroup boolean

¿Debería producirse una excepción si el miembro no está en el grupo? Establézcalo en false (el valor predeterminado) para simplemente hacer nada si el miembro no está en el grupo (por ejemplo, puede que ya se haya quitado o nunca se haya quitado en el grupo). Se establece en true si el miembro que no está en el grupo es un error (es decir, se esperaba que estuviera en el grupo).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
O365RemoveDistributionGroupMemberResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Quitar miembro del grupo de Active Directory

Quita un miembro de Active Directory (usuario, grupo o equipo) de un grupo de Active Directory.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de grupo
GroupIdentity string

Identidad del grupo de Active Directory. Puede especificar un grupo por Nombre distintivo (por ejemplo, CN=Group1,OU=Mis grupos,DC=mydomain,DC=local), GUID, SID o SAMAccountName/nombre de pre-2K (por ejemplo, "Group1"). No puede usar el nombre para mostrar o el nombre del grupo (aunque el nombre del grupo suele ser el mismo que el nombre anterior a 2K que se puede usar).

Nombre del grupo
GroupName string

Como alternativa a la búsqueda por identidad, proporcione el nombre anterior a 2K (SAMAccountName) del grupo de Active Directory. Dado que la entrada "Identidad de grupo" también acepta el nombre anterior a 2K, esta entrada ahora es redundante, pero se mantiene para la compatibilidad con versiones anteriores.

Miembro del grupo
UserIdentity True string

Miembro del grupo que se va a quitar. Puede especificar un usuario o grupo por Nombre distintivo (por ejemplo, CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID o SAMAccountName/pre-2K (por ejemplo, "User1"). Puede especificar un equipo por Nombre distintivo o nombre de equipo (antes de 2K) seguido de $ (por ejemplo, VM01$).

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectoryRemoveADGroupMemberByGroupIdentityResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Quitar varios miembros del grupo de Active Directory

Quite uno o varios objetos de Active Directory (normalmente usuarios, grupos o equipos) de un grupo de Active Directory existente. IA-Connect quita tantos miembros del grupo como sea posible e informa sobre el resultado. Si el grupo y el miembro del grupo están en dominios diferentes, deberá especificar el nombre distintivo (DN) para los miembros y el grupo. Si algunos de los objetos no son miembros del grupo, se cuenta como un éxito.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de grupo
GroupIdentity string

Identidad del grupo de Active Directory. Puede especificar un grupo por Nombre distintivo (por ejemplo, CN=Group1,OU=Mis grupos,DC=mydomain,DC=local), GUID, SID o SAMAccountName/nombre de pre-2K (por ejemplo, "Group1"). No puede usar el nombre para mostrar o el nombre del grupo (aunque el nombre del grupo suele ser el mismo que el nombre anterior a 2K que se puede usar).

Miembros del grupo
GroupMembersJSON string

Lista de los miembros (normalmente usuarios, grupos o equipos) que se van a quitar del grupo de AD, en formato JSON o CSV. Por ejemplo: [{"MemberName": "Usuario 1"}, {"MemberName": "Usuario 2"}] (formato de tabla JSON), ["Usuario 1", "Usuario 2"] (formato de matriz JSON) o Usuario 1,Usuario 2 (formato CSV). Puede especificar un usuario o grupo por Nombre distintivo (por ejemplo, CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID o SAMAccountName/pre-2K (por ejemplo, "User1"). Puede especificar un equipo por Nombre distintivo o nombre de equipo (antes de 2K) seguido de $ (por ejemplo, VM01$).

Excepción si algún miembro no puede quitar
ExceptionIfAnyMembersFailToRemove boolean

Si se establece en true: se generará una excepción (error) si algún miembro único no puede quitar (es decir, 100% correcto es un requisito). Si no se produce ninguna excepción, esta acción notificará cuántos miembros se quitaron correctamente y cuántos no se pudieron quitar.

Excepción si todos los miembros no se pueden quitar
ExceptionIfAllMembersFailToRemove boolean

Si se establece en true: solo se generará una excepción (error) si todos los miembros no se pueden quitar (es decir, sin éxitos y algunos errores). Si no se produce ninguna excepción, esta acción notificará cuántos miembros se quitaron correctamente y cuántos no se pudieron quitar.

Quitar todos los miembros de una sola llamada
RemoveAllMembersInASingleCall boolean

Si se establece en true, todos los miembros se quitarán del grupo en una sola acción. Esto será más rápido, pero si no existe un solo miembro o no se puede quitar, no se quitará ningún miembro y se generará una excepción, independientemente de las opciones de entrada "Excepción". Si se establece en false (valor predeterminado), cada miembro se quitará individualmente y el agente de IA-Connect contará cuántos se quitaron correctamente y cuántos no se pudieron quitar. Si quita miembros de grupos entre dominios, se recomienda establecer esta entrada en false.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Los miembros del grupo de AD se quitaron correctamente
ADGroupMembersRemovedSuccessfully integer

Número de miembros eliminados correctamente del grupo de AD.

No se pudieron quitar los miembros del grupo de AD
ADGroupMembersFailedToRemove integer

Número de miembros que no se pudieron quitar del grupo de AD.

Mensaje de error Quitar miembros del grupo de AD
RemoveADGroupMembersMasterErrorMessage string

Si algunos miembros no se pudieron quitar del grupo de AD y no se generó ninguna excepción, este mensaje de error proporciona detalles del problema.

Realizar Active Directory DirSync

Realiza una sincronización entre Active Directory (local) y Azure Active Directory (nube). Este comando se debe emitir al servidor con el rol "DirSync" (es decir, el equipo que realiza la sincronización).

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de directiva
PolicyType string

Tipo de sincronización que se va a realizar. Las opciones son "Delta" para realizar una sincronización de cambios desde la última sincronización (la opción predeterminada) y "Inicial" para realizar una sincronización completa (no haga esto a menos que sepa exactamente lo que está haciendo).

Nombre del equipo
ComputerName string

Servidor que tiene el rol "DirSync" (es decir, el equipo que realiza la sincronización).

Número máximo de reintentos
MaxRetryAttempts integer

Si la sincronización de directorios recibe un error ocupado o de tiempo de espera, puede pausar y volver a intentarlo. Esta entrada especifica el número máximo de reintentos. Establezca en 0 para deshabilitar los reintentos. Tenga en cuenta los posibles tiempos de espera de acción IA-Connect si establece este valor demasiado alto.

Segundos entre reintentos
SecondsBetweenRetries integer

Si el Agente vuelve a intentar una sincronización de directorios, cuántos segundos deben haber entre reintentos. Si se establece en un valor menor que 1, el Agente omite esta entrada y usa un valor de 1 segundo.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de resultado de DirSync
PowerShellJSONOutput string

Resultado de la operación de sincronización de Active Directory, en formato JSON.

Recuperación de la pertenencia a grupos de distribución de buzones de Microsoft Exchange

Recupere los grupos de distribución a los que pertenece un buzón.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Microsoft Exchange. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de resultados de búsqueda
PowerShellJSONOutput string

Una lista de los grupos de distribución de Microsoft Exchange del buzón es miembro, en formato JSON.

Recuento de grupos de distribución encontrados
CountOfDistributionGroupsFound integer

El número de grupos de distribución de Microsoft Exchange del que es miembro el buzón.

Recuperar detalles del grupo de distribución de Microsoft Exchange

Recupere los detalles de un grupo de distribución de Microsoft Exchange. Puede buscar por Identidad o mediante un filtro. Una búsqueda de identidad debe devolver 0 o 1 resultados. Una búsqueda de filtro podría devolver 0 o más resultados.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del grupo de distribución
Identity string

Identidad del grupo de distribución que se va a buscar. Puede especificar un grupo de distribución por Nombre, Alias, Nombre distintivo (por ejemplo, CN=MyGroup,OU=Mis grupos,DC=mydomain,DC=local), Dirección de correo electrónico o GUID.

Nombre de propiedad de filtro
FilterPropertyName string

Como alternativa a la búsqueda por identidad, proporcione el nombre de la propiedad para filtrar los grupos de distribución por. Los nombres de propiedad comunes son: DisplayName, Name, GroupType, PrimarySMTPAddress. Si usa un filtro, también debe rellenar los campos "Comparación de propiedades filter" y "Valor de propiedad Filter".

Comparación de propiedades de filtro
FilterPropertyComparison string

Si la búsqueda por filtro como alternativa a la búsqueda por identidad, escriba el tipo de comparación aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", la comparación podría ser "equals" o "like"). Si desea escribir un filtro sin formato (en formato OPATH), elija un tipo de comparación de "Raw: Enter filter manualmente" y escriba el filtro completo en el campo "Filter property value".

Valor de la propiedad Filter
FilterPropertyValue string

Si busca por filtro como alternativa a la búsqueda por identidad, escriba el valor de la propiedad filter aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", el valor de la propiedad de filtro podría ser "JohnDoe").

No se produce ninguna excepción
NoResultIsAnException boolean

Establézcalo en true para generar una excepción si no se encuentra ningún grupo de distribución. Establézcalo en false para simplemente notificar un recuento de 0 si no se encuentra ningún grupo de distribución. Tenga en cuenta que la opción "false" puede no funcionar cuando se usa con Identity en idiomas que no son en inglés, por lo que considere la posibilidad de buscar mediante filtros en su lugar.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de resultados de búsqueda
PowerShellJSONOutput string

Lista de grupos de distribución de Microsoft Exchange que coinciden con la identidad o filtro de búsqueda, en formato JSON.

Recuento de grupos de distribución encontrados
CountOfDistributionGroupsFound integer

Número de grupos de distribución de Microsoft Exchange encontrados que coinciden con la identidad o filtro de búsqueda. Normalmente 1.

Recuperar direcciones de correo electrónico de buzón de Microsoft Exchange

Recupera una lista de todas las direcciones de correo electrónico asignadas a un buzón de Microsoft Exchange. Esto incluye la dirección SMTP principal, las direcciones de correo electrónico proxy, las direcciones X.400 y las direcciones EUM (mensajería unificada de Exchange).

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Microsoft Exchange. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Direcciones de correo electrónico de buzón
MailboxEmailAddresses array of string

Direcciones de correo electrónico del buzón. La dirección de correo electrónico SMTP principal aparecerá como SMTP:emailaddress, las direcciones de correo electrónico SMTP secundarias (proxy) aparecerán como smtp:emailaddress, las direcciones de correo electrónico X.400 aparecerán como direcciones x400:address y mensajería unificada de Exchange (EUM) como eum:address.

Recuperar direcciones de correo electrónico de buzón de Microsoft Exchange Online

Recupera una lista de todas las direcciones de correo electrónico asignadas a un buzón existente de Microsoft Exchange Online u Office 365 (remoto). Esto incluye la dirección SMTP principal, las direcciones de correo electrónico proxy, las direcciones X.400 y las direcciones EUM (mensajería unificada de Exchange). La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Correo de Microsoft Exchange Online u Office 365 (remoto). Puede especificar un buzón de Microsoft Exchange Online u Office 365 (remoto) por id. de objeto de Active Directory, alias, nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, email address, GUID o User Principal Name (UPN).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Direcciones de correo electrónico de buzón
MailboxEmailAddresses array of string

Direcciones de correo electrónico del buzón. La dirección de correo electrónico SMTP principal aparecerá como SMTP:emailaddress, las direcciones de correo electrónico SMTP secundarias (proxy) aparecerán como smtp:emailaddress, las direcciones de correo electrónico X.400 aparecerán como direcciones x400:address y mensajería unificada de Exchange (EUM) como eum:address.

Recuperar la pertenencia a grupos de distribución de buzones de Office 365

Recuperar de qué grupos de distribución o grupos de seguridad habilitados para correo es miembro un buzón de Office 365 o Exchange Online.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
MailboxIdentity True string

Identificador de un buzón de Microsoft Exchange Online u Office 365. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Propiedades que se van a recuperar
PropertiesToRetrieveJSON string

Lista de propiedades de miembro que se van a recuperar, en formato JSON o CSV. Por ejemplo: ["Identity", "DistinguishedName"] (formato de matriz JSON) o "Identity","DistinguishedName" (formato CSV). Entre las propiedades de grupo comunes se incluyen: Alias, DisplayName, DistinguishedName, GroupType, Identity, Name, PrimarySmtpAddress y SamAcountName. Si deja este campo en blanco, se recupera un conjunto predeterminado de propiedades.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de resultados de búsqueda
PowerShellJSONOutput string

Una lista de grupos de distribución de Office 365 o Exchange Online o grupos de seguridad habilitados para correo, el buzón es miembro, en formato JSON.

Recuento de grupos de distribución encontrados
CountOfDistributionGroupsFound integer

El número de grupos de distribución de Office 365 o Exchange Online o grupos de seguridad habilitados para correo electrónico del buzón de correo es miembro.

Recuperar los detalles del buzón de Microsoft Exchange

Devuelve las propiedades del buzón de Exchange especificado. Puede buscar por Identidad o mediante un filtro. Una búsqueda de identidad debe devolver 0 o 1 resultados. Una búsqueda de filtro podría devolver 0 o más resultados.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity string

Identidad del buzón de Microsoft Exchange. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Nombre de propiedad de filtro
FilterPropertyName string

Como alternativa a la búsqueda por identidad, proporcione el nombre de la propiedad para filtrar los buzones por. Los nombres de propiedad comunes son: Name, Alias, PrimarySMTPAddress, DisplayName, SamAccountName. Si usa un filtro, también debe rellenar los campos "Comparación de propiedades filter" y "Valor de propiedad Filter".

Comparación de propiedades de filtro
FilterPropertyComparison string

Si la búsqueda por filtro como alternativa a la búsqueda por identidad, escriba el tipo de comparación aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", la comparación podría ser "equals" o "like"). Si desea escribir un filtro sin formato (en formato OPATH), elija un tipo de comparación de "Raw: Enter filter manualmente" y escriba el filtro completo en el campo "Filter property value".

Valor de la propiedad Filter
FilterPropertyValue string

Si busca por filtro como alternativa a la búsqueda por identidad, escriba el valor de la propiedad filter aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", el valor de la propiedad de filtro podría ser "JohnDoe").

Detalles del tipo de destinatario
RecipientTypeDetails string

Tipo de buzón que se va a buscar. Si este campo se deja en blanco, todos los tipos de buzón se incluirán en la búsqueda.

No se produce ninguna excepción
NoResultIsAnException boolean

Establézcalo en true para generar una excepción si no se encuentra ningún buzón. Establézcalo en false para simplemente notificar un recuento de 0 si no se encuentra ningún buzón. Tenga en cuenta que la opción "false" puede no funcionar cuando se usa con Identity en idiomas que no son en inglés, por lo que considere la posibilidad de buscar mediante filtros en su lugar.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de resultados de búsqueda
PowerShellJSONOutput string

Lista de buzones de Exchange (y sus propiedades solicitadas) que coinciden con la identidad de búsqueda, en formato JSON.

Recuento de buzones encontrados
CountOfMailboxesFound integer

Número de buzones de Exchange encontrados que coinciden con la identidad o filtro de búsqueda. Se espera un resultado si se busca por identidad. Se esperan 0 o más resultados si se busca por filtro.

Recuperar los detalles del buzón de Microsoft Exchange Online

Devuelve las propiedades del buzón especificado de Microsoft Exchange Online u Office 365 (remoto). La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida. Puede buscar por Identidad o mediante un filtro. Una búsqueda de identidad debe devolver 0 o 1 resultados. Una búsqueda de filtro podría devolver 0 o más resultados.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity string

Identidad del buzón de Correo de Microsoft Exchange Online u Office 365 (remoto). Puede especificar un buzón de Microsoft Exchange Online u Office 365 (remoto) por id. de objeto de Active Directory, alias, nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, email address, GUID o User Principal Name (UPN).

Nombre de propiedad de filtro
FilterPropertyName string

Como alternativa a la búsqueda por identidad, proporcione el nombre de la propiedad para filtrar los buzones por. Los nombres de propiedad comunes son: Name, Alias, PrimarySMTPAddress, DisplayName. Si usa un filtro, también debe rellenar los campos "Comparación de propiedades filter" y "Valor de propiedad Filter".

Comparación de propiedades de filtro
FilterPropertyComparison string

Si la búsqueda por filtro como alternativa a la búsqueda por identidad, escriba el tipo de comparación aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", la comparación podría ser "equals" o "like"). Si desea escribir un filtro sin formato (en formato OPATH), elija un tipo de comparación de "Raw: Enter filter manualmente" y escriba el filtro completo en el campo "Filter property value".

Valor de la propiedad Filter
FilterPropertyValue string

Si busca por filtro como alternativa a la búsqueda por identidad, escriba el valor de la propiedad filter aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", el valor de la propiedad de filtro podría ser "JohnDoe").

No se produce ninguna excepción
NoResultIsAnException boolean

Establézcalo en true para generar una excepción si no se encuentra ningún buzón. Establézcalo en false para simplemente notificar un recuento de 0 si no se encuentra ningún buzón. Tenga en cuenta que la opción "false" puede no funcionar cuando se usa con Identity en idiomas que no son en inglés, por lo que considere la posibilidad de buscar mediante filtros en su lugar.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
JSON de resultados de búsqueda
PowerShellJSONOutput string

Lista de buzones de Microsoft Exchange Online u Office 365 (y sus propiedades solicitadas) que coinciden con la identidad de búsqueda, en formato JSON.

Recuento de buzones encontrados
CountOfMailboxesFound integer

Número de buzones de Microsoft Exchange Online u Office 365 encontrados que coinciden con la identidad o filtro de búsqueda. Normalmente 1.

Restablecer las propiedades de un buzón de Microsoft Exchange

Establezca las propiedades especificadas de un buzón de Microsoft Exchange existente en blanco.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Microsoft Exchange. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Restablecer atributo personalizado 1
ResetCustomAttribute1 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 2
ResetCustomAttribute2 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 3
ResetCustomAttribute3 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 4
ResetCustomAttribute4 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 5
ResetCustomAttribute5 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 6
ResetCustomAttribute6 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 7
ResetCustomAttribute7 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 8
ResetCustomAttribute8 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 9
ResetCustomAttribute9 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 10
ResetCustomAttribute10 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 11
ResetCustomAttribute11 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 12
ResetCustomAttribute12 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 13
ResetCustomAttribute13 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 14
ResetCustomAttribute14 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 15
ResetCustomAttribute15 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ExchangeResetMailboxAttributesResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Restablecer las propiedades de un buzón de Microsoft Exchange Online

Establezca las propiedades especificadas de un buzón existente de Microsoft Exchange Online u Office 365 (remoto) en blanco. La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identidad del buzón de Correo de Microsoft Exchange Online u Office 365 (remoto). Puede especificar un buzón de Microsoft Exchange Online u Office 365 (remoto) por id. de objeto de Active Directory, alias, nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, email address, GUID o User Principal Name (UPN).

Restablecer atributo personalizado 1
ResetCustomAttribute1 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 2
ResetCustomAttribute2 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 3
ResetCustomAttribute3 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 4
ResetCustomAttribute4 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 5
ResetCustomAttribute5 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 6
ResetCustomAttribute6 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 7
ResetCustomAttribute7 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 8
ResetCustomAttribute8 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 9
ResetCustomAttribute9 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 10
ResetCustomAttribute10 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 11
ResetCustomAttribute11 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 12
ResetCustomAttribute12 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 13
ResetCustomAttribute13 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 14
ResetCustomAttribute14 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Restablecer atributo personalizado 15
ResetCustomAttribute15 boolean

Establezca en true si desea restablecer el campo de atributo personalizado (establecido en un valor en blanco).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ExchangeResetRemoteMailboxAttributesResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Restablecimiento de la contraseña de usuario de Active Directory

Restablece la contraseña de un usuario de Active Directory con una nueva contraseña y, opcionalmente, establece las propiedades de contraseña.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de usuario
UserIdentity True string

Identidad del usuario de Active Directory. Puede especificar un usuario por Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), GUID, SID, SAMAccountName/ nombre de pre-2K (por ejemplo, "Usuario1") o Nombre (por ejemplo, "Usuario1").

Nueva contraseña
NewPassword True password

Nueva contraseña. Debe especificarse y cumplir las reglas de complejidad de contraseñas de Active Directory. Si se trata de una contraseña "Almacenada", escriba en el formato {IAConnectPassword:StoredPasswordIdentifier} y establezca la entrada "contraseña almacenada" en true. Si se trata de una credencial genérica de Orchestrator, escriba en el formato {OrchestratorCredential:FriendlyName} y establezca la entrada "contraseña almacenada" en true.

La contraseña de la cuenta se almacena
AccountPasswordIsStoredPassword boolean

Establézcalo en true si la contraseña es un identificador de contraseña almacenado IA-Connect (por ejemplo, generado por la acción "Generar contraseña") o una credencial genérica de IA-Connect Orchestrator (por ejemplo, si usa IA-Connect con un flujo de PA).

Establecimiento de propiedades de contraseña de usuario
SetUserPasswordProperties boolean

Establezca en Sí (valor predeterminado) si desea establecer las propiedades de contraseña de usuario especificadas en adicionales para cambiar la contraseña. Las propiedades de contraseña de usuario son "Cambiar contraseña en el inicio de sesión", "El usuario no puede cambiar la contraseña" y "La contraseña nunca expira". Establezca en No para cambiar solo la contraseña del usuario, ignorando las demás entradas de esta acción.

El usuario debe cambiar la contraseña en el siguiente inicio de sesión
ChangePasswordAtLogon boolean

Establézcalo en Sí (valor predeterminado) si desea obligar al usuario a cambiar su contraseña cuando inicie sesión (es decir, la nueva contraseña que se establece aquí es una contraseña única para que el usuario inicie sesión). Establézcalo en No si se trata de la contraseña que usará el usuario hasta que la cambie manualmente. Establezca en blanco o vacío para dejar esta opción de contraseña sin cambios (nuevo en IA-Connect 9.4). No se puede establecer esta opción en Sí al mismo tiempo que establecer "El usuario no puede cambiar la contraseña" o "La contraseña nunca expira" en Sí.

El usuario no puede cambiar la contraseña
CannotChangePassword boolean

Establézcalo en Sí para impedir que el usuario pueda cambiar su contraseña. Establezca en No (valor predeterminado) si el usuario puede cambiar la contraseña. Establezca en blanco o vacío para dejar esta opción de contraseña sin cambios (nuevo en IA-Connect 9.4). No puede establecer esta opción en Sí al mismo tiempo que establecer "El usuario debe cambiar la contraseña en el siguiente inicio de sesión" en Sí.

La contraseña nunca expira
PasswordNeverExpires boolean

Establézcalo en Sí si la contraseña nunca expira (es decir, el usuario nunca se le pedirá que cambie la contraseña). Establezca en No (valor predeterminado) si la contraseña puede expirar como se establece en la directiva de dominio de Active Directory. Establezca en blanco o vacío para dejar esta opción de contraseña sin cambios (nuevo en IA-Connect 9.4). No puede establecer esta opción en Sí al mismo tiempo que establecer "El usuario debe cambiar la contraseña en el siguiente inicio de sesión" en Sí.

Restablecer la contraseña dos veces
ResetPasswordTwice boolean

Establezca en Sí para restablecer la contraseña dos veces, el primer restablecimiento es una selección aleatoria de la nueva contraseña solicitada (el mismo número de mayúsculas, minúsculas, números y los mismos símbolos, pero en orden aleatorio). Esto mitiga el riesgo de una vulnerabilidad pass-the-hash si está sincronizando este usuario con Azure Active Directory. Establézcalo en No (valor predeterminado) para establecer la contraseña solicitada sin establecer primero una contraseña desactivada.

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
ActiveDirectoryResetADUserPasswordByIdentityResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Restablecimiento de la contraseña de usuario de Azure AD

Restablece la contraseña de un usuario de Azure Active Directory con una nueva contraseña. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre principal del usuario
UserPrincipalName True string

Nombre de inicio de sesión de usuario en Azure Active Directory. Por lo general, debe estar en el formato "name@domainFQDN" (por ejemplo, "TestUser1@mydomain.onmicrosoft.com").

Nueva contraseña
NewPassword True password

Nueva contraseña. Debe especificarse y cumplir las reglas de complejidad de contraseñas de Azure Active Directory. Si se trata de una contraseña "Almacenada", escriba en el formato {IAConnectPassword:StoredPasswordIdentifier} y establezca la entrada "contraseña almacenada" en true. Si se trata de una credencial genérica de Orchestrator, escriba en el formato {OrchestratorCredential:FriendlyName} y establezca la entrada "contraseña almacenada" en true.

La contraseña de la cuenta se almacena
AccountPasswordIsStoredPassword boolean

Establézcalo en true si la contraseña es un identificador de contraseña almacenado IA-Connect (por ejemplo, generado por la acción "Generar contraseña") o una credencial genérica de IA-Connect Orchestrator (por ejemplo, si usa IA-Connect con un flujo de PA).

Forzar el cambio de contraseña en el siguiente inicio de sesión
ForceChangePasswordNextLogin boolean

Establézcalo en true si desea forzar al usuario a cambiar su contraseña cuando inicie sesión (es decir, la nueva contraseña que se establece aquí es una contraseña única para permitir que el usuario inicie sesión). Establézcalo en false si se trata de la contraseña que usará el usuario hasta que la cambie manualmente.

Aplicación de la directiva de cambio de contraseña
EnforceChangePasswordPolicy boolean

Establézcalo en true para aplicar la directiva de cambio de contraseña de Azure Active Directory que (dependiendo de su entorno) puede definir la frecuencia con la que el usuario debe cambiar su contraseña, las opciones de recuperación de contraseñas y la comprobación de seguridad adicional. Esto puede hacer que se solicite al usuario información adicional.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
AzureADv2ResetAzureADUserPasswordResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Restablecimiento de las propiedades de usuario de Azure AD

Restablezca las propiedades comunes de un usuario de Azure Active Directory a un valor en blanco. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
ObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Restablecer el nombre
ResetFirstName boolean

Establezca en true para restablecer el nombre del usuario en blanco.

Restablecer apellidos
ResetLastName boolean

Establézcalo en true para restablecer el nombre de familia / apellidos / apellidos del usuario en blanco.

Restablecer ciudad
ResetCity boolean

Establezca en true para restablecer el nombre de la ciudad en la que reside el usuario o donde se encuentra su oficina en blanco.

Restablecer el nombre de la empresa
ResetCompanyName boolean

Establézcalo en true para restablecer el nombre de la empresa para la que trabaja el usuario en blanco.

Restablecer país o región
ResetCountry boolean

Establézcalo en true para restablecer el país o región en el que reside el usuario, o donde se encuentra su oficina en blanco.

Restablecimiento del departamento
ResetDepartment boolean

Establézcalo en true para restablecer el nombre del departamento del que trabaja el usuario dentro de la Compañía en blanco.

Restablecer el número de fax
ResetFaxNumber boolean

Establézcalo en true para restablecer el número de teléfono de fax (facsimile) en blanco.

Restablecer el título del trabajo
ResetJobTitle boolean

Establezca en true para restablecer el título del trabajo del usuario en blanco.

Restablecer el número de teléfono móvil
ResetMobilePhone boolean

Establézcalo en true para restablecer el número de teléfono móvil del usuario en blanco.

Restablecer oficina
ResetOffice boolean

Establezca en true para restablecer el nombre de la oficina donde el usuario trabaja en blanco.

Restablecer número de teléfono
ResetPhoneNumber boolean

Establézcalo en true para restablecer el número de teléfono del usuario en blanco.

Restablecer código postal o postal
ResetPostalCode boolean

Establézcalo en true para restablecer el código postal o postal donde reside el usuario, o la oficina en la que trabaja en blanco.

Restablecer el idioma preferido
ResetPreferredLanguage boolean

Establezca en true para restablecer el idioma preferido del usuario en blanco.

Restablecer estado o provincia
ResetState boolean

Establézcalo en true para restablecer el estado, provincia o condado en el que reside el usuario, o donde se encuentra su oficina en blanco.

Restablecer dirección postal
ResetStreetAddress boolean

Establézcalo en true para restablecer la dirección postal donde reside el usuario o su dirección postal de oficina en blanco.

Restablecer la ubicación de uso
ResetUsageLocation boolean

Establézcalo en true para restablecer la ubicación de uso en blanco. Esto es necesario para los usuarios a los que se asignarán licencias debido a un requisito legal, por lo que es probable que el restablecimiento en blanco interrumpa las cosas.

Restablecer grupo de edad
ResetAgeGroup boolean

Establézcalo en true para restablecer el grupo de edad del usuario, con fines de control parental, en blanco.

Restablecimiento del consentimiento proporcionado para el menor
ResetConsentProvidedForMinor boolean

Establézcalo en true para restablecer si el consentimiento se ha proporcionado para el menor, con fines de control parental, en blanco.

Restablecer el identificador de empleado
ResetEmployeeId boolean

Establézcalo en true para restablecer el identificador de empleado en blanco. Puede usarlo para distinguir de forma única entre cada usuario de su organización.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Resultado del comando
AzureADv2ResetAzureADUserPropertiesResult boolean

Resultado del comando (correcto o erróneo).

Mensaje de error
ErrorMessage string

Si el comando no se realizó correctamente, contendrá el mensaje de error que se devolvió.

Usuario en el grupo de usuarios de Azure AD

Devuelve si un usuario es miembro de un grupo de Azure Active Directory. Esta acción usa módulos de PowerShell de usuarios de Azure AD v2 o Microsoft Graph, lo que se usó para conectarse a Azure.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de objeto de usuario o UPN
ObjectId True string

Identificador de un usuario de Azure Active Directory. Puede especificar un usuario por UPN (por ejemplo user@mydomain.onmicrosoft.com, ) o ObjectId (por ejemplo, UUID/valor GUID).

Id. de objeto de grupo o nombre para mostrar
GroupObjectId True string

Identificador o nombre para mostrar de un grupo de Azure Active Directory. Puede especificar un grupo por Nombre para mostrar (por ejemplo, "Usuarios financieros") o ObjectId (por ejemplo, UUID/valor GUID).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
El usuario está en grupo
UserIsInGroup boolean

Si el usuario es miembro del grupo de Azure AD.

¿Está instalado el módulo de PowerShell de Azure AD?

Informa si los módulos de PowerShell necesarios para Azure Active Directory (también conocido como Id. de Microsoft Entra, Azure AD o AAD) se instalan en el equipo donde se ejecuta el agente de IA-Connect. Esta acción comprueba los módulos de PowerShell de usuarios de Azure AD v2 y Microsoft Graph.

Parámetros

Nombre Clave Requerido Tipo Description
Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
El módulo de PowerShell de Azure AD v2 está instalado
AzureADv2PowerShellModuleInstalled boolean

Establézcalo en true si está instalado el módulo de PowerShell de Azure AD v2 (AzureAD).

El módulo de PowerShell de usuarios de Microsoft Graph está instalado
MSGraphUsersPowerShellModuleInstalled boolean

Establézcalo en true si se instalan los módulos de PowerShell de usuarios de Microsoft Graph (Microsoft.Graph.Users y Microsoft.Graph.Authentication).

¿Existe el buzón de Microsoft Exchange Online?

Devuelve si existe el buzón especificado de Microsoft Exchange Online u Office 365 (remoto). La solicitud se envía a través del servidor local de Microsoft Exchange que debe configurarse para una implementación híbrida.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity string

Identidad del buzón de Correo de Microsoft Exchange Online u Office 365 (remoto). Puede especificar un buzón de Microsoft Exchange Online u Office 365 (remoto) por id. de objeto de Active Directory, alias, nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, email address, GUID o User Principal Name (UPN).

Nombre de propiedad de filtro
FilterPropertyName string

Como alternativa a la búsqueda por identidad, proporcione el nombre de la propiedad para filtrar los buzones por. Los nombres de propiedad comunes son: Name, Alias, PrimarySMTPAddress, DisplayName. Si usa un filtro, también debe rellenar los campos "Comparación de propiedades filter" y "Valor de propiedad Filter".

Comparación de propiedades de filtro
FilterPropertyComparison string

Si la búsqueda por filtro como alternativa a la búsqueda por identidad, escriba el tipo de comparación aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", la comparación podría ser "equals" o "like"). Si desea escribir un filtro sin formato (en formato OPATH), elija un tipo de comparación de "Raw: Enter filter manualmente" y escriba el filtro completo en el campo "Filter property value".

Valor de la propiedad Filter
FilterPropertyValue string

Si busca por filtro como alternativa a la búsqueda por identidad, escriba el valor de la propiedad filter aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", el valor de la propiedad de filtro podría ser "JohnDoe").

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
El buzón existe
MailboxExists boolean

True si existe el buzón de Microsoft Exchange Online. False si el buzón de Microsoft Exchange Online no existe.

¿Existe el buzón de Microsoft Exchange?

Devuelve si existe el buzón de Exchange especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity string

Identidad del buzón de Microsoft Exchange. Puede especificar un buzón por Nombre, Alias, Nombre distintivo (por ejemplo, CN=User1,OU=Mis usuarios,DC=mydomain,DC=local), DOMAIN\username, Dirección de correo electrónico, GUID, SAMAccountName o Nombre principal de usuario (UPN).

Nombre de propiedad de filtro
FilterPropertyName string

Como alternativa a la búsqueda por identidad, proporcione el nombre de la propiedad para filtrar los buzones por. Los nombres de propiedad comunes son: Name, Alias, PrimarySMTPAddress, DisplayName, SamAccountName. Si usa un filtro, también debe rellenar los campos "Comparación de propiedades filter" y "Valor de propiedad Filter".

Comparación de propiedades de filtro
FilterPropertyComparison string

Si busca por "Filter property name" como alternativa a la búsqueda por identidad, escriba el tipo de comparación aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", la comparación podría ser "equals" o "like"). Si desea escribir un filtro sin formato (en formato OPATH), elija un tipo de comparación de "Raw: Enter filter manualmente" y escriba el filtro completo en el campo "Filter property value".

Valor de la propiedad Filter
FilterPropertyValue string

Si busca por filtro como alternativa a la búsqueda por identidad, escriba el valor de la propiedad filter aquí (por ejemplo: Si el nombre de la propiedad de filtro es "Alias", el valor de la propiedad de filtro podría ser "JohnDoe").

Detalles del tipo de destinatario
RecipientTypeDetails string

Tipo de buzón que se va a buscar. Si este campo se deja en blanco, todos los tipos de buzón se incluirán en la búsqueda.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
El buzón existe
MailboxExists boolean

True si existe el buzón de Exchange. False si el buzón de Exchange no existe.

¿Existe un grupo de Active Directory?

Devuelve si existe un grupo de Active Directory especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad de grupo
GroupIdentity True string

Identidad del grupo de Active Directory. Puede especificar un grupo por Nombre distintivo (por ejemplo, CN=Group1,OU=Mis grupos,DC=mydomain,DC=local), GUID, SID o SAMAccountName/nombre de pre-2K (por ejemplo, "Group1"). No puede usar el nombre para mostrar o el nombre del grupo (aunque el nombre del grupo suele ser el mismo que el nombre anterior a 2K que se puede usar).

Servidor de AD
ADServer string

Nombre opcional o Nombre de dominio completo (FQDN) de un controlador de dominio (DC) de Active Directory con el que se debe ponerse en contacto para realizar la acción solicitada. Si se deja en blanco, el controlador de dominio (DC) de Active Directory se determina automáticamente mediante la configuración del sitio.

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
Existe un grupo de AD
ADGroupExists boolean

Esta salida devuelve true si el grupo de AD existe, false si el grupo de AD no lo hace.

DN del grupo de AD
ADGroupDN string

Si el grupo de AD existe, esta salida contiene el grupo Nombre distintivo (DN).

¿Tiene un buzón de Office 365 un archivo?

Informa de si un buzón existente en Microsoft Exchange Online tiene un buzón de archivo. Si el buzón no existe, se producirá una excepción.

Parámetros

Nombre Clave Requerido Tipo Description
Identidad del buzón
Identity True string

Identificador de un buzón de Microsoft Exchange Online u Office 365. Puede especificar un buzón por Nombre, Alias, Id. de objeto (por ejemplo, UUID/VALOR GUID), Dirección de correo electrónico, GUID, SAMAccountName (incluso los usuarios de entornos conectados que no son de Active Directory tienen samAccountName) o nombre principal de usuario (UPN).

Flujo de trabajo
Workflow True string

Agregue la siguiente expresión aquí: workflow()

Devoluciones

Nombre Ruta de acceso Tipo Description
El buzón tiene un archivo
MailboxHasAnArchive boolean

Establézcalo en true si el buzón tiene un archivo.