アプリケーションの設定は本来シンプルなプロセスであるべきです。インストーラーを実行すれば、それで完了です。しかし、実際にはそうならないことがよくあります。単一のMSIではないWindowsアプリは通常、Win32アプリとして設定する必要があり、IntuneがWin32アプリとして受け付けるのは .intunewinファイルのみです。これらのファイルを作成するために、管理者はIntune Win32 Content Prep Tool(IntuneWinAppUtil.exe)を使用します。
このツールは比較的シンプルですが、セットアップファイルのタイプミスのようなちょっとしたミスでも、インストールに失敗することがあります。さらに、新しいアプリのバージョンが出るたびに、そのプロセスを最初からやり直さなければなりません。
このガイドでは、完全なコマンド構文、すべてのパラメーター、MSI、EXE、PSADTアプリをパッケージ化する方法、その後Intuneで設定する内容、さらにパッケージを最新の状態に保つ方法までを網羅しています。このトピックが初めての場合は、まずアプリケーションのパッケージ化とは何かの概要をご覧ください。
Intune Win32 Content Prep Toolの動作
Intune Win32 Content Prep Toolは、アプリのインストールファイルを .intunewin に変換する無料のMicrosoftコマンドラインツールです形式を整え、Intune がインストール状態を 判断するために必要ないくつかの属性を検出します。この形式は Intune が Win32 アプリをインストールするために必要なため、変換が必要になることがよくあります。
MSI セットアップファイルの場合、このツールは Intune が MSI から必要とする情報も読み取ります。
このツールは、サブフォルダーを含むセットアップフォルダー内のすべてを 1 つの .intunewin に圧縮します。ファイルを生成します。そのファイルには、暗号化されたセットアップファイルと、それらを暗号解読するために必要な情報が含まれているため、元のインストーラーと同じくらい慎重に保管してください。ただし、このツールでできるのはパッケージの作成のみで、インストールコマンドや検出ルールの記述、または何かのアップロードは行いません。
開始前に必要なもの
Intune Win32 Content Prep Toolを使用する際は、スムーズかつ効率的に進められるよう、事前に準備しておきましょう。アプリケーションの準備を始める前に、以下を確認してください。
Windows マシンと .NET Framework 4.7.2 が必要です。パッケージに無関係なファイルが含まれるのを避けるため、クリーンなパッケージング用ワークステーションを使用することをおすすめします。
Content Prep Tool自体は、MicrosoftのGitHubリポジトリから .zip としてダウンロードできます。現在のバージョンは1.8.7で、.zipにはツール、ライセンス、readme、リリースノートが含まれています。
Intune を通じて展開される Win32 アプ リはユーザーの操作なしでインストールする必要があるため、サイレントインストールに対応したインストーラーが必要です。MSI サイレントインストールとEXE サイレントインストールのガイドでは、それぞれのスイッチを紹介しています。
アプリは30 GB未満である必要があります。IntuneではWin32アプリは1つあたり30 GBが上限のため、それより大きいアプリはこの方法では設定できません。
サポートされている対象デバイス。設定先のデバイスは、Windows Enterprise、Pro、または Education を実行し、Microsoft Entra ID に登録または参加済みで、Intune に登録されている必要があります。
.intunewinを作成する方法Content Prep Toolでファイルを
必要なものがすべて揃ったら、Content Prep Tool を使って .intunewin を作成できますファイル。手順は次の数ステップです。
GitHub からツールをダウンロードして展開し、専用のフォルダー(例: C:\Tools\ContentPrep)に保存します。
インストーラーと、それをサポートするファイル(MST変換ファイル、構成ファイル、スクリプトなど。例: C:\Packages\AppName)のみを格納するソースフォルダーを作成します。このツールはこのフォルダ内のすべてのファイルとサブフォルダをパッケージ化するため、ツール本体と無関係なファイルはどちらもこのフォルダに入れないでください。
出力フォルダーはソースフォルダーの外部(C:\Output など)を選択してください。ソースフォルダー内にあると、次回の実行時に古い .intunewin がパックされて新しいものの中に含まれてしまいます。
ツールを実行します。IntuneWinAppUtil.exe はパラメーターなしで実行することもでき、その場合は各フォルダーの入力を求めるプロンプトが表示されます。または、1行で実行することもできます。スペースを含むパスには引用符が必要であることに注意してください:
IntuneWinAppUtil.exe -c C:\Packages\AppName -s setup.exe -o C:\Output -q新しい .intunewin が出力フォルダーにあることを確認しますファイルを生成します。特に -q を使用する場合は、バージョン同士が上書きされないように、アプリの各バージョンごとに別の出力フォルダーを必ず保持してください。
インストールコマンドで参照する必要がある補助ファイルがある場合は、それをソースフォルダーのサブフォルダーに配置し、licenses\license.txt のような相対パスを使用できます。
IntuneWinAppUtil コマンドラインパラメーター
Content Prep Toolを使用すると、静音モードで実行するかどうかや、コンテンツの出力先などのパラメーターを設定できます。これらのコマンドラインパラメーターを理解することで、インストールをより細かく制御でき、スムーズな設定にも役立ちます。
コマンドラインパラメーターは次のとおりです。
パラメーター | 機能 |
-h | 使用方法ヘルプを表示します |
-v | ツールのバージョンを表示します(1.8.2 以降) |
-c <setup_folder> | .intunewin に内容全体が含まれるフォルダー |
-s <setup_file> | setup.exe や setup.msi などの設定ファイル |
-o <output_folder> | .intunewinの出力先。静音モードでは、存在しない場合は作成されます |
-a <catalog_folder> | Windows 10 S modeにバンドルされているカタログファイル |
-q | サイレントモード:プロンプトを表示せず、既存の出力を上書きします |
-qのすべてに加え、コンソール出力なし |
-q と -qq の両方を使用した場合は、後者が優先されることに注意してください。
さらに、バージョン1.8.2では、出力をログファイルにリダイレクトする機能が追加されました。これは、スクリプト内でパッケージ化を実行する際に便利です。例:
IntuneWinAppUtil.exe -c SomeSample -s Setup.exe -o .-q > test.log
Intune 用に MSI、EXE、PSADT アプリをパッケージ化する方法
Intune向けにアプリをパッケージ化する場合、セットアップファイルはインストーラーの種類によって異なります。その結果、MSI、EXE、PSADTインストーラーにはいくつかの重要な違いがあります。アプリをパッケージ化する際は、次の重要なポイントを押さえておきましょう。
MSI インストーラー
.msi をセットアップファイルとして指定すると、このツールは Intune に必要な情報を MSI から読み取ります。そのため、MSI パッケージは最も簡単に設定できます。変換ファイル(.mst)を使用する場合は、それがパッケージに含まれるよう、必ず同じソースフォルダーに配置してください。インストールコマンドで使用するスイッチとプロパティについては、msiexec silent install guide をご覧ください。
MSIs は Win32 としてラップしなくても十分簡単に設定できますが、場合によってはラップが依然として必要になることがあります。Intune の基幹業務向け MSI タイプではコマンドライン引数を 1 つしか指定できないため、それより複雑な場合は Win32 が必要です。
EXEインストーラー
.exe を渡す必要がある場合はこれをセットアップファイルとして使用する場合、ツールは MSI ファイルからしかアプリの詳細を読み取れないため、Intune でインストールおよびアンインストールコマンドに加え、検出ルールも手動で設定する必要があります。サイレントスイッチは、Inno Setup、NSIS、InstallShield など、インストーラーの構築に使われたフレームワークによって異なります。確認方法については、EXE サイレントインストールガイドをご覧ください。
PSADTパッケージ
PowerShell App Deployment Toolkit(PSADT)パッケージを使用している場合は、設定フォルダー全体に対してそのツールを実行してください。そこから、Invoke-AppDeployToolkit.exe をセットアップファイルとして使用すると、ツールキットフォルダー全体(Files、Config、モジュールを含む)が .intunewin に入ります。
たとえば、次のようになります。
IntuneWinAppUtil.exe -c C:\Packages\YourApp -s Invoke-AppDeployToolkit.exe -o C:\Output
.intunewin の作成後に Intune で設定する内容
.intunewin のファイルが作成された後も、検出ルールや要件ルールなどを設定するために、引き続き Intune を構成する必要があります。[アプリ] → [すべてのアプリ] → [作成] → [Windows アプリ (Win32)] に移動し、.intunewin をアップロードしますファイルを開いて、必要な設定を行います。Intune では古いバージョンで作成されたパッケージに警告が表示されるため、最新バージョンの Content Prep Tool を使用してください。
より詳しいガイドは、Microsoft Learnで確認できます。WinGet リポジトリからアプリを設定する場合は、Intune で WinGet アプリを設定する方法をご覧ください。
インストールおよびアンインストールのコマンド
インストールコマンドとアンインストールコマンドは、インストーラーの実行方法を Intune に伝えます。インストールコマンドには、ApplicationName.exe /quiet のようなコマンドライン、または最大 50 KB のアップロードされた PowerShell スクリプトを指定できます。いずれのコマンドフィールドで powershell.exe を呼び出しても 32 ビット版 PowerShell が起動するため、64 ビット版が必要な場合は %SystemRoot%\Sysnative\WindowsPowerShell\v1.0\powershell.exe を使用してください。アンインストールコマンドでは環境変数が展開されないため、必要な場合はパッケージにラッパースクリプトを含めてください。
インストーラーが完了すると、その終了コードによって、Intune は成功したか(0)、再試行が必要か(1618)、または完了するために再起動が必要か(3010 または 1641)を判断します。アプリを作成するときに、各戻りコードを Intune がどのように扱うかを確認して編集できます。再試行コードにより、5 分間隔で最大 3 回まで試行されます。
