- Información general
- Comience ya
- Conceptos
- Uso de UiPath CLI
- Guías prácticas
- Recetas de CI/CD
- Referencia de los comandos
- Información general
- Códigos de salida
- Opciones globales
- agente de código UIP
- codificador UIP
- Contextualización de UIP
- UIP Docsai
- Función uip
- barreras de seguridad de UIP
- Configuración de UIP llm
- puerta de enlace llm de uip
- Creación de UIP Maestro
- Registro maestro de UIP
- UIP model-hub
- Actividades Buscar
- actividades get-default-xaml
- Analizar
- lista de reglas del analizador
- Crear
- Limpieza
- instalación de data-fabric-entities
- lista de entidades de data-fabric
- diferencia de archivos
- obtener-repositorio-de-objetos-de-biblioteca
- obtener-objeto-repositorio
- Init
- lista de instancias
- Paquete
- inspeccionar paquetes
- instalación de paquetes
- versiones de paquetes
- Publicar
- Remoto
- restore
- ejecutar, depurar & Ejecución
- Configuración
- Inicio de Studio
- Búsqueda de plantillas
- entidad de adición de datos de prueba
- añadir-cola de datos de prueba
- añadir-variación de los datos de prueba
- TM
- UIA
- Validar
- ejemplos-de-flujo-de-flujo-obtener
- lista de ejemplos de flujo de trabajo
- Tareas de UIP
- Archivo adjunto
- Campo personalizado
- Defects
- Ejecuciones
- exportar-trabajos
- Migración
- EtiquetaDeObjeto
- Paquete
- escenario de rendimiento
- grupos de carga de escenarios de rendimiento
- datos de ejecución de perf-scenario
- informe de escenario de rendimiento
- Proyecto
- permisos del proyecto
- Solicitudes
- Informar
- Requisitos
- Resultado
- Iniciar
- Programaciones
- Registro de casos de prueba
- Casos de prueba
- Conjuntos de prueba
- registro de pasos de prueba
- Usuario
- Esperar
- Seguimientos de UIP
- Comentarios de seguimientos de UIP
- Migración
- Referencia y soporte
auditoría de administración de UIP
Sintaxis y opciones para `auditoría de administración de UIP`, que consulta y exporta eventos de auditoría de administración de UiPath en el ámbito de la organización y el tenant, y gestiona las reglas de exclusión de auditoría de la organización.
uip admin audit consulta y exporta eventos de auditoría de UiPath : el seguimiento de auditoría de administración a nivel de plataforma (distinto de uip or audit-logs, que cubre los cambios de entidad de Orchestrator). Parte de uip admin (descripción general), la herramienta de administración de UiPath.
Dos subgrupos de ámbito registran la forma de lectura idéntica de tres verbos (sources, events, export):
org: auditoría del ámbito de la organización (eventos de administración que son independientes del tenant).tenant: auditoría con ámbito de tenant (eventos con ámbito en el tenant de inicio de sesión activo, o--tenant-id).
The org subgroup also has an exclusions subgroup, which manages the rules that stop matching events from being recorded. There is no tenant-scoped exclusions subgroup. A rule names the tenants it applies to with --exclude-tenant.
Flujo de trabajo típico: audit <scope> sources (descubrir ID de origen) → audit <scope> events --source <guid> --from-date … --to-date … (encontrar las filas) → audit <scope> export --from-date … --to-date … --output-path … (descargarlas).
Sinopsis
uip admin audit org sources [--login-validity <minutes>]
uip admin audit org events [--from-date <iso>] [--to-date <iso>] [--source <guid>...] [--target <guid>...] [--type <guid>...] [--user-id <guid>...] [--search <term>] [--status Success|Failure] [--limit <n>]
uip admin audit org export --from-date <iso> --to-date <iso> --output-path <dir> [--file-format json|csv]
uip admin audit tenant sources [--tenant-id <guid>] [--login-validity <minutes>]
uip admin audit tenant events [--tenant-id <guid>] [... same filters as org events]
uip admin audit tenant export [--tenant-id <guid>] --from-date <iso> --to-date <iso> --output-path <dir> [--file-format json|csv]
uip admin audit org exclusions list
uip admin audit org exclusions get <rule>
uip admin audit org exclusions create --name <name> [--exclude-tenant <guid>...] [--source <guid>...] [--target <guid>...] [--type <guid>...] [--status Success|Failure] [--inactive]
uip admin audit org exclusions create --file <path>
uip admin audit org exclusions update <rule> --name <name> [selector flags as for create] [--inactive]
uip admin audit org exclusions update <rule> --file <path>
uip admin audit org exclusions delete <rule>
uip admin audit org sources [--login-validity <minutes>]
uip admin audit org events [--from-date <iso>] [--to-date <iso>] [--source <guid>...] [--target <guid>...] [--type <guid>...] [--user-id <guid>...] [--search <term>] [--status Success|Failure] [--limit <n>]
uip admin audit org export --from-date <iso> --to-date <iso> --output-path <dir> [--file-format json|csv]
uip admin audit tenant sources [--tenant-id <guid>] [--login-validity <minutes>]
uip admin audit tenant events [--tenant-id <guid>] [... same filters as org events]
uip admin audit tenant export [--tenant-id <guid>] --from-date <iso> --to-date <iso> --output-path <dir> [--file-format json|csv]
uip admin audit org exclusions list
uip admin audit org exclusions get <rule>
uip admin audit org exclusions create --name <name> [--exclude-tenant <guid>...] [--source <guid>...] [--target <guid>...] [--type <guid>...] [--status Success|Failure] [--inactive]
uip admin audit org exclusions create --file <path>
uip admin audit org exclusions update <rule> --name <name> [selector flags as for create] [--inactive]
uip admin audit org exclusions update <rule> --file <path>
uip admin audit org exclusions delete <rule>
tenant verbos además aceptan --tenant-id <guid> para anular el tenant de su contexto de inicio de sesión; org verbos no (el ámbito de la organización no tiene tenant que anular).
fuentes de la organización de auditoría de administración de uip / fuentes de tenant de auditoría de administración de uip
Enumera los orígenes de eventos de auditoría visibles en este ámbito: cada origen es una categoría de evento de nivel superior (por ejemplo, Identity, Tenant, Robot). Utiliza los valores Id devueltos con events --source <guid>.
Opciones
| Largo | Valor | Descripción |
|---|---|---|
--tenant-id <guid> | GUID | (solo ámbito tenant ). Anula el tenant desde el contexto de inicio de sesión. |
--login-validity <minutes> | Entero | Anula la vigencia del token de inicio de sesión interactivo para esta llamada. Rara vez es necesario. |
Ejemplo
uip admin audit org sources
uip admin audit org sources
Forma de datos (--json de salida)
{
"Code": "AuditOrgSources",
"Data": [
{ "Id": "11111111-1111-1111-1111-111111111111", "Name": "Identity", "EventTargets": [] }
]
}
{
"Code": "AuditOrgSources",
"Data": [
{ "Id": "11111111-1111-1111-1111-111111111111", "Name": "Identity", "EventTargets": [] }
]
}
Code es AuditTenantSources bajo tenant.
eventos de organización de auditoría de administración de uip / eventos de tenant de auditoría de administración de uip
Consultar eventos de auditoría en este ámbito, paginado. Devuelve { AuditEvents, Next, Previous } , no una matriz vacía. La denominación del cursor es cronológica: Next son eventos más nuevos, Previous es más antiguo. Cuando --limit supera 200, la CLI pagina internamente (siguiendo el cursor de eventos más antiguos) ya que el servidor limita cada llamada a 200 filas.
Opciones
| Largo | Valor | Descripción |
|---|---|---|
--from-date <iso> | ISO 8601 | Inicio del intervalo de tiempo. Inclusivo. |
--to-date <iso> | ISO 8601 | Fin del intervalo de tiempo. Inclusivo. |
--source <guid> | GUID, repetible | Filtrar por ID de origen de eventos. Descubrir con sources. |
--target <guid> | GUID, repetible | Filtrar por ID de destino de evento. |
--type <guid> | GUID, repetible | Filtrar por ID de tipo de evento. |
--user-id <guid> | GUID, repetible | Filtrar por ID de usuario activos. |
--search <term> | String | Búsqueda de subcadenas del lado del servidor. |
--status <status> | Success | Failure | Filtro de estado de evento que no distingue entre mayúsculas y minúsculas. |
--limit <n> | Entero | Total de eventos para devolver, 1–10000. Los valores superiores a 200 están paginados en el lado del cliente (el servidor limita cada llamada a 200). |
--tenant-id <guid> | GUID | (solo ámbito tenant ). Anula el tenant desde el contexto de inicio de sesión. |
--login-validity <minutes> | Entero | Anula la vigencia del token de inicio de sesión interactivo para esta llamada. Rara vez es necesario. |
Ejemplos
# Fetch the latest 50 org audit events
uip admin audit org events --limit 50
# Fetch the latest 50 org audit events
uip admin audit org events --limit 50
# Filter by source and a 7-day window
uip admin audit tenant events --source 11111111-1111-1111-1111-111111111111 \
--from-date 2026-04-22T00:00:00Z --to-date 2026-04-29T00:00:00Z
# Filter by source and a 7-day window
uip admin audit tenant events --source 11111111-1111-1111-1111-111111111111 \
--from-date 2026-04-22T00:00:00Z --to-date 2026-04-29T00:00:00Z
Forma de datos (--json de salida)
{
"Code": "AuditOrgEvents",
"Data": { "AuditEvents": [], "Next": null, "Previous": null }
}
{
"Code": "AuditOrgEvents",
"Data": { "AuditEvents": [], "Next": null, "Previous": null }
}
Code es AuditTenantEvents bajo tenant.
exportación de la organización de auditoría de administración de uip/exportación del tenant de auditoría de administración de uip
Exporta eventos de auditoría desde el almacén a largo plazo. Emite una llamada HTTP por día UTC dentro de [--from-date, --to-date] y agrega los resultados en la memoria antes de escribir algo: primero se obtiene la ventana completa y, en cualquier fallo de un solo día, la exportación se aborta de forma atómica (no se escribe nada; el fallo nombra el día que fallido).
--output-path un directorio base, no una ruta de archivo: pasa una carpeta y CLI genera una salida con nombre único dentro de ella, marcada con la ventana y el tiempo de generación (por ejemplo audit_2026-01-01_2026-02-01_20260617T112630), por lo que las exportaciones repetidas de la misma ventana nunca colisionan:
--file-format json(predeterminado): una carpeta de un archivo JSON por día UTC.--file-format csv: un único archivo CSV con cada evento fusionado bajo un encabezado compartido.
Opciones
| Largo | Valor | Obligatorio | Descripción |
|---|---|---|---|
--from-date <iso> | ISO 8601 | Sí | Inicio del intervalo de tiempo. |
--to-date <iso> | ISO 8601 | Sí | Fin del intervalo de tiempo. |
--output-path <dir> | Ruta | condicionalmente | Directorio base para la exportación (creado si falta). Pasa solo un directorio, nunca un nombre de archivo: la CLI nombra la salida por ti. Obligatorio a menos que se pase --output-file (alias obsoleto) en su lugar. |
--output-file <dir> | Ruta | No | Alias obsoleto para --output-path. A pesar del nombre, se sigue tratando como un directorio base. Cuando se pasan ambos, --output-path gana y se registra una advertencia de obsolescencia. |
--file-format <format> | json | csv | No | Forma de salida. Predeterminado json. |
--tenant-id <guid> | GUID | No | (solo ámbito tenant ). Anula el tenant desde el contexto de inicio de sesión. |
--login-validity <minutes> | Entero | No | Anula la vigencia del token de inicio de sesión interactivo para esta llamada. Rara vez es necesario. |
Ejemplos
# JSON export — a timestamped folder of day-wise JSON files is created under the base dir
uip admin audit org export --from-date 2026-01-01 --to-date 2026-02-01 --output-path ./audit-exports
# JSON export — a timestamped folder of day-wise JSON files is created under the base dir
uip admin audit org export --from-date 2026-01-01 --to-date 2026-02-01 --output-path ./audit-exports
# CSV export — a single uniquely-named .csv file under the base dir
uip admin audit tenant export --from-date 2026-01-01 --to-date 2026-02-01 \
--file-format csv --output-path ./audit-exports
# CSV export — a single uniquely-named .csv file under the base dir
uip admin audit tenant export --from-date 2026-01-01 --to-date 2026-02-01 \
--file-format csv --output-path ./audit-exports
Forma de datos (--json de salida)
Formato JSON:
{
"Code": "AuditOrgExport",
"Data": {
"Path": "./audit-exports/audit_2026-01-01_2026-02-01_20260617T112630",
"Format": "json",
"Files": 27,
"Bytes": 12345,
"Days": 31,
"NonEmptyDays": 27,
"GeneratedAt": "2026-06-17T11:26:30.000Z"
}
}
{
"Code": "AuditOrgExport",
"Data": {
"Path": "./audit-exports/audit_2026-01-01_2026-02-01_20260617T112630",
"Format": "json",
"Files": 27,
"Bytes": 12345,
"Days": 31,
"NonEmptyDays": 27,
"GeneratedAt": "2026-06-17T11:26:30.000Z"
}
}
El formato CSV añade un recuento Events en lugar de Files:
{
"Code": "AuditOrgExport",
"Data": {
"Path": "./audit-exports/audit_2026-01-01_2026-02-01_20260617T112630.csv",
"Format": "csv",
"Bytes": 98765,
"Days": 31,
"NonEmptyDays": 27,
"Events": 1234,
"GeneratedAt": "2026-06-17T11:26:30.000Z"
}
}
{
"Code": "AuditOrgExport",
"Data": {
"Path": "./audit-exports/audit_2026-01-01_2026-02-01_20260617T112630.csv",
"Format": "csv",
"Bytes": 98765,
"Days": 31,
"NonEmptyDays": 27,
"Events": 1234,
"GeneratedAt": "2026-06-17T11:26:30.000Z"
}
}
Code es AuditTenantExport bajo tenant.
exclusiones de la organización de auditoría de administrador de uip
Gestiona las reglas de exclusión de auditoría de la organización, que definen los eventos que la pista de auditoría deja de registrar.
Una regla lleva como máximo un selector por dimensión: Tenant, EventSource, EventTarget, EventType y Status. Los valores dentro de un selector tienen OR, y los selectores tienen AND: --type A --type B --status Success excluye los eventos exitosos de tipo A o tipo B. Se rechaza una regla sin selector, porque excluiría todos los eventos.
La exclusión comienza cuando una regla se activa y nunca es retroactiva. Los eventos que ya están en el seguimiento permanecen allí, y al ampliar el conjunto de coincidencias de una regla se restablece su hora de inicio de exclusión. Una regla inactiva no excluye nada, por lo que puedes organizar un reemplazo junto a la regla a la que reemplaza.
Los propios eventos de supervisión de UiPath y los cambios de configuración de auditoría, incluidos los cambios en las propias reglas de exclusión, nunca pueden excluirse.
get, update y delete toman un posicional <rule> : el nombre de la regla o su ID de política. Un nombre es único solo entre las reglas activas. Si una regla inactiva comparte el nombre, la CLI solicita el ID de la política en lugar de elegir uno. Se rechaza un nombre de regla con forma de GUID.
Leer reglas requiere permiso de lectura de auditoría. La creación, actualización y eliminación de reglas requiere un token de usuario cuya identidad esté en el grupo Administradores. Los tokens de servicio a servicio se rechazan en las escrituras.
Opciones de escritura (crear y actualizar)
create y update aceptan las mismas opciones. Transmite --file o los marcadores en línea, no ambos.
| Largo | Valor | Descripción |
|---|---|---|
--name <name> | String | Rule name, unique among the organization's active rules. Maximum 256 characters. Required unless --file is passed. |
--exclude-tenant <guid...> | GUID, repetible | Tenant selector: exclude events from these tenants only. A tenant outside the organization is accepted but matches nothing. |
--source <guid...> | GUID, repetible | EventSource selector. Descubrir ID con uip admin audit org sources. |
--target <guid...> | GUID, repetible | EventTarget selector. Descubrir ID con uip admin audit org sources. |
--type <guid...> | GUID, repetible | EventType selector. Descubrir ID con uip admin audit org sources. |
--status <status> | Success | Failure | Status selector, no distingue entre mayúsculas y minúsculas. También se aceptan 0 y 1 . De un solo valor. |
--inactive | Marca | Guarda la regla sin activarla. Una regla inactiva no excluye nada y puede reutilizar el nombre o el conjunto de coincidencias de una regla activa. |
--file <path> | Ruta | Archivo JSON que contiene todo el cuerpo de la regla. Mutuamente excluyente con los marcadores anteriores. |
--login-validity <minutes> | Entero | Anula la vigencia del token de inicio de sesión interactivo para esta llamada. Rara vez es necesario. |
Pase al menos un marcador de selector. Los valores del selector son GUID, excepto para --status.
A --file body accepts only the name, enforcement, isActive, and selectors keys. Each selector carries a type (one of the dimension names) and a non-empty values array. enforcement defaults to Exclude, the only accepted value, and isActive defaults to true. Server-owned fields, such as policyId and the timestamps, are rejected. The body uses camelCase field names, while get and list print PascalCase keys, so re-case the fields when you build a body from a rule you read.
{
"name": "Mute successful robot logins",
"isActive": true,
"selectors": [
{ "type": "EventType", "values": ["0f54d68a-15fd-427d-a86a-2812bb7fbb28"] },
{ "type": "Status", "values": ["Success"] }
]
}
{
"name": "Mute successful robot logins",
"isActive": true,
"selectors": [
{ "type": "EventType", "values": ["0f54d68a-15fd-427d-a86a-2812bb7fbb28"] },
{ "type": "Status", "values": ["Success"] }
]
}
Lista
Enumera todas las reglas de exclusión de la organización, ordenadas por nombre. El resultado no está paginado. Una regla cuya definición almacenada no se puede analizar se enumera con una matriz Selectors vacía, por lo que aún puede eliminarla.
uip admin audit org exclusions list
uip admin audit org exclusions list
Forma de datos (--output json):
{
"Code": "AuditOrgExclusionsList",
"Data": [
{
"PolicyId": "3f6b1d84-9a1e-4c2b-8e71-2f9c5d0a7b13",
"Name": "Mute successful robot logins",
"Enforcement": "Exclude",
"IsActive": true,
"ActivatedOn": "2026-09-17T09:14:22.000Z",
"Selectors": [
{ "Type": "EventType", "Values": ["0f54d68a-15fd-427d-a86a-2812bb7fbb28"] },
{ "Type": "Status", "Values": ["Success"] }
],
"CreatedOn": "2026-09-17T09:14:22.000Z",
"LastModifiedOn": "2026-09-17T09:14:22.000Z"
}
]
}
{
"Code": "AuditOrgExclusionsList",
"Data": [
{
"PolicyId": "3f6b1d84-9a1e-4c2b-8e71-2f9c5d0a7b13",
"Name": "Mute successful robot logins",
"Enforcement": "Exclude",
"IsActive": true,
"ActivatedOn": "2026-09-17T09:14:22.000Z",
"Selectors": [
{ "Type": "EventType", "Values": ["0f54d68a-15fd-427d-a86a-2812bb7fbb28"] },
{ "Type": "Status", "Values": ["Success"] }
],
"CreatedOn": "2026-09-17T09:14:22.000Z",
"LastModifiedOn": "2026-09-17T09:14:22.000Z"
}
]
}
get
Leer una regla de exclusión por nombre o ID de política.
| Argumento | Descripción |
|---|---|
<rule> | Nombre de la regla o su ID de política. |
uip admin audit org exclusions get "Mute successful robot logins"
uip admin audit org exclusions get 3f6b1d84-9a1e-4c2b-8e71-2f9c5d0a7b13
uip admin audit org exclusions get "Mute successful robot logins"
uip admin audit org exclusions get 3f6b1d84-9a1e-4c2b-8e71-2f9c5d0a7b13
Devuelve Code: AuditOrgExclusionsGet con un único objeto de regla bajo Data, en la misma forma que una entrada list .
Crear
Create an exclusion rule. The rule is active unless you pass --inactive. An active rule is refused when another active rule has the same name, or already excludes every event the new rule would.
# Stop recording successful events of one event type
uip admin audit org exclusions create --name "Mute successful robot logins" \
--type 0f54d68a-15fd-427d-a86a-2812bb7fbb28 --status Success
# Stage a rule without activating it
uip admin audit org exclusions create --name "Staged" \
--source 3f6b1d84-9a1e-4c2b-8e71-2f9c5d0a7b13 --inactive
# Create the rule from a JSON body
uip admin audit org exclusions create --file ./rule.json
# Stop recording successful events of one event type
uip admin audit org exclusions create --name "Mute successful robot logins" \
--type 0f54d68a-15fd-427d-a86a-2812bb7fbb28 --status Success
# Stage a rule without activating it
uip admin audit org exclusions create --name "Staged" \
--source 3f6b1d84-9a1e-4c2b-8e71-2f9c5d0a7b13 --inactive
# Create the rule from a JSON body
uip admin audit org exclusions create --file ./rule.json
Devuelve Code: AuditOrgExclusionsCreated con la regla creada en Data. Una regla creada con --inactive tiene IsActive: false y ActivatedOn: null.
Actualizar
Reemplazar una regla de exclusión en su totalidad. Cualquier selector que omitas se descarta, así que vuelve a enviar cada marcador que mantiene la regla. Lee la regla primero con exclusions get. Sin --inactive, la regla se guarda como activa, incluso cuando estaba inactiva antes de la actualización.
Al cambiar el nombre de una regla, se mantiene su hora de inicio de exclusión. Cambiar los eventos con los que coincide restablece ese tiempo.
| Argumento | Descripción |
|---|---|
<rule> | Nombre de la regla o su ID de política. Pásalo antes de las banderas del selector: esas banderas toman una lista, por lo que un valor escrito después de uno se lee como otro valor del selector. |
uip admin audit org exclusions update "Mute successful robot logins" \
--name "Mute successful robot logins" \
--type 0f54d68a-15fd-427d-a86a-2812bb7fbb28 --status Success
uip admin audit org exclusions update "Mute successful robot logins" \
--name "Mute successful robot logins" \
--type 0f54d68a-15fd-427d-a86a-2812bb7fbb28 --status Success
Devuelve Code: AuditOrgExclusionsUpdated con la regla reemplazada bajo Data.
Eliminar
Eliminar una regla de exclusión. Los eventos que la regla estaba excluyendo se registran de nuevo a partir de ese momento. Los eventos suprimidos mientras la regla estaba activa no se restauran.
| Argumento | Descripción |
|---|---|
<rule> | Nombre de la regla o su ID de política. |
uip admin audit org exclusions delete "Mute successful robot logins"
uip admin audit org exclusions delete "Mute successful robot logins"
Forma de datos (--output json):
{ "Code": "AuditOrgExclusionsDeleted", "Data": {} }
{ "Code": "AuditOrgExclusionsDeleted", "Data": {} }
Solución de problemas
HTTP 401: es probable que el token no esté en el ámbitoAudit.Read. Ejecutauip logout && uip loginpara acuñar un token nuevo.HTTP 403: el usuario que ha iniciado sesión carece de permiso de lectura de auditoría en este tenant; comprueba las asignaciones de roles en Automation Cloud.Tenant ID required(ámbito de tenant): pasa--tenant-id <guid>o inicia sesión y selecciona primero un tenant.HTTP 504en la exportación, o "Error de exportación de auditoría para<date>" : se agotó el tiempo de espera de un solo día. Volver a ejecutar: la exportación es idempotente. Si persiste, restrinja--from-date/--to-datepara omitir el día que falla.- "se resuelve fuera de la carpeta de salida"/nombre de archivo no seguro al exportar : indica una respuesta del servidor mal formada; volver a ejecutar e informar si persiste.
Relacionado
uip admin: descripción general de toda la herramientauip admin.uip or audit-logs: el seguimiento de auditoría de la entidad de Orchestrator, una superficie distinta de esta auditoría a nivel de administrador.
Ver también
- Sinopsis
- fuentes de la organización de auditoría de administración de uip / fuentes de tenant de auditoría de administración de uip
- Opciones
- Ejemplo
- Forma de datos (--json de salida)
- eventos de organización de auditoría de administración de uip / eventos de tenant de auditoría de administración de uip
- Opciones
- Ejemplos
- Forma de datos (--json de salida)
- exportación de la organización de auditoría de administración de uip/exportación del tenant de auditoría de administración de uip
- Opciones
- Ejemplos
- Forma de datos (--json de salida)
- exclusiones de la organización de auditoría de administrador de uip
- Opciones de escritura (crear y actualizar)
- Lista
- get
- Crear
- Actualizar
- Eliminar
- Solución de problemas
- Relacionado
- Ver también