Grupos da plataforma UIP

Sintaxe e opções para "grupos de plataforma uip", que gerencia regras de alocação de licenças baseadas em grupos para pacotes de usuários.

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 usado na classificação. Valores aceitos: Id, GlobalId, GroupId, OrganizationId, UseExternalLicense, UserBundleCodesAsJson, UserBundleCodes. Qualquer outra coisa retorna HTTP 400 — por exemplo, name não é aceito.
--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
uip platform groups rules get --sort-by GroupId --sort-order Asc

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 usado para classificar usuários. Validado no lado do servidor pelo Contador de licenças; um campo não compatível retorna HTTP 400. A lista de campos aceitos não é enumerada na origem da CLI para esse ponto de extremidade (ao contrário de rules get) — verifique a resposta da API se um palpite for rejeitado.
--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
    }
  ]
}

A resposta também inclui metadados de paginação (retornado, limite, deslocamento, total) sobre a lista de usuários, exatamente rules get como.

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.