Alteryx Oneアプリのコマンドラインインストールガイド
Alteryx Oneインストーラーは、サイレントインストール、エンタープライズデプロイ、ソフトウェアの自動配布を可能にするコマンドラインオプションをサポートしています。このガイドでは、使用可能なオプション、デプロイに関する考慮事項、インストーラーの終了コードについて説明します。
注記
すべてのインストーラーコマンドラインフラグは大文字と小文字を区別します。無効なフラグ、誤ったスペル、または大文字小文字の誤りは無視され、エラーメッセージは返されません。
既定インストール(ユーザー単位): コマンドラインフラグが指定されていない場合、インストーラーは既定の場所
%LOCALAPPDATA%\Alteryx\AlteryxOneでユーザー単位のインストールを実行します。例:
AlteryxOne-1.0.352-US-setup.exe/ALLUSERS: マシン上のすべてのユーザーにAlteryx Oneアプリをインストールするには、このフラグを使用します(マシン単位のインストール)。既定のインストール場所:
C:\Program Files\Alteryx\AlteryxOne例:
AlteryxOne-1.0.352-US-setup.exe /ALLUSERS
/S: インストーラーをサイレントモードで実行するにはこのフラグを使用します。使用すると、インストーラーはインタラクティブインストーラーを表示せず、サポートされている追加のフラグで変更されない限り、すべての既定設定が適用されます。例:AlteryxOne-1.0.352-US-setup.exe /SAlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS
/NOAUTOLAUNCH: このフラグを使用すると、インストール後にAlteryx Oneアプリが自動的に起動しないようにできます。このオプションは、サイレントインストール(/S)でのみサポートされています。例:
AlteryxOne-1.0.352-US-setup.exe /S /NOAUTOLAUNCHAlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH
/D=<path>: カスタムインストールディレクトリを指定するには、このフラグを使用します。要件と制限事項:
サイレントインストール(マシン単位)でのみサポートされています。
インストール先の指定は、マシン単位のインストールのみをサポートしており、ユーザー単位のインストールではサポートされていません。
インストーラーは、「AlteryxOne」サブフォルダーを指定された場所に自動的に追加します。
/D=C:\temp\Alteryxは、C:\temp\Alteryx\AlteryxOneにインストールされます。/D=C:\temp\AlteryxOneは、C:\temp\AlteryxOne\AlteryxOneにインストールされます。例:
AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\path\to\installLocationインストール先:
C:\InstallLocation\AlteryxOneスペースを含む例:
AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\Program Files\CustomLocationインストール先:
C:\Program Files\CustomLocation\AlteryxOne
/D=フラグに関する重要な考慮事項:/D=<path>パラメーターは、コマンドの最後の引数である必要があります。/D=の後に表示されるテキストは、追加のインストーラーフラグではなく、インストールパスの一部として解釈されます。たとえば、コマンド
AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D=C:\temp\Alteryx /S /NOAUTOLAUNCHは、C:\temp\Alteryx S NOAUTOLAUNCHにインストールされます。インストール先が予期しない場所に設定されるのを避けるため、必ず
/D=を最後の引数にしてください(AlteryxOne-1.0.359-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH /D=C:\temp\Alteryx)。/D=で指定したパスは引用符で囲まないでください。引用符を使用すると、インストーラーは/D=パラメーターを無視し、選択したインストールタイプの既定の場所にインストールされます。例:
AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D="C:\temp\Alteryx"結果:
/D=パラメーターは無視され、アプリケーションはC:\Program Files\Alteryx\AlteryxOneにインストールされます。
注記
サポートされていないフラグまたは誤って結合されたフラグはエラーメッセージを返しません。フラグによっては、インストーラーがサポートされていないオプションを無視したり、コマンドを予期しない方法で解釈したりする場合があります。カスタムインストールパスの場合は、必ず/D=を最後の引数にしてください。また、/D=で指定したパスは引用符で囲まないでください。
サイレントインストールを使用してAlteryx Oneをインストールする際のエラーコードのキャプチャ
サイレントインストールでは終了コードが返されるため、IT管理者は、インストールが正常に完了したか失敗したかをそれで判断できます。
これは、ユーザー単位およびマシン単位の両方のサイレントインストールに適用されます。インタラクティブインストールの場合、これらのエラーは画面のダイアログメッセージに表示されます。
オプションA: Windowsコマンドプロンプトの使用
Windows Commandプロンプトでstart /waitを使用して、インストーラーが終了するまでターミナルを開いたままにします。次に、%ERRORLEVEL%を使用してインストーラーの終了コードを表示します。
例: start /wait "" "AlteryxOne-1.0.359-US-setup.exe" /S /ALLUSERS echo Installer Exit Code: %ERRORLEVEL%
オプションB: PowerShellの使用
インストーラーが完了するのを待ってから終了コードをキャプチャするため、PowerShellで、Start-Processを使用して-Waitパラメーターと-PassThruパラメーターを指定します。
例:
$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" }
Alteryx Oneインストーラーの終了コード
終了コード | 分類 | 意味と原因 | 必要なアクション |
|---|---|---|---|
0 | 成功 | インストールまたはアンインストールは正常に完了しました。 | なし |
1 | ユーザーによる中止 | ユーザーがUIで[キャンセル]をクリックしたことにより、インストールは手動でキャンセルされました。 | インストールを再度実行します。 |
2 | すでに実行中 | Alteryx Oneインストーラーの別のインスタンスがすでに実行されています。 | 再試行する前に、他のセットアップインスタンスを閉じてください。 |
3 | アーキテクチャの不一致 | オペレーティングシステムが64ビットのWindowsではありません。 | サポートされている64ビットのWindowsオペレーティングシステムにインストールしてください。 |
4 | インストールの競合 | インストールモード間で競合が検出されました。たとえば、ユーザー単位のインスタンスが存在しているにもかかわらずマシン単位のインストールを実行している場合やその逆の場合などです。 | 続行する前に、競合しているインストールモードを完全にアンインストールしてください。 |
5 | ロックされたファイル/プロセスがアクティブ | 重要なアプリケーションプロセス、 | Alteryx Oneを閉じて更新サービスを停止してから、インストーラーを再度実行します。 |
6 | 権限が必要 | インストールモードには管理者権限が必要ですが、現在のユーザーまたはシェルにその権限がありません。これは通常、 | 管理者としてコマンドプロンプト、PowerShell、またはデプロイスクリプトを実行します。 |
注記
/Sを使用したサイレントデプロイの場合は、終了コード4、5、6に注意してください。これらは自動デプロイによく見られる失敗シナリオで、例えば、ユーザー単位のインスタンスがまだ存在している状態でマシン単位のインストールをプッシュしたり、Alteryx Oneが起動している状態でインストーラーを実行したりした場合に発生します。