> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/devices/report-primary-user-mismatch_scheduled.md). # プライマリ ユーザーの不一致をレポート（スケジュール済み） Intune と RealmJoin 間のプライマリ ユーザーとログオンを比較 {% hint style="info" %} これはスケジュールされた runbook です。単一のオブジェクトに対してトリガーされるのではなく、繰り返しのスケジュールで実行されるように設計されています。詳細は [スケジューリング](/ja/zi-dong-hua/runbooks/scheduling.md) runbook のスケジュールの設定方法の詳細については {% endhint %} ### 説明 Windows デバイスについて、Intune に記録された主要ユーザーと RealmJoin に記録された主要ユーザーを比較し、両者が異なるすべてのデバイスを一覧表示します。また、Intune と RealmJoin エージェントが記録したログオンを使用して、実際に各デバイスに誰がログオンしているかを確認し、主要ユーザーがもはやログオンしていないデバイスを一覧表示します。どのカテゴリを一覧表示するかは runbook のカスタマイズで設定します。最近 Intune と同期したデバイスのみが対象です。レポートはメールで送信することも、ダウンロード リンクとして提供することもできます。 ### 仕組み runbook は 2 つの一覧を読み込み、Entra デバイス ID で照合します（代替として Intune デバイス ID を使用します）: * **Intune**: 直近の ～ 以内に同期を完了したすべての Windows デバイス *Intune の最終同期が (日) 以内*、それらの主要ユーザーと、そのデバイスで Intune が記録したログオンを含みます。Intune との同期を停止したデバイスは意図的に除外されます。それらは **古いデバイスをレポート（定期実行）** runbook です。 * **RealmJoin**: RealmJoin 顧客 API のデバイス一覧です。各デバイスについて、RealmJoin エージェントがサインイン済みとして報告したユーザーを保持し、各ユーザーには *最終確認時刻* のタイムスタンプと、そのうち RealmJoin が主要ユーザーとして扱うユーザーです。 各デバイスについて、runbook は 2 つの質問に答えます。主要ユーザーは一致しているか、そして主要ユーザーはまだログオンしているかです。各答えはカテゴリであり、デバイスは複数に属することがあります。RealmJoin エージェント自体がまだ報告しているかどうかは別の質問であり、 **RealmJoin エージェントの接続状況をレポート（定期実行）** runbook です。 ### カテゴリ | カテゴリ | 意味 | | ------------------------- | ------------------------------------------------------------------------------------------------------------------ | | `Mismatch` | Intune の主要ユーザーと RealmJoin の主要ユーザーが異なります。 | | `PrimaryUserDeleted` | Intune の主要ユーザーは Entra ID から削除されました。その場合、Intune はユーザーのオブジェクト ID をユーザー プリンシパル名の前に書き込みます。runbook はこれを認識し、不一致として数えません。 | | `PrimaryUserNotLoggingOn` | 別の誰かがそのデバイスにログオンしましたが、主要ユーザーは *主要ユーザーは (日) 以内にログオンしている必要があります*。そのデバイスは、記録された人物とは別の人が使用している可能性があります。 | | `MissingInRealmJoin` | そのデバイスは Intune に存在しますが、RealmJoin は認識していないか、主要ユーザーなしで認識しています。 | | `MissingInIntune` | RealmJoin はそのデバイスを認識していますが、同期期間内に Intune と同期されませんでした。 | どのカテゴリを一覧表示するかは runbook のカスタマイズで設定されます。既定では Mismatch のみ `Mismatch` が有効です。 `検出結果` デバイスが属するすべてのカテゴリ名を示す列。 #### ログオンの取得元 2 つのソースを組み合わせます: * **Intune** Intune は、デバイス上の最新のログオンを、ユーザーのオブジェクト ID とタイムスタンプ付きで記録します。runbook は ID をユーザー プリンシパル名に解決し、すでに存在しないユーザーは削除済みとして表示されます。 * **RealmJoin エージェント** サインイン中のユーザーのコンテキストで実行され、誰かがサインインしている間は 15 分ごとに RealmJoin に報告します。各報告で *最終確認時刻* そのデバイス上でのそのユーザーの最終確認時刻が更新されるため、デバイスの RealmJoin ユーザーとは、エージェントがサインイン済みとして確認した人々であり、それぞれ最終時刻が付いています。 どちらかのソースがログオン期間内にそのユーザーを確認した場合、主要ユーザーはログオンしたものとみなされます。 `PrimaryUserNotLoggingOn` には両方が必要です。つまり、他の誰かが確認され、主要ユーザーが期間内にいなかったことです。誰も一度も確認されなかったデバイスは、 `不明` の `PrimaryUserLogon` 列に表示され、ログオンしていないものとしてカウントされることはありません。 複数の人が意図的にログオンする共有デバイスでは、主要ユーザーに対してこの検出結果が生じます。 *Exclude devices from group*. #### デバイスの範囲 *Include devices from group* 比較をその Entra ID グループ内のデバイスに限定します, *Exclude devices from group* グループのデバイスを除外します。どちらも任意で、組み合わせ可能です。グループを選択すると、そのフィルターがただちに適用されます。 ### カテゴリの有効化 カテゴリの切り替えはポータルでは非表示で、runbook のカスタマイズで設定されるため、スケジュール実行では常に同じセットが報告されます。不一致に加えてログオン確認を有効にするカスタマイズ: ```json "rjgit-org_devices_report-primary-user-mismatch_scheduled": { "parameters": { "IncludeMismatches": { "Default": true }, "IncludePrimaryUserDeleted": { "Default": true }, "IncludePrimaryUserNotLoggingOn": { "Default": true }, "PrimaryUserLogonDays": { "Default": 30 } } } ``` 詳細については [ランブック カスタマイズ ガイド](https://docs.realmjoin.com/automation/runbooks/runbook-customization) が構文です。 ### レポート配信 レポートファイルは、配信方法が次の方法で選択された場合にのみ生成されます。 **レポート配信** オプション（メールおよび/またはダウンロードリンク）。 *Output Data のみ* 選択すると、結果は RealmJoin ポータルの Output Data タブで直接読み取られ、各テーブルは Excel にもエクスポートできます。メール配信とダウンロードリンクの生成は独立しており、組み合わせることができます。 ダウンロードリンクの場合、レポートファイルは、 `RJReport.StorageAccount.*` テナント設定で構成された Azure Storage Account にアップロードされ、時間制限付きの SAS ダウンロードリンクが返されます。ストレージへのアップロードは Automation アカウントのマネージド ID で認証します。その ID には、 **Reader and Data Access** RBAC ロールがターゲットの Storage Account に必要です（これは Azure RBAC の割り当てであり、Graph アプリケーション権限ではありません）。 次の前に作成されたスケジュールは **レポート配信** オプションが存在していた場合でも、保存された受信者だけで引き続きそのメール送信が有効になります。このようなスケジュールを編集のために開くと、オプションは *Output Data のみ*と表示されます。保存する前に配信方法を再度選択してください。そうしないと、スケジュールはレポートの送信を停止します。 ### 検出結果のない実行結果 有効なカテゴリに該当するデバイスがない場合、メールは送信されず、ファイルも作成されません。検出結果のない実行は通常どおり完了し、エラーではありません。Output Data タブには引き続き概要が表示されます。 ### RealmJoin API 資格情報に関するセットアップ runbook は RealmJoin 顧客 API を照会し、Azure Automation Account に保存された専用の資格情報を必要とします。同じ資格情報は API を使用するすべての runbook で使われるため、これは Automation Account ごとに 1 回だけのセットアップです。 1. **API 資格情報を取得する** - まだ RealmJoin API 資格情報がない場合は、 で依頼してください。ユーザー名の形式は次のとおりです。 `t-`、パスワードは API シークレットです。ここではポータルのログインは使えません。 2. **デバイス ユーザー機能を依頼する** - 顧客 API のデバイス一覧は、RealmJoin が Tenant ごとに有効化する機能です。資格情報とあわせて有効化するようサポートに依頼してください。これがないと API は HTTP 403 を返し、runbook はそのメッセージで停止します。 3. **Automation Account を開く** - Azure Portal で、runbook に使用している Automation Account を開きます。 4. **Shared Resources > Credentials に移動する** - 左側メニューの *Shared Resources*、 *Credentials*. 5. **新しい資格情報を追加する** - *資格情報を追加*. 6. **名前は正確に次のとおりにします `RJAPI`** - runbook はこの名前で検索します。これ以外の名前では資格情報の検索に失敗します。 7. **API のユーザー名とシークレットを入力する** - 手順 1 の値を使用します。 8. **保存** - *作成* して、runbook をもう一度実行します。 API は Tenant ごとに 1 分あたり 30 要求を許可し、それを超えると HTTP 429 を返します。runbook では 1 回の実行につき 1 要求が必要で、スロットリングされた要求は短い待機の後に最大 5 回まで再試行してから諦めます。 ### メール送信に関する設定 メールレポートの送信は任意であり、次の場合にのみ行われます。 *レポートもメール送信* または *メール送信とダウンロードリンクも追加* レポート配信として選択されると、受信者が必要になります。送信者アドレスは `RJReport.EmailSender` テナント設定から取得されます。 この runbook は Microsoft Graph API を使用してメールを送信します。Graph API 経由でメールを送信するには、runbook のカスタマイズで既存のメールアドレスを設定する必要があります。 この手順の詳細は、 [RealmJoin Report Settings のドキュメント](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings). #### メールのブランディング レポートメールでは、任意の `RJReport.Branding.*` テナント設定が反映されます: * **ヘッダーおよびフッター画像** - 公開 HTTPS URL、PNG/JPEG/GIF、各最大 200 KB * **フッターリンク** - フッター画像の参照先 * **アクセントカラーとテキストカラー** - 6桁の16進数値、例: `#0052cc` これらの設定が構成されていない場合は、既定の RealmJoin のグラフィックと色が使用されます。ダウンロードできない、または検証できない画像、あるいは無効な色値があっても、レポートメールが妨げられることはありません。代わりに該当する既定値が使用されます。 設定手順と画像要件: [メールのブランディング](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional). ### 注記と制限 * 比較されるのは Windows デバイスのみです。RealmJoin エージェントは Windows で実行されるため、RealmJoin には他のプラットフォームの主要ユーザーまたはログオン データがありません。 * レポートは実行ごとのスナップショットです。前回の実行は保持しないため、主要ユーザーが *変更された* 2 回の実行の間で変わったことは報告しません。比較したい場合は 2 つのレポート ファイルを比較してください。 * Intune が記録するログオンは最新のログオンのみを対象とし、RealmJoin エージェントは実行中にサインインしていたユーザーしか認識しません。そのため、めったにログオンしないユーザーはログオンしていないように表示されることがあります。 * RealmJoin に表示される主要ユーザーは、RealmJoin がエージェント報告から判定したユーザーであり、デバイスの Entra ID に登録された所有者ではありません。 ### 場所 Organization → Devices → Report Primary User Mismatch (Scheduled) **完全な Runbook 名** rjgit-org\_devices\_report-primary-user-mismatch\_scheduled ### 詳細 | プロパティ | 値 | | -------- | ------------------------------------------------------------------------------------------------------------------ | | バージョン | 1.8.0 | | 必須モジュール |

RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
Az.Accounts (>= 5.5.2)

| | スケジュール可能 | はい | ### 権限 #### アプリケーションのアクセス許可 * **種類**: Microsoft Graph * DeviceManagementManagedDevices.Read.All * *Intune の Windows デバイスを、主要ユーザー、最終同期時刻、およびログオンしたユーザーとともに読み取ります* * Directory.Read.All * *Intune のログオン記録からユーザー ID をユーザー プリンシパル名に解決し、任意の含めるグループおよび除外グループのデバイス メンバーを読み取ります* * Mail.Send *(オプション — 機能: メール レポート)* * *受信者が設定されている場合、Send-RjRbReportEmail を介してレポート メールを送信します* * Organization.Read.All *(オプション — 機能: メール レポート)* * *メール件名、メール本文、およびレポート ファイル名のためにテナントの表示名を読み取ります* #### アクセス許可に関する注意 RealmJoin 顧客 API: RealmJoin サポートが発行した、Tenant の API ユーザー名 (t-) とシークレットを含む Automation Account の資格情報 'RJAPI'。RealmJoin 顧客 API: この API の device users 機能は、Tenant に対して RealmJoin サポートが有効化する必要があります（有効でない場合、デバイス一覧は HTTP 403 を返します）。Azure Storage Account: 対象 Storage Account 上の Automation Account のマネージド ID に対して 'Reader and Data Access' ロールを付与します。アップロードでは listKeys を介してアカウント キーを取得します（ダウンロード リンク オプションでのみ必要）。 ### パラメーター #### SyncThresholdDays この日数以内に Intune と同期したデバイスのみが比較されます。まったく同期しなくなったデバイスは、代わりに古いデバイス レポートに含まれます。 | プロパティ | 値 | | ------- | -------------------- | | 必須 | false | | 既定値 | 30 | | 種類 | Int32 | | ポータル表示名 | Intune の最終同期が (日) 以内 | #### DeviceNamePrefix 名前がこの文字列で始まるデバイスのみ。すべて対象にする場合は空欄にします。 | プロパティ | 値 | | ------- | ------------- | | 必須 | false | | 既定値 | | | 種類 | 文字列 | | ポータル表示名 | デバイス名のプレフィックス | #### PrimaryUserLogonDays 他の誰かがそのデバイスにログオンし、主要ユーザーがこの日数以内にログオンしなかった場合、主要ユーザーはログオンしていないものとみなされます。 | プロパティ | 値 | | ------- | ------------------------------ | | 必須 | false | | 既定値 | 30 | | 種類 | Int32 | | ポータル表示名 | 主要ユーザーは (日) 以内にログオンしている必要があります | #### IncludeMismatches Intune と RealmJoin で主要ユーザーが異なるデバイスを一覧表示します。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | True | | 種類 | ブール値 | | ポータル表示名 | 不一致を含めますか？ | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### IncludeMissingInRealmJoin Intune に存在するが RealmJoin には存在しないデバイス、または RealmJoin が主要ユーザーなしで認識しているデバイスを一覧表示します。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | False | | 種類 | ブール値 | | ポータル表示名 | RealmJoin にないデバイスを含めますか？ | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### IncludeMissingInIntune RealmJoin に存在するが、同期期間内に Intune と同期しなかったデバイスを一覧表示します。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | False | | 種類 | ブール値 | | ポータル表示名 | Intune にないデバイスを含めますか？ | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### IncludePrimaryUserDeleted Intune の主要ユーザーが Entra ID から削除されたデバイスを一覧表示します。これがないと、Intune が削除済みユーザーの名前を書き換えるため、不一致のように見えます。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | False | | 種類 | ブール値 | | ポータル表示名 | 削除済みの主要ユーザーを含めますか？ | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### IncludePrimaryUserNotLoggingOn 他のユーザーはログオンしているが、"Primary user must have logged on within (days)" 以内に主要ユーザーがログオンしていないデバイスを一覧表示します。Intune と RealmJoin エージェントが記録したログオンを使用します。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | False | | 種類 | ブール値 | | ポータル表示名 | ログオンしていない主要ユーザーを含めますか？ | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### IncludeDeviceGroup この Entra ID グループ内のデバイスのみ。すべてのデバイスを対象にする場合は空欄にします。 | プロパティ | 値 | | ------- | -------------------------- | | 必須 | false | | 既定値 | | | 種類 | 文字列 | | ポータル表示名 | Include devices from group | #### ExcludeDeviceGroup この Entra ID グループ内のデバイスを除外します。たとえば、複数の人が意図的にログオンする共有デバイスです。何も除外しない場合は空欄にします。 | プロパティ | 値 | | ------- | -------------------------- | | 必須 | false | | 既定値 | | | 種類 | 文字列 | | ポータル表示名 | Exclude devices from group | #### SendEmailReport レポートを受信者のメールアドレスに送信します。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | False | | 種類 | ブール値 | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### EmailTo レポートをこれらの宛先に送信します。複数ある場合はカンマで区切ってください。各受信者には個別のメールが届きます。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | | | 種類 | 文字列 | | ポータル表示名 | 宛先メールアドレス | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### EmailFrom レポートメールの送信元アドレス。テナント設定 RJReport.EmailSender から取得されます。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | | | 種類 | 文字列 | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### BrandingHeaderImageUrl レポートメールのヘッダー画像 (HTTPS URL、PNG/JPEG/GIF、最大 200 KB)。テナント設定 RJReport.Branding.HeaderImageUrl から取得されます。空の場合は既定の RealmJoin ヘッダーが使用されます。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | | | 種類 | 文字列 | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### BrandingFooterImageUrl レポートメールのフッター画像 (HTTPS URL、PNG/JPEG/GIF、最大 200 KB)。テナント設定 RJReport.Branding.FooterImageUrl から取得されます。空の場合は既定の RealmJoin フッターが使用されます。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | | | 種類 | 文字列 | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### BrandingFooterLink レポートメールのフッター画像のリンク先。テナント設定 RJReport.Branding.FooterLink から取得されます。空の場合は realmjoin.com が使用されます。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | | | 種類 | 文字列 | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### BrandingAccentColor レポートメールのアクセントカラーを 6 桁の 16 進数値で指定します。テナント設定 RJReport.Branding.AccentColor から取得されます。空または無効な場合は RealmJoin の既定値が使用されます。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | | | 種類 | 文字列 | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### BrandingTextColor レポートメールのテキストカラーを 6 桁の 16 進数値で指定します。テナント設定 RJReport.Branding.TextColor から取得されます。空または無効な場合は RealmJoin の既定値が使用されます。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | | | 種類 | 文字列 | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### ReportFileFormat レポートを CSV、Excel ブック、またはその両方で配信します。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | CSV と XLSX | | 種類 | 文字列 | | ポータル表示名 | レポート ファイルの形式 | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | **ポータルのオプション** | ポータル オプション | 値 | | ---------- | ---------- | | CSV と XLSX | CSV と XLSX | | CSV のみ | CSV のみ | | XLSX のみ | XLSX のみ | #### CreateDownloadLink レポートもアップロードし、数日後に期限切れになるダウンロード リンクを返します。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | False | | 種類 | ブール値 | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### コンテナー名 レポート ファイルがアップロードされるストレージ コンテナーです。runbook ごとに設定します。 | プロパティ | 値 | | -------- | ---------------------------- | | 必須 | false | | 既定値 | report-primary-user-mismatch | | 種類 | 文字列 | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### リソース グループ名 レポート アップロード用のストレージ アカウントのリソース グループです。Tenant 設定 RJReport.StorageAccount.ResourceGroup から取得されます。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | | | 種類 | 文字列 | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### Storage Account 名 レポート アップロード用の Storage Account です。Tenant 設定 RJReport.StorageAccount.StorageAccountName から取得されます。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | | | 種類 | 文字列 | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | #### LinkExpiryDays ダウンロード リンクが有効なままの期間（日数）です。Tenant 設定 RJReport.StorageAccount.LinkExpiryDays から取得されます。 | プロパティ | 値 | | -------- | ------------------------- | | 必須 | false | | 既定値 | 6 | | 種類 | Int32 | | ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) | [Runbook リファレンスの概要に戻る](/ja/zi-dong-hua/runbooks/runbook-references.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/devices/report-primary-user-mismatch_scheduled.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.