usuários da plataforma uip

uip platform users gerencia a alocação de pacote de licença por usuário por meio do Contador de licença. Aloque pacotes diretamente a um usuário de diretório, liste as concessões atuais de um usuário (e se cada um veio de uma alocação direta ou de uma regra de grupo) e visualize a disponibilidade do pacote de usuário no nível da conta.

Resumo

uip platform users licenses <verb> [options] [<user>]

Verbo

Texto	Finalidade
set	Aloque licenças de pacote de usuário diretamente a um usuário de diretório.
get	Liste as concessões do pacote de usuário atualmente mantidas por um usuário do diretório, com a origem de cada locação.
available	Obtenha o resumo no nível da conta das licenças de pacote do usuário (total, alocada, disponível).

Resolução do usuário

set e get aceitam um argumento posicional <user> — um nome ou prefixo de e-mail. A CLI pesquisa usuários locais e de diretório com uma correspondência "começa com" e requer exatamente uma correspondência:

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

conjunto de licenças de usuários da plataforma uip

Aloque licenças de pacote de usuário a um usuário de diretório. Os pacotes em --input substituem os pacotes alocados diretamente do usuário; os pacotes herdados das regras de grupo não são afetados por esse comando.

Argumentos

Name	Required	Finalidade
<user>	sim	Identificador do usuário (nome ou prefixo do e-mail; deve corresponder exatamente a um usuário do diretório).

Opções

Long	Valor	Padrão	Description
--input	Path	necessário	Caminho para um arquivo JSON com a alocação de licenças de usuário desejada, por [{"code":"RPADEVPRONU"},{"code":"ATTUNU"},{"code":"TSTNU"}].
--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 users licenses set "[e-mail]" \
    --input ./user-bundles.json

user-bundles.json:

[
  { "code": "RPADEVPRONU" },
  { "code": "ATTUNU" },
  { "code": "TSTNU" }
]

Formato dos dados (--output json)

{
  "Code": "UserLicensesSet",
  "Data": [
    { "code": "RPADEVPRONU", "name": "RPADEVPRONU" },
    { "code": "ATTUNU",      "name": "ATTUNU" },
    { "code": "TSTNU",       "name": "TSTNU" }
  ]
}

licenças de usuários da plataforma uip obter

Obtenha as licenças de pacote de usuário atualmente concedidas por um usuário de diretório. Cada linha é um pacote tenant; source é "group" quando a locação é herdada de uma regra de grupo ou "direct" para alocações fora de grupo.

Argumentos

Name	Required	Finalidade
<user>	sim	Identificador do usuário (nome ou prefixo do e-mail; deve corresponder exatamente a um usuário do diretório).

Opções

Long	Valor	Padrão	Description
--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 users licenses get "[e-mail]"

Formato dos dados (--output json)

{
  "Code": "UserLicenses",
  "Data": [
    {
      "source": "direct",
      "code": "RPADEVPRONU",
      "name": "RPADEVPRONU",
      "leasedAt": "2026-04-15T10:30:00.000Z"
    },
    {
      "source": "group",
      "code": "ATTUNU",
      "name": "ATTUNU",
      "leasedAt": "2026-04-20T08:15:00.000Z"
    }
  ]
}

licenças de usuários da plataforma uip disponíveis

Obtenha o resumo no nível da conta das licenças de pacote do usuário: quantas estações por pacote existem (total), quantas já estão alocadas (allocated) e quantas permanecem disponíveis (available). Use isso antes de alocar para confirmar a capacidade.

Opções

Long	Valor	Padrão	Description
--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 users licenses available

Formato dos dados (--output json)

{
  "Code": "UserLicensesAvailable",
  "Data": [
    { "code": "RPADEVPRONU", "name": "RPADEVPRONU", "total": 100, "allocated": 42, "available": 58 },
    { "code": "ATTUNU",      "name": "ATTUNU",      "total": 50,  "allocated": 50, "available": 0 }
  ]
}

Códigos de saída

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

Comandos relacionados

• uip platform groups — regras de grupo que alugam pacotes para muitos usuários de uma só vez (esses aparecem com source: "group" em users licenses get).
• uip platform tenants — o runtime no nível do tenant e a alocação de consumíveis.

Veja também

• Opções globais.