デバイスの準拠を確認

デバイスの準拠状態を確認

説明

この Runbook は、Microsoft Intune から管理対象デバイスのコンプライアンス状態を取得します。簡易モードでは、全体のコンプライアンス状態を表示し、準拠していないポリシーを一覧表示します。詳細モードでは、さらにどの個別設定が失敗しているかと、それぞれの失敗理由を表示します。必要に応じて、完全なコンプライアンス詳細を含むレポートをメールで送信できます。

メール送信に関する設定

メール レポートの送信は任意で、受信者（EmailTo）が指定されている場合にのみ行われます。送信元アドレスは RJReport.EmailSender Tenant 設定から取得されます。

この Runbook は Microsoft Graph API を使用してメールを送信します。Graph API 経由でメールを送信するには、Runbook のカスタマイズで既存のメール アドレスを構成する必要があります。

次を参照してください RealmJoin レポート設定のドキュメント 利用可能なすべての設定の詳細について

メールのブランディング

レポート メールでは、任意の RJReport.Branding.* Tenant 設定が適用されます：

• ヘッダー画像とフッター画像 – 公開 HTTPS URL、PNG/JPEG/GIF、各最大 200 KB
• フッターリンク – フッター画像のリンク先
• アクセントカラーとテキストカラー – 6 桁の 16 進数値。例： #0052cc

これらの設定が構成されていない場合は、既定の RealmJoin のグラフィックと色が使用されます。ダウンロードまたは検証できない画像や無効な色の値があっても、レポート メールが送信されないことはありません。代わりに、該当する既定値が使用されます。

設定手順と画像要件： メールのブランディング.

場所

デバイス → 一般 → デバイス コンプライアンスの確認

Runbook の完全名

rjgit-device_general_check-device-compliance

詳細

プロパティ	値
バージョン	1.2.0
必須モジュール	RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0)
スケジュール実行可能	いいえ

アクセス許可

アプリケーションのアクセス許可

• 種類: Microsoft Graph

  • DeviceManagementManagedDevices.Read.All

    • 管理対象デバイス、そのコンプライアンス ポリシーの状態、およびポリシーごとの設定状態を読み取ります
  • Organization.Read.All

    • コンプライアンス レポートに表示される Tenant の表示名のために /organization を読み取ります
  • Mail.Send （任意 — 機能：メール レポート）

    • EmailTo が構成されている場合、Send-RjReportEmail を介してコンプライアンス レポートのメールを送信します

パラメーター

DeviceId

対象デバイスの Entra ID デバイス ID です。RealmJoin プラットフォームによって自動的に渡されます。

プロパティ	値
必須	はい
既定値
種類	文字列
ポータルで非表示	はい（Runbook のカスタマイズで事前設定済み）

DetailedOutput

「Simple」（最終値：$false）を選択すると、全体のコンプライアンス状態と準拠していないポリシー名のみを表示します。「Detailed」（最終値：$true）を選択すると、さらにどの個別設定が失敗しているかと、それぞれの失敗理由を表示します。

プロパティ	値
必須	いいえ
既定値	いいえ
種類	ブール値
ポータル表示名	出力モード

ポータルオプション

ポータルオプション	値
Simple - 全体のコンプライアンス状態と準拠していないポリシーを表示	いいえ
Detailed - 失敗している設定とポリシーごとの理由を表示	はい

EmailTo

任意 - 指定した場合、コンプライアンス レポートが指定されたメール アドレス宛に送信されます。単一のアドレスでも、カンマ区切りの複数アドレスでも指定できます。

プロパティ	値
必須	いいえ
既定値
種類	文字列
ポータル表示名	受信者のメール アドレス（任意）

EmailFrom

送信元のメール アドレスです。これは Runbook のカスタマイズで構成する必要があります。

プロパティ	値
必須	いいえ
既定値
種類	文字列
ポータルで非表示	はい（Runbook のカスタマイズで事前設定済み）

BrandingHeaderImageUrl

レポート メール用のカスタム ヘッダー画像（PNG/JPEG/GIF、最大 200 KB）の任意の公開 HTTPS URL。RJReport.Branding.HeaderImageUrl の Tenant 設定から取得されます。空欄の場合は、既定の RealmJoin ヘッダー画像が使用されます。

プロパティ	値
必須	いいえ
既定値
種類	文字列
ポータルで非表示	はい（Runbook のカスタマイズで事前設定済み）

BrandingFooterImageUrl

レポート メール用のカスタム フッター画像（PNG/JPEG/GIF、最大 200 KB）の任意の公開 HTTPS URL。RJReport.Branding.FooterImageUrl の Tenant 設定から取得されます。空欄の場合は、既定の RealmJoin フッター画像が使用されます。

プロパティ	値
必須	いいえ
既定値
種類	文字列
ポータルで非表示	はい（Runbook のカスタマイズで事前設定済み）

BrandingFooterLink

フッター画像のリンク先となる任意の URL。RJReport.Branding.FooterLink の Tenant 設定から取得されます。空欄の場合は、既定のリンク（https://www.realmjoin.com）が使用されます。

プロパティ	値
必須	いいえ
既定値
種類	文字列
ポータルで非表示	はい（Runbook のカスタマイズで事前設定済み）

BrandingAccentColor

レポート メール テンプレート用の任意のアクセントカラー上書き（6 桁の 16 進数、例：'#0052cc'）。RJReport.Branding.AccentColor の Tenant 設定から取得されます。空欄または無効な場合は、既定の RealmJoin アクセントカラーが使用されます。

プロパティ	値
必須	いいえ
既定値
種類	文字列
ポータルで非表示	はい（Runbook のカスタマイズで事前設定済み）

BrandingTextColor

レポート メール テンプレート用の任意のテキストカラー上書き（6 桁の 16 進数）。RJReport.Branding.TextColor の Tenant 設定から取得されます。空欄または無効な場合は、既定の RealmJoin テキストカラーが使用されます。

プロパティ	値
必須	いいえ
既定値
種類	文字列
ポータルで非表示	はい（Runbook のカスタマイズで事前設定済み）

Runbook Reference の概要に戻る