Guia de instalação por linha de comando do aplicativo Alteryx One
Enterprise Deployment
For IT-managed deployments, a complete Alteryx One installation requires two separate installers:
Alteryx One app installer: Deploy first. The Alteryx One app is the required entry point for launching Designer 2026.1 and later. Use the command-line flags mentioned in this guide to deploy silently across machines.
Designer installer: Deploy second. Download the Designer installer from the Download & Activate page in the Alteryx One app (or browser version). Use the Designer installer to script the full Designer installation, including optional components like Predictive Tools. For more details, go to Download and Install Desktop Modules.
Nota
The command-line flags mentioned in this guide apply only to the Alteryx One app installer. The Designer installer has its own installation options.
Alteryx One App Installer
The Alteryx One installer supports command-line options that enable silent installations, enterprise deployments, and automated software distribution. This guide explains the available options, deployment considerations, and installer exit codes.
Nota
Todos os sinalizadores de linha de comando do instalador diferenciam maiúsculas de minúsculas. Os sinalizadores inválidos, a ortografia incorreta ou o uso de capitalização incorreto são ignorados e não retornam uma mensagem de erro.
Instalação padrão (por usuário): se nenhum sinalizador de linha de comando for fornecido, o instalador executará uma instalação por usuário no local padrão:
%LOCALAPPDATA%\Alteryx\AlteryxOnePor exemplo:
AlteryxOne-1.0.352-US-setup.exe/ALLUSERS: use esse sinalizador para instalar o aplicativo Alteryx One para todos os usuários na máquina (instalação por máquina).Local padrão da instalação:
C:\Program Files\Alteryx\AlteryxOnePor exemplo:
AlteryxOne-1.0.352-US-setup.exe /ALLUSERS
/S: use este sinalizador para executar o instalador no modo silencioso. Quando usado, o instalador não exibe o instalador interativo e aceita todas as configurações padrão, a menos que modificado por sinalizadores adicionais compatíveis. Exemplos:AlteryxOne-1.0.352-US-setup.exe /SAlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS
/NOAUTOLAUNCH: use esse sinalizador para impedir que o aplicativo Alteryx One seja inicializado automaticamente após a instalação. Essa opção é compatível apenas com instalações silenciosas (/S).Exemplos:
AlteryxOne-1.0.352-US-setup.exe /S /NOAUTOLAUNCHAlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH
/D=<path>: use este sinalizador para especificar um diretório de instalação personalizado.Requisitos e limitações:
Compatível apenas com instalações por máquina silenciosas.
Compatível apenas com instalações por máquina; locais personalizados para instalações por usuário não são compatíveis.
O instalador acrescenta automaticamente uma subpasta "AlteryxOne" ao local especificado.
/D=C:\temp\Alteryxé instalado emC:\temp\Alteryx\AlteryxOne./D=C:\temp\AlteryxOneé instalado emC:\temp\AlteryxOne\AlteryxOne.Por exemplo:
AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\path\to\installLocationInstala em:
C:\InstallLocation\AlteryxOneExemplo com espaços:
AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\Program Files\CustomLocationInstala em:
C:\Program Files\CustomLocation\AlteryxOne
Considerações importantes sobre o sinalizador
/D=:O parâmetro
/D=<path>deve ser o argumento final no comando. Qualquer texto que apareça após/D=é interpretado como parte do caminho de instalação em vez de como sinalizadores adicionais do instalador.Por exemplo, o seguinte comando:
AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D=C:\temp\Alteryx /S /NOAUTOLAUNCHinstala emC:\temp\Alteryx S NOAUTOLAUNCH.Para evitar locais de instalação inesperados, sempre coloque
/D=como o último argumento:AlteryxOne-1.0.359-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH /D=C:\temp\Alteryx.Não coloque o caminho especificado com
/D=entre aspas. Se aspas forem usadas, o instalador ignorará o parâmetro/D=e instalará no local padrão do tipo de instalação selecionado.Por exemplo:
AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D="C:\temp\Alteryx"Resultado: o parâmetro
/D=é ignorado e o aplicativo instala em:C:\Program Files\Alteryx\AlteryxOne
Nota
Os sinalizadores incompatíveis ou combinados incorretamente não retornam uma mensagem de erro. Dependendo do sinalizador, o instalador pode ignorar a opção incompatível ou interpretar o comando de forma diferente do esperado. Para caminhos de instalação personalizados, certifique-se de que /D= seja o argumento final. Além disso, não coloque o caminho especificado com /D= entre aspas.
Capturar códigos de erro ao instalar o Alteryx One usando uma instalação silenciosa
As instalações silenciosas retornam códigos de saída que os administradores de TI podem usar para determinar se a instalação foi concluída com sucesso ou falhou.
Isso se aplica a instalações silenciosas por usuário e por máquina. Para instalações interativas, esses erros aparecem em mensagens de diálogo na tela.
Opção A: usar o prompt de comando do Windows
No prompt de comando do Windows, use start /wait para manter o terminal aberto até que o instalador conclua. Em seguida, use %ERRORLEVEL% para visualizar o código de saída do instalador.
Por exemplo: start /wait "" "AlteryxOne-1.0.359-US-setup.exe" /S /ALLUSERS echo Installer Exit Code: %ERRORLEVEL%
Opção B: usar o PowerShell
No PowerShell, use Start-Process com os parâmetros -Wait e -PassThru para esperar que o instalador conclua e capture o código de saída.
Exemplo:
$process = Start-Process -FilePath "AlteryxOne-1.0.359-US-setup.exe" ` -ArgumentList "/S", "/ALLUSERS" ` -Wait ` -PassThru
$exitCode = $process.ExitCode
Write-Host "Installer Exit Code: $exitCode"
if ($exitCode -ne 0) { throw "Installation failed with exit code $exitCode" }
Códigos de saída do instalador do Alteryx One
Código de saída | Classificação | Significado e causa | Ação necessária |
|---|---|---|---|
0 | Sucesso | A instalação ou desinstalação foi concluída com sucesso. | Nenhum |
1 | Cancelamento pelo usuário | A instalação foi cancelada manualmente pelo usuário clicando em Cancelar na IU. | Reinicie a instalação. |
2 | Já está em execução | Outra instância do instalador do Alteryx One já está em execução. | Antes de tentar novamente, feche todas as outras instâncias de configuração. |
3 | Incompatibilidade de arquitetura | O sistema operacional não é o Windows de 64 bits. | Instale em um sistema operacional Windows de 64 bits compatível. |
4 | Conflito de instalação | Foi detectado um conflito entre os modos de instalação. Por exemplo, instalar por máquina enquanto existe uma instância por usuário ou instalar por usuário enquanto existe uma instância por máquina. | Antes de continuar, desinstale completamente o modo de instalação conflitante. |
5 | Arquivos bloqueados/processos ativos | Um dos processos críticos do aplicativo está ativo no momento: | Feche o Alteryx One, interrompa o serviço de atualização e, em seguida, execute o instalador novamente. |
6 | Elevação necessária | O modo de instalação requer direitos de administrador e o usuário ou shell atual não tem essa elevação. Isso geralmente se aplica a instalações por máquina | Execute o prompt de comando, o PowerShell ou o script de implantação como administrador. |
Nota
Para implantações silenciosas usando /S, monitore os códigos de saída 4, 5 e 6. Estes são cenários comuns de falha de implantação automatizada, como iniciar uma instalação por máquina enquanto uma instância por usuário ainda existe, ou executar o instalador enquanto o Alteryx One está ativo.