Admina Tracker の配布（Microsoft Intune）

​

動作要件

​

配布ファイルのダウンロード

​

配布の全体像

• 構成プロファイル（ADMX テンプレート）: 組織の API キーや Organization ID などの設定値をレジストリのポリシー階層に配布します。
• Win32 アプリ: エージェント本体のプログラム、自動起動タスク、ローカルデータベースをユーザープロファイル配下に配置します。

1. ADMX テンプレートをインポートする
2. 構成プロファイルで設定値を配る
3. Win32 アプリを登録して対象グループに割り当てる

​

インストール手順

​

ステップ 1: ADMXテンプレートをインポートする

1. 配布パッケージに含まれる ADMX テンプレートファイル（AdminaTracker.admx）および言語ファイル（en-US/AdminaTracker.adml）を用意します
2. Microsoft Intune 管理センターにサインインします
3. デバイス > 構成 > ADMX のインポート タブを開きます
4. インポート をクリックし、.admx ファイルと .adml ファイルを対でアップロードします
5. 一覧でステータスが「使用可能」と表示されるまで待ちます

​

ステップ 2: 構成プロファイルで設定値を配る

1. Intune 管理センターで デバイス > 構成 > ポリシー タブを開き、+ 作成 > 新しいポリシー をクリックします
2. プラットフォームで Windows 10 以降、プロファイルの種類で テンプレート > インポートされた管理用テンプレート (プレビュー) を選択し、作成 をクリックします
   組み込みの「管理用テンプレート」ではなく、必ず「インポートされた管理用テンプレート (プレビュー)」を選択してください。
3. 名前と説明を入力し、次へ をクリックします
   • 名前: AdminaTrackerManagedPolicy
   • 説明: 次のテキストを貼り付けます
     Admina Tracker エージェントが読み取る API キー・組織 ID・ユーザーメールアドレスを配布します。このポリシーを削除すると、新規に展開した端末でエージェントがデータ収集を開始できなくなります（設定値を取得済みの端末は動作を継続します）。
     
4. 構成設定 で Admina Tracker カテゴリを開き、Admina Tracker: agent settings (API key, organization ID, user email) を 有効 に設定します。有効にすると 3 つの入力欄が表示されるので、それぞれ値を入力します
   • API key には、Admina の管理画面で生成した API キーを入力します
   • Organization ID には、Admina の Organization ID を入力します
   • User email には利用者のメールアドレスを入力します。既定値は %USEREMAIL% です。ユーザーごとに異なる値を配布する場合は、既定値のまま変更せず、後述の UserEmail の配布 を参照してください
   3 つの値は 1 つのポリシーにまとまっています。ApiKey・OrganizationID・UserEmail が個別のポリシーとして並ぶことはありません。いずれかを空欄にした場合、その値だけが設定解決順序の下位ソースへフォールバックします（空欄はエラーではありません）。
5. 割り当て で、配布対象のグループを選択します
   「ユーザーの構成」で設定し、ユーザー グループに割り当ててください。 このポリシーは「コンピューターの構成」にも表示されますが、そちらは使用しません。
6. 設定内容を確認してプロファイルを作成します

​

UserEmail を配布する

[Environment]::GetEnvironmentVariable('USEREMAIL', 'User')

​

ステップ 3: アプリを登録して割り当てる

1. Intune 管理センターで アプリ > Windows > 追加 を開きます
2. アプリの種類で Windows アプリ (Win32) を選択します
3. アプリ パッケージ ファイルの選択 で、配布用のパッケージファイル（.intunewin）をアップロードします
4. アプリ情報 で以下を設定します
   • 名前: Admina Tracker
   • 発行元: Money Forward i, Inc
   • 説明: 次のテキストを貼り付けます
     Admina Tracker は、IT 資産管理のために組織が配布しているエージェントです。デバイスの基本情報と業務アプリケーションの利用状況を収集し、Admina に送信します。インストールと更新は IT 管理者が管理しているため、利用者による操作は不要です。
     
   • ロゴ: 次の画像を右クリックして保存し、アップロードします（PNG・512 × 512）
     
   説明はポータル サイト アプリで利用者にも表示されます。 管理者用の識別メモではなく、利用者が読んで理解できる文章を入れてください。収集対象の記述は、自社で周知している内容に合わせて調整してください。ポータル サイトでの見え方は カテゴリ、これをポータル サイトで目立つように表示する、ロゴ でも変わります。
5. プログラム で以下を設定します
   • インストールコマンド:
     powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\Install-AdminaTracker.ps1 -SkipConfigure
     
   • アンインストールコマンド:
     powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\Uninstall-AdminaTracker.ps1
     
   • インストールの処理: ユーザー
   • デバイスの再起動: 何もしない
   • リターンコード: 0（成功）/ 1（失敗）
   インストールの処理は必ず ユーザー を選択してください。エージェントは各ユーザーのプロファイル領域にインストールされ、管理者権限（システムコンテキスト）は不要です。
6. 必要条件 で以下を設定します
   • オペレーティング システムのアーキテクチャ: x64
   • 最小オペレーティング システム: Windows 10 1809
7. 検出規則 で以下を設定します
   • 規則の形式: カスタム検出スクリプトを使用する
   • スクリプト ファイル: 配布物に含まれる Detect-AdminaTracker.ps1 をアップロード
   • 32 ビットプロセスとして実行: いいえ
   • 署名の確認を強制: いいえ
   検出スクリプトは引数を受け取れないため、配布物にはあらかじめ環境を焼き込んだ生成済みのスクリプトが含まれています。配布物に含まれているものをそのまま使用してください。別の環境向けのスクリプトをアップロードすると、検出が常に「未インストール」を返し、Intune がインストールを繰り返します。
8. 依存関係 と 置き換え は設定不要です。そのまま 次へ をクリックします
9. 割り当て の 必須 セクションで、配布対象の ユーザー グループ を追加します
   インストールの処理がユーザー コンテキストであるため、デバイス グループではなく ユーザー グループ を割り当ててください。
10. 確認と作成 で設定内容を確認し、作成 をクリックします

​

動作確認

​

Intune 管理センターで確認する

1. Intune 管理センターで アプリ > Windows > Admina Tracker を開きます
2. デバイスのインストール状態 または ユーザーのインストール状態 を確認します
3. 対象端末・ユーザーのステータスが「インストール済み」になっていることを確認します

​

端末側でエージェントの動作を確認する

# ローカルの診断状態を表示
& "$env:LOCALAPPDATA\AdminaTracker\admina-tracker.exe" status

# サーバーへの疎通・認証確認も合わせて実行
& "$env:LOCALAPPDATA\AdminaTracker\admina-tracker.exe" diag

"%LOCALAPPDATA%\AdminaTracker\admina-tracker.exe" status
"%LOCALAPPDATA%\AdminaTracker\admina-tracker.exe" diag

​

配布される設定値

​

アンインストール

​

アプリをアンインストールする

1. Intune 管理センターで アプリ > Windows > Admina Tracker を開きます
2. プロパティ > 割り当て の 編集 を開きます
3. 「必須」から対象グループを削除し、「アンインストール」セクションに対象のユーザーグループを追加します
4. 追加した行の グループ モード が「含まれる」になっていることを確認します
5. 保存すると、次回の端末同期の際にアンインストーラーが実行され、アプリ本体やスケジュールタスクが削除されます
6. デバイスのインストール状態 で「アンインストール済み」と表示されることを確認します

​

構成プロファイルの割り当てを外す

1. Intune 管理センターで デバイス > 構成 を開きます
2. Admina Tracker の構成プロファイルを開き、プロパティ > 割り当て を編集します
3. 対象グループを割り当てから削除して保存します
4. 端末同期により、レジストリのポリシー階層（Policies 配下）の設定値が自動的に削除されます

​

アンインストール時に削除されるリソース

​

トラブルシューティング

​

インストール状態が「失敗」になる

• 割り当て対象グループの確認: 配布先の割り当てが「デバイスグループ」になっていないか確認してください。インストールの処理がユーザーコンテキストであるため、「ユーザーグループ」への割り当てが必要です。
• Intune ログの確認: 端末側の C:\ProgramData\Microsoft\IntuneManagementExtension\Logs\IntuneManagementExtension.log や、インストール時のログを確認してエラーの原因を特定してください。

​

設定値が反映されない

• ADMX テンプレートの状態確認: Intune 管理センターの ADMX のインポート で、テンプレートのステータスが「使用可能」になっているか確認してください。
• プロファイル種類の確認: 組み込みの管理用テンプレートではなく、「インポートされた管理用テンプレート (プレビュー)」からプロファイルを作成しているか確認してください。

​

アンインストールが実行されない

Select-String -Path "C:\ProgramData\Microsoft\IntuneManagementExtension\Logs\AppWorkload.log" -Pattern "Admina" |
  Measure-Object | Select-Object Count

Restart-Service IntuneManagementExtension

Select-String -Path "C:\ProgramData\Microsoft\IntuneManagementExtension\Logs\AppWorkload.log" -Pattern "lpExitCode|EnforcementState" |
  Select-Object -Last 5 | ForEach-Object { $_.Line }

​

アンインストールしても残る

• 構成プロファイルのみ解除している: 構成プロファイルを外しただけでは、エージェント本体が削除されずに残ります。アプリの割り当てで「アンインストール」を設定してください。
• サインインしていないユーザーの残留: ユーザーコンテキストで動作するため、対象ユーザーが端末にサインインして同期を実行しない限りアンインストールは完了しません。共有 PC や休職者の端末では、対象ユーザーのセッションでアンインストールを実行してください。
• ファイルロックによる失敗: ウイルス対策ソフトのスキャンやアップデート処理によってファイルがロックされている場合、アンインストールが一時的に失敗することがあります。端末を一度サインアウトして再度サインインし、同期を再試行してください。