Migração: renomeações de sinalizadores

Referência de renomeação de sinalizador para migrar de "uipcli" para UiPath CLI, agrupado por domínio.

Esta página mapeia sinalizadores uipcli individuais para suas contrapartes uip . Use-o ao lado do mapa de Comando — o mapa de Comando mostra qual verbo chamar; esta página mostra o que fazer com cada sinalizador nesse verbo.

Os sinalizadores são agrupados por domínio. Auth é o primeiro porque muda para cada comando de uma só vez. O resto da página abrange os sinalizadores que diferem por verbo — saída do pacote/solução, execução de trabalhos, saída do executor de testes, rastreamento e assim por diante.

As entradas de sinalizador legado refletem a superfície de sinalizador uipcli pública documentada para 2025.10 e anterior. A coluna uip corresponde às páginas de referência atuais.

Como ler a coluna "Oonde reside"

uip a você três lugares para colocar um valor que era um sinalizador em uipcli:

• Sinalizar em cada comando — passe-o literalmente todas as vezes (--tenant <name>, --folder-path Shared).
• Estado da sessão de uip login — o sinalizador se tornou algo que você definiu uma vez com uip login; comandos subsequentes o coletam automaticamente.
• Variável de ambiente — lida pela CLI no runtime. Quando aplicável, prefira a forma de prefixo --client-id env.VARNAME / --client-secret env.VARNAME em uip login para manter o segredo fora da linha de comando.

A coluna "Oonde reside" informa qual delas se aplica.

Autenticação

Este é o bloco que mais muda. A CLI legada aceitava três modos de credencial por comando (usuário/acesso, token de atualização e aplicativo externo). A nova CLI aceita apenas credenciais de aplicativos externos e OAuth interativo — a autenticação de usuário/acesso e token de atualização são removidos. Consulte Mudanças de impacto — modos de autenticação removidos.

Aplicativo externo (o fluxo de CI)

Sinalizador legado	Finalidade legada	uip Bandeira	Onde reside	Observações
-A, --accountForApp <name>	Nome da organização do aplicativo externo	--organization <name>	Sinalizador ativado uip login	Muitas vezes opcional — a organização é inferida do registro do aplicativo externo. Transmita-o quando precisar desambiguar.
-I, --applicationId <id>	ID do cliente do aplicativo externo	--client-id <id> (ou --client-id env.VARNAME )	Sinalizador ativado uip login	Prefira env.VARNAME para ler de uma variável de ambiente.
-S, --applicationSecret <secret>	Segredo do cliente do aplicativo externo	--client-secret <secret> (ou --client-secret env.VARNAME )	Sinalizador ativado uip login	Sempre use o prefixo env. no CI para evitar vazar o segredo no histórico do shell e na saída ps .
--applicationScope "<space-separated>"	Escopos do OAuth	--scope "<space-separated>" / -s, --scope	Sinalizador ativado uip login	Mesmo formato separado por espaço. As chamadas legadas normalmente listam todos OR.* escopos; mantêm a mesma lista.
--identityUrl <url>	Autoridade de identidade personalizada (Automation Suite / PaaS)	--authority <url>	Sinalizador ativado uip login	Renomeado; semântica idêntica. Omita para o Automation Cloud.
(posicional) <orchestrator_url>	OrchestratorBaseURL	(imlícito da sessão)	O sinalizador em uip login não é necessário — a CLI resolve o URL do Orchestrator do tenant/organização escolhido no login.
(posicional) <orchestrator_tenant>	Nome do tenant	-t, --tenant <name>	Sinalizador ativado uip login	Uma vez definido no login, cada comando subsequente usa esse tenant. Alterne no meio da sessão com uip login tenant set <name>, sem autenticar novamente.
-o, --organizationUnit <folder>	Pasta padrão para o comando	--folder-path <path> ou --folder-key <guid>	Sinalize no comando que precisa dele	Não é um conceito de nível de sessão em uip; passe-o em cada chamada jobs/processes/resource * . O arquivo de configuração pode fixar padrões.

Autenticação de usuário/senha — removida

Sinalizador legado	Status em uip
-u, --username <user>	Removido. Crie um Aplicativo externo e use. --client-id
-p, --password <pass>	Removido. Use --client-secret.

A CLI legada suportava a autenticação de usuário/senha no Orchestrator para ambientes em que um aplicativo externo ainda não foi provisionado. uip ; consulte Alterações interruptivas — modos de autenticação removidos.

Autenticação de token de atualização — removida

Sinalizador legado	Status em uip
-t, --token <refresh-token>	Removido. Legado -t era o abreviação de --token; em uip, -t é o formato abreviado para --tenant.
-a, --accountName <name>	Removido. Em vez disso, use --organization com um aplicativo externo.

Se um pipeline legado usava a autenticação de token de atualização, migre para o aplicativo externo. O Automation Cloud não provisiona mais o fluxo de token de atualização para novas cargas de trabalho.

Token em mãos (novo — sem equivalente legado)

Para contêineres ou executores que já possuem um token de acesso da UiPath e não precisam trocar credenciais, uip suporta a autenticação de variável de ambiente: defina UIPATH_CLI_ENABLE_ENV_AUTH=true e passe o token + org + tenant por meio de vars de ambiente. Consulte Autenticação — Fluxo 3. Nenhum arquivo é escrito; o token não é atualizado.

env.var_name prefixo

uip login aceita um segredo literal em --client-id / --client-secret ou a forma de prefixo env.VAR_NAME que lê o valor de uma variável de ambiente no runtime:

# Resolves at runtime from $UIPATH_CLIENT_SECRET; the secret never appears on the command line.
uip login \
  --client-id env.UIPATH_CLIENT_ID \
  --client-secret env.UIPATH_CLIENT_SECRET \
  --tenant "$UIPATH_TENANT"

Ao contrário de uipcli, uip não lê implicitamente UIPATH_CLIENT_ID / UIPATH_CLIENT_SECRET; você deve fazer referência a eles por meio do prefixo env. (ou passar valores literais). Consulte Autenticação — prefixo env.VAR_NAME e Alterações interruptivas — leitura de env-var implícita removida.

Saída, registro em log e rastreamento

Aplica-se a todo verbo uipcli .

Sinalizador legado	Finalidade legada	uip Bandeira	Onde reside	Observações
--traceLevel <None|Critical|Error|Warning|Information|Verbose>	Verboes de log	--log-level <debug|info|warn|error>	Sinalizador global em cada comando	Intervalo de valor reduzido para quatro níveis; padrão info. Verbose → debug, Information → info, Warning → warn, todo o resto → error. Consulte Opções globais.
(stdout de texto legado; sem sinalizador)	Saída estruturada	--output <json|table|yaml|plain>	Sinalizador global	O padrão é json em cada comando. Texto legível por humanos impressos legados; uip imprime JSON. Use --output table para a exibição humana. Consulte Formatos de saída.
(sem equivalente)	Saída pós-filtro	--output-filter "<JMESPath>"	Sinalizador global	Novidade em uip. Permite que os pipelines extraiam campos específicos sem passagem por jq.
(sem equivalente)	Duplicar logs em um arquivo	--log-file <path>	Sinalizador global	Novidade em uip. Acrescenta linhas JSON.
-l, --language <locale>	Idioma do log	(sem equivalente)	Removido.	A saída de log é o inglês em uip.
--captureCommandToJsonFile <path>	Serializar a invocação para JSON	(sem equivalente)	Removido.	Usado para direcionar uipcli run, que também é removido. Consulte Mapa de comando — run.

Sinalizadores de pacote

A maioria dos sinalizadores PascalCase legados torna-se Kebab-Case em uip rpa (por exemplo, --outputType → --output-type), mas vários são renomeados imediatamente ou descartados inteiramente em vez de apenas re-maiúsculas - consulte a coluna de notas em cada tabela abaixo. Execute uip rpa pack --help para obter a lista completa na versão da sua ferramenta instalada.

Pacote

Vários sinalizadores não seguem a regra simples CamelCase para Kebab-Case abaixo, verificado em relação à origem real (rpa-tool/src/commands/packager/pack.ts), em vez de presumido:

Sinalizador legado	uip rpa pack	Observações
<workspace_path> (posicional)	[project-dir] (posicional, opcional)	Caminho para o diretório do projeto, project.json, ou um arquivo .uip. O padrão é --project-dir ou o diretório atual.
-o, --output <dir>	[output-path] (posicional) ou --output-path <path>	Nenhum alias curto -o . Necessário, passe-o como a segunda posição ou por meio de --output-path; os erros de comando se ambos forem omitidos.
-v, --version <semver>	--package-version <version>	Nenhum alias curto -v e o sinalizador em si é --package-version, não --version.
--autoVersion	(sem equivalente, este sinalizador não existe)	Não há sinalizador de geração automática de versão em uip rpa pack. Calcule a versão você mesmo e transmita --package-version.
--outputType <Process|Library|Tests|Objects>	--output-type <Process|Library|Tests|Objects>	Forçar o tipo de saída.
--splitOutput	--split-packages	Não é uma renomeação pura do caso Kebab - o próprio sinalizador é renomeado para --split-packages.
--releaseNotes <text>	--release-notes <text>	Incorporado aos metadados .nupkg .
--repositoryUrl, --repositoryCommit, --repositoryBranch, --repositoryType	--repository-url, --repository-commit, --repository-branch, --repository-type	Metadados de VCS.
--projectUrl <url>	--project-url <url>	URL da ideia do Automation Hub.
--certificatePath, --certificatePassword, --timestampServerUrl	--signing-certificate-path, --signing-certificate-password, --signing-timestamp-server	Não é um caso Kebab puro - todos os três obtêm um prefixo signing- .
--author <name>	--package-author <name>	Não é --author - o sinalizador é --package-author.
--governanceFilePath <policy>	--governance-file-path <policy>	Execute o analisador como parte do pacote. --governance-file-type <type> também está disponível (enumeração de opções) se o formato do arquivo não puder ser inferido.
(sem equivalente legado)	--package-id <id>, --package-description <desc>, --skip-analyze, --skip-dependency-optimization, --include-sources / --no-include-sources, --detailed-log-path <path>	Novos sinalizadores sem contraparte uipcli package pack legada.
Autenticação da biblioteca (--libraryOrchestratorUrl, --libraryOrchestratorTenant, -u/-p/-t/-a/-A/-I/-S, --libraryOrchestratorApplicationScope, --libraryOrchestratorFolder, --libraryIdentityUrl, --libraryOrchestratorAccountForApp, --libraryOrchestratorAccountName, --libraryOrchestratorApplicationId, --libraryOrchestratorApplicationSecret, --libraryOrchestratorUsername, --libraryOrchestratorPassword, --libraryOrchestratorAuthToken)	Sessão de uip login	Todos os library* sinalizadores de autenticação são recolhidos na única sessão configurada por uip login. O pacote fica offline, exceto quando precisa resolver dependências de bibliotecas de um feed privado; nesse caso, a CLI usa a sessão ativa.

análise de pacote

Verificado contra a origem real (rpa-tool/src/commands/packager/analyze.ts), vários sinalizadores legados não têm equivalentes, ao invés de serem meramente não documentados:

Sinalizador legado	uip rpa analyze
<workspace_path> (posicional)	[project-dir] (posicional, opcional, padrão para --project-dir ou para o diretório atual)
--governanceFilePath <policy>	--governance-file-path <policy> (alias: --policy-file <path>)
--analyzerTraceLevel <Off|Error|Warning|Info|Verbose>	(sem equivalente, este sinalizador não existe)
--stopOnRuleViolation	(sem equivalente, este sinalizador não existe). O controle disponível mais próximo é --default-severity <level>, que define a gravidade padrão para regras que não especificam suas próprias.
--treatWarningsAsErrors	(sem equivalente, este sinalizador não existe)
--resultPath <path>	(sem equivalente, este sinalizador não existe). uip rpa analyze grava suas descobertas no stdout no --format selecionado; redirecione-o você mesmo (uip rpa analyze ... > result.json).
--ignoredRules <id1,id2>	(sem equivalente, este sinalizador não existe)
(sem equivalente legado)	--governance-file-type <type>, --policy-file-type <type> (alias para --governance-file-type, assume como padrão AutomationOps quando um arquivo de política/governança é fornecido), --repository-path <path> (paridade de Análise de Pipeline), --detailed-log-path <path>, --skip-analyze

Implantação de pacote

O deploy legado agora é de duas chamadas uip ; consulte Mapa de comando — implantação de pacote. Por sinalizador:

Sinalizador legado	uip Equivalente	Observações
<packages_path> (posicional)	<file> (posicional em uip or packages upload)	Arquivo único. Para uma pasta de .nupkgs, faça o loop no shell.
<orchestrator_url> (posicional)	(sessão)	Solte-o; fornecido por uip login.
<orchestrator_tenant> (posicional)	-t, --tenant ativada uip login	O padrão é sessão.
-c, --createProcess <true|false>	(imlícito)	uip or packages upload nunca cria o processo. uip or processes create após o upload se você quiser um processo.
--processName <name>	--name <name> ativada uip or processes create	Renomeado; observação: --process <name> não existe na nova CLI.
--processNames <csv>	(loop no shell — sem equivalente direto)	Script a iteração CSV; chame processes create por linha.
--processDescription <text>	--description <text> ativada uip or processes create	Nenhum alias curto -d em create — esse alias existe apenas em uip or processes update.
--use-package-description	(comportamento padrão)	processes create herda a descrição do pacote por padrão ao criar.
--ignoreLibraryDeployConflict	(sem equivalente)	Os carregamentos de bibliotecas por meio de uip or libraries upload falham corretamente na versão duplicada; ajustar a lógica do pipeline para ignorar se a versão já existir.
-e, --environments <csv>	(sem equivalente; apenas pastas modernas)	O conceito de "ambientes" de pastas clássicas legadas não está representado no modelo de pastas modernos.
-h, --entryPointsPath <csv>	--entry-point <path> ativada uip or processes create	Ponto de entrada único por chamada; loop para pacotes de vários pontos de entrada.

restauração do pacote

uip rpa restore leva apenas as opções comuns do empacotador abaixo mais suas duas posições, não há sinalizadores específicos de restauração (verificado em relação a rpa-tool/src/commands/packager/restore.ts):

Sinalizador legado	uip rpa restore
<workspace_path> (posicional)	[project-dir] (posicional, opcional)
--restoreFolder <dir>	[output-path] (posicional, opcional, deve estar FORA da árvore de diretório do projeto; omita apenas a restauração no cache NuGet compartilhado)
--nugetConfigFilePath <path>	--nuget-sources-config-path <path>
(sem equivalente legado)	--exclude-configured-sources, --feed-folder <name> (resolver dependências de biblioteca de um feed de pasta do Orchestrator em vez de cada feed de tenant)
Sinalizadores de autenticação da biblioteca	Sessão de uip login

Sinalizadores de trabalho (execução do trabalho uipcli → uip ou início de trabalhos)

Sinalizador legado	uip or jobs start	Observações
<process_name> (posicional)	<process-key> (posicional)	GUID, não nome. Resolva com uip or processes list --name <name> --output-filter 'Data[0].Key' --output plain.
<orchestrator_url> (posicional)	(sessão)	—
<orchestrator_tenant> (posicional)	-t, --tenant ativada uip login	O padrão é sessão.
-i, --input_path <file>	--input-file <path> (arquivo) ou --input-arguments '<json>' (em linha)	Duas alternativas, mutuamente exclusivas.
-P, --priority <Low|Normal|High>	--job-priority <Low|Normal|High>	—
-j, --jobscount <n>	--jobs-count <n>	—
-r, --robots <csv>	(sem equivalente direto)	Somente pasta clássica no legado. Use --machine-keys ou --user-keys (GUIDs) para pastas modernas.
-U, --user <user>	--user-keys <guid[,guid]>	Deve resolver o nome de usuário para um GUID do usuário primeiro (uip or users list).
-M, --machine <hostname>	--machine-keys <guid[,guid]>	Deve resolver o nome do host para um GUID de máquina primeiro (uip or machines list).
-R, --result_path <file>	(redirecione stdout ou --output-filter)	uip imprime o envelope do trabalho para stdout. uip or jobs start <key> --wait-for-completion > result.json grava o envelope completo.
-W, --timeout <seconds>	--timeout <seconds>	Requer --wait-for-completion.
-f, --fail_when_job_fails <true|false>	(sempre ativo)	Com --wait-for-completion, o código de saída é 1 se o trabalho terminar Faulted. Sem desativação.
-w, --wait <true|false>	--wait-for-completion (sinalizar)	A nova forma é um sinalizador booleano (sem valor).
-b, --job_type <Unattended|NonProduction>	--runtime-type <Unattended|Headless|Serverless|NonProduction|Development|TestAutomation>	Enumeração mais ampla.
-o, --organizationUnit <folder>	--folder-path <path> ou --folder-key <guid>	Ou omitir — uip infere a pasta da chave do processo.

Sinalizadores de teste

execução de teste do uipcli → uip testsets run + uip tm Wait + uip tm report get

Sinalizador legado	uip target	Observações
-s, --testset <name>	--test-set-key <key> ativada uip tm testsets run	Chave, não nome. Formato PROJECT:NN. Resolver com uip tm testsets list --project-key <key>.
-t, --testsetkey <key>	--test-set-key <key>	Mesmo valor. Observação: -t legado entra em conflito com o novo CLI -t, --tenant; use o formato longo.
-P, --project-path <project.json>	(retrabalho)	O fluxo legado de empacotar e testar em tempo real é dividido: uip rpa pack → uip or packages upload → teste do autor definido no Test Manager → uip tm testsets run. A criação do conjunto de testes é uma configuração única.
-a, --projectKey <key>	--project-key <key> em uip tm wait / uip tm report get	Diferente projectKey: o sinalizador legado definiu projectKey para o Test Manager; o novo sinalizador delimita a aguardar/relatar a um projeto do Test Manager. Mesmo valor subjacente.
-e, --environment <name>	(sem equivalente)	Conceito de pasta clássica.
-o, --organizationUnit <folder>	--folder-key <uuid> ativada uip tm testsets list	Usado para encontrar o conjunto de testes; não em execute. Leva um GUID de pasta (de uip or folders list), não uma string de caminho — não há opção --folder-path em testsets list.
--out <junit|uipath>	(sem equivalente)	uip tm result download não tem opção --output-format — apenas JUnit XML é compatível hoje.
-r, --result_path <file>	--result-path <path> ativada uip tm result download	Baixe após a execução.
-w, --timeout <seconds>	--timeout <seconds> ativada uip tm wait	Mesma semântica, verbo diferente.
-i, --input_path <file>	--input-path <file> ativada uip tm testsets run	Exatamente o mesmo sinalizador; o esquema do arquivo JSON permanece inalterado.
--attachRobotLogs	(use uip tm attachment download após a execução)
--retryCount <n>	uip tm executions retry --execution-id <id>	Executa novamente casos com falha. Sem nova tentativa automática no início.
--repositoryUrl, --repositoryCommit, --repositoryBranch, --repositoryType, --projectUrl, --releaseNotes, --disableBuiltInNugetFeeds, --nugetConfigFilePath, --author	(não em uip tm)	Essas eram entradas do lado do pacote quando test run precisava empacotar primeiro. Elas pertencem a uip rpa pack.

teste paralelo do uipcli

Sinalizador legado	uip Equivalente
--testsConfigurationFilePath <file>	(sem equivalente) — escreva um loop de shell sobre uip tm testsets run
--projectsRootDirectoryPath <dir>	(sem equivalente)
--executionArtifactsDirectoryPath <dir>	--result-path <path> em uip tm result download e uip tm attachment download, execução por execução
--cliDirectoryPath <uipcli.dll>	(sem equivalente)
--out <junit|uipath>	(sem equivalente) — uip tm result download não tem a opção --output-format ; apenas o XML JUnit é compatível hoje
--disableBuiltInNugetFeeds	(não em uip tm; use em uip rpa pack ao empacotar projetos de teste)
--projectKey <key>	--project-key <key>
--author <name>	(não em uip tm)

Sinalizadores de ativo

Ambos os verbos legados (asset deploy e asset delete) consumiram um arquivo CSV; a nova CLI não tem implantação em massa — faz loop sobre linhas CSV e chama uip or assets create / delete por linha. Consulte Mapa de comando — ativo.

Sinalizador legado	uip Equivalente	Observações
<assets_file> (posicional)	(analisar o CSV no shell)	—
<orchestrator_url> (posicional)	(sessão)	—
<orchestrator_tenant> (posicional)	-t, --tenant ativada uip login	—
Coluna do CSV name	<name> (posicional) em uip or assets create	—
Coluna do CSV value	<value> (posicional)	—
Coluna do CSV type	--type <Text|Bool|Integer|Credential|Secret>	Sem distinção entre maiúsculas e minúsculas.
Coluna do CSV description	-d, --description <text>	—

Sinalizadores de solução

A estrutura do verbo é em grande parte preservada; os nomes dos sinalizadores foram normalizados para Kebab-case e o bloco auth foi recolhido para a sessão.

Sinalizador legado (entre verbos)	uip Equivalente	Observações
-o, --output <dir> ativada solution pack	(posicional <outputPath>)	—
-v, --version <semver> ativada solution pack	--version <semver>	—
-n, --name <name> ativada solution pack	--name <name>	—
Bloqueio de autenticação (em cada verbo solution que toca no Orchestrator)	Sessão de uip login	—
--packageName <n> ativada solution deploy	--package-name <n> ativada uip solution deploy run	—
--packageVersion <v> ativada solution deploy	--package-version <v>	—
--folderName <n> ativada solution deploy	--folder-name <n>	—
--deploymentParentFolder <path> ativada solution deploy	--parent-folder-path <path> (ou --parent-folder-key <guid>) em uip solution deploy run	Nomeia a pasta pai na qual a pasta de implantação é criada.
Posicional <deploymentName> em solution deploy-activate / solution deploy-uninstall	<deployment-name> em uip solution deploy activate / uip solution deploy uninstall	—

Telemetria e sinalizadores ocultos

Sinalizador legado	Status
-y, --disableTelemetry (oculto)	Substituída por env var UIPATH_TELEMETRY_DISABLED=1. Consulte O que há de novo — Telemetria.
--origin (oculto)	Removido.
--captureCommandToJsonFile (oculto)	Removido junto com uipcli run.

Veja também

• Mapa de comando — mapeamento por verbo com fragmentos antes/depois.
• Alterações interruptivas — auth, env vars, códigos de saída, formato stdout.
• Autenticação — os três fluxos de autenticação compatíveis.
• Configuração — variáveis de ambiente e precedência de sinalizador.
• Opções globais — --output, --output-filter, --log-level, --log-file.