Grupos da plataforma UIP

uip platform groups gerencia regras de alocação de licenças baseadas em grupos. Uma regra anexa um conjunto de pacotes de usuários (e cotas opcionais por pacote) a um grupo de diretórios; os membros do grupo tenantm automaticamente os pacotes com direito. Use rules get para listar a regra de todos os grupos em toda a organização, rules details para inspecionar a regra de um grupo com suas locação no nível do membro e rules set para configurar direitos e cotas.

Resumo

uip platform groups rules <verb> [options] [<group>]

Verbo

Texto	Finalidade
get	Liste as regras de alocação de licença de grupo com a configuração de cota e o uso atual. Paginado.
details	Obtenha a regra de um grupo, com a lista paginada de membros do grupo e os pacotes que cada um está concedendo.
set	Defina (ou substitua) a regra de alocação de pacote de usuário e cotas opcionais por pacote para um grupo.

Resolução de grupo

details e set aceitam um argumento posicional <group> — um prefixo de nome. A CLI pesquisa grupos de diretórios e requer exatamente uma correspondência:

• Nenhuma correspondência → erro com "No directory group found matching '<input>'.".
• Várias correspondências → erro listando candidatos para que você possa refinar a entrada.

obtenção de regras de grupos de plataforma uip

Liste as regras de alocação de licenças de grupo na organização. Cada linha é um par (group, bundle) ; grupos com vários pacotes com direito produzem uma linha por pacote. A resposta inclui a própria cota por pacote do grupo (quota) e o uso atual em relação a essa cota (currentUsage), além de um sinalizador useExternalLicense que indica se o grupo está configurado para alocar pacotes de licenciamento externo.

Opções

Long	Valor	Padrão	Description
--limit	Número	50	Número máximo de resultados a serem retornados.
--offset	Número	0	Número de resultados a serem ignorados.
--sort-by	Campo	—	Campo pelo qual classificar (por exemplo, name).
--sort-order	ENUM	—	Ordem de classificação: Asc ou Desc.
--organization	ID da conta	padrão da sessão	GUID da conta da organização. Substitua a organização resolvida a partir do login atual.

Exemplo

uip platform groups rules get --limit 50

Formato dos dados (--output json)

{
  "Code": "GroupRules",
  "Data": [
    {
      "groupId": "35551807-06b1-4cda-90a1-2fb84851eee7",
      "groupName": "RPA Developers",
      "code": "RPADEVPRONU",
      "name": "RPADEVPRONU",
      "quota": 25,
      "currentUsage": 12,
      "useExternalLicense": false
    }
  ]
}

A resposta também inclui metadados de paginação (retornado, limite, deslocamento, total).

detalhes das regras dos grupos de plataforma uip

Obtenha a regra de alocação de licenças de um grupo com cotas, mesclada a uma linha por (user, bundle leased). Usuários sem tenants ainda aparecem como uma única linha com colunas de pacote nulas. A lista de usuários é paginada; use --limit e --offset para paginar por ele. Um resumo de cabeçalho (pacotes com direito, cotas como used/limit, useExternalLicense) é gravado no stderr para não interferir com os dados JSON no stdout.

Argumentos

Name	Required	Finalidade
<group>	sim	Identificador do grupo (prefixo do nome; deve corresponder exatamente a um grupo do diretório).

Opções

Long	Valor	Padrão	Description
--limit	Número	50	Número máximo de usuários a serem retornados.
--offset	Número	0	Número de usuários a ignorar.
--sort-by	Campo	—	Campo pelo qual classificar usuários (por exemplo, name).
--sort-order	ENUM	—	Ordem de classificação do usuário: Asc ou Desc.
--organization	ID da conta	padrão da sessão	GUID da conta da organização. Substitua a organização resolvida a partir do login atual.

Exemplo

uip platform groups rules details "RPA Developers" --limit 100

Formato dos dados (--output json)

{
  "Code": "GroupRuleDetails",
  "Data": [
    {
      "userDisplayName": "Dan Dinu",
      "email": "[e-mail]",
      "lastInUse": "2026-05-10T08:15:00.000Z",
      "orphan": false,
      "bundleCode": "RPADEVPRONU",
      "bundleName": "RPADEVPRONU",
      "quota": 25,
      "currentUsage": 12
    }
  ]
}

conjunto de regras de grupos de plataforma uip

Defina a regra de alocação de pacote de usuário para um grupo, opcionalmente com cotas por pacote. Omitir quota em uma entrada significa que não há aplicação de cota para esse pacote. A nova regra substitui a lista de pacotes anterior do grupo — os pacotes não listados em --input são removidos da regra.

Argumentos

Name	Required	Finalidade
<group>	sim	Identificador do grupo (prefixo do nome; deve corresponder exatamente a um grupo do diretório).

Opções

Long	Valor	Padrão	Description
--input	Path	necessário	Caminho para um arquivo JSON com a regra, por exemplo, [{"code":"RPADEVPRONU"},{"code":"ATTUNU","quota":10}].
--organization	ID da conta	padrão da sessão	GUID da conta da organização. Substitua a organização resolvida a partir do login atual.

Exemplo

uip platform groups rules set "RPA Developers" \
    --input ./group-rule.json

group-rule.json:

[
  { "code": "RPADEVPRONU", "quota": 25 },
  { "code": "ATTUNU" }
]

Formato dos dados (--output json)

{
  "Code": "GroupRuleSet",
  "Data": [
    { "code": "RPADEVPRONU", "name": "RPADEVPRONU", "quota": 25, "currentUsage": 12 },
    { "code": "ATTUNU",      "name": "ATTUNU",      "quota": null, "currentUsage": null }
  ]
}

Códigos de saída

Consulte Códigos de saída. Nenhuma substituição específica do verbo.

Comandos relacionados

• uip platform users — alocação direta de pacote de usuário; users licenses get mostra quais pacotes um membro está locação de cada regra de grupo.
• uip platform tenants — o runtime no nível do tenant e a alocação de consumíveis.

Veja também

• Opções globais.