uip o licencias

uip or licenses y gestiona la asignación de licencias de Orchestrator. Enumere las asignaciones de licencias de runtime y de usuario nombrado, active o desactive las licencias de máquina y vea el resumen general de licencias de tenant (permitidas frente a utilizadas por tipo de robot).

Sinopsis

uip or licenses <verb> [options]

Verbos

Verbo	Propósito
list	Enumera las asignaciones de licencias para un tipo de robot determinado (runtime o named user).
toggle	Habilita o deshabilita las licencias de máquina para un tipo de robot de runtime específico.
info	Muestra el resumen de la licencia del tenant (plan de suscripción, permitidos/utilizados, características).

Referencia de tipo de robot

El marcador --type acepta estos tipos de robots. El comportamiento del comando se divide en dos depósitos:

• Tipos de runtime : asignación en el nivel de máquina: Unattended, NonProduction, Headless, TestAutomation.
• Tipos de usuario nombrado : asignación en el nivel de usuario: Attended, Development, Studio, StudioX, RpaDeveloper, CitizenDeveloper.

licenses list acepta ambos depósitos; licenses toggle solo acepta tipos de runtime.

lista de uip o licencias

Enumera las asignaciones de licencias para un tipo de robot determinado.

• Para los tipos de runtime, cada fila es una máquina con un robot conectado; Se devuelven MachineName, MachineType, Runtimes, IsOnline, IsLicensed y Enabled .
• Para los tipos de usuario nombrado, cada fila es un usuario; Se devuelven UserName, LastLoginDate, MachinesCount, IsLicensed y MachineNames .

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
-t	--tenant	name	sesión predeterminada	Anula el tenant.
—	--type	ENUM	obligatorio	Tipo de robot (consulta la lista anterior).
—	--licensed	Marca	Desactivado	Solo entradas con licencia. Mutuamente excluyente con --unlicensed.
—	--unlicensed	Marca	Desactivado	Solo entradas sin licencia. Mutuamente excluyente con --licensed.
-l	--limit	Número	50	Tamaño de la página.
—	--offset	Número	0	Omitir recuento.
—	--order-by	Campo	—	Ordenación de OData (por ejemplo, MachineName desc).

Ejemplos

uip or licenses list --type Unattended --limit 50
uip or licenses list --type Attended --unlicensed
uip or licenses list --type Unattended \
    --output-filter 'Data[?IsOnline].MachineName'

Forma de datos (--json de salida)

Tipo de runtime:

{
  "Code": "LicenseList",
  "Data": [
    {
      "Key": "a1b2c3d4-0000-0000-0000-000000000001",
      "MachineName": "prod-worker-01",
      "MachineType": "Standard",
      "Runtimes": 3,
      "IsOnline": true,
      "IsLicensed": true,
      "Enabled": true
    }
  ]
}

Tipo de usuario designado:

{
  "Code": "LicenseList",
  "Data": [
    {
      "Key": "d4e5f6a7-0000-0000-0000-000000000001",
      "UserName": "[e-mail]",
      "LastLoginDate": "2025-04-15T10:30:00Z",
      "MachinesCount": 2,
      "IsLicensed": true,
      "MachineNames": ["studio-01", "studio-02"]
    }
  ]
}

alternancia de uip o licencias

Habilita o deshabilita las licencias de máquina para un tipo de robot de runtime específico. Se rechazan los tipos de usuario nombrado. Acepta una clave de máquina (GUID): se resuelve internamente en un nombre de máquina antes de llamar a la API.

Se debe proporcionar exactamente uno de --enable o --disable .

Argumentos

Nombre	Obligatorio	Propósito
<machine-key>	Sí	Clave de la máquina (GUID). Encuéntralo con machines list.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
-t	--tenant	name	sesión predeterminada	Anula el tenant.
—	--type	ENUM	obligatorio	Solo tipo de robot de runtime: Unattended, NonProduction, Headless, TestAutomation.
—	--enable	Marca	—	Habilitar licencias.
—	--disable	Marca	—	Deshabilitar licencias.

Ejemplos

uip or licenses toggle a1b2c3d4-0000-0000-0000-000000000001 \
    --type Unattended --enable

uip or licenses toggle a1b2c3d4-0000-0000-0000-000000000001 \
    --type NonProduction --disable

uip or licenses toggle a1b2c3d4-0000-0000-0000-000000000001 \
    --type Unattended --enable --output-filter 'Data.Status'

Forma de datos (--json de salida)

{
  "Code": "LicenseToggle",
  "Data": {
    "MachineKey": "a1b2c3d4-0000-0000-0000-000000000001",
    "MachineName": "prod-worker-01",
    "RobotType": "Unattended",
    "Enabled": true,
    "Status": "Licensing enabled"
  }
}

información de UIP o licencias

Muestra el resumen de la licencia del tenant: plan de suscripción, recuentos permitidos frente a utilizados por tipo de robot, estado de vencimiento y características con licencia. Utilízalo para comprobar la capacidad general antes de asignar.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
-t	--tenant	name	sesión predeterminada	Anula el tenant.

Ejemplos

uip or licenses info
uip or licenses info --output-filter 'Data.Used'
uip or licenses info --output table

Forma de datos (--json de salida)

{
  "Code": "LicenseInfo",
  "Data": {
    "IsExpired": false,
    "SubscriptionPlan": "Enterprise",
    "Allowed": { "Unattended": 10, "Attended": 20 },
    "Used": { "Unattended": 4, "Attended": 7 },
    "LicensedFeatures": ["AISuite", "TestManager"]
  }
}

Códigos de salida

Consulta Códigos de salida. Sin anulaciones específicas de verbos.

Comandos relacionados

• uip or machines : gestionar máquinas y asignación de ranuras.
• uip or users — --license-type en users create y users edit.

Ver también

• Opciones globales.