> 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/list-mobile-devices.md).

# モバイル デバイスを一覧表示

モバイル固有のインベントリ、セキュリティ、ネットワークの詳細を含む、管理対象のすべてのモバイル デバイス (Android、iOS/iPadOS) を一覧表示します。

### 説明

IMEI、シリアル番号、電話番号、キャリア、所有権、コンプライアンス、登録の詳細など、モバイル固有のインベントリを含む、Intune で管理されているすべてのモバイル デバイスを一覧表示します。必要に応じて、各デバイスに最後に報告された IP アドレスとサブネット、ICCID、eSIM 識別子、セルラー技術、UDID、バッテリー状態、および Shared iPad の状態が追加され、デバイスが最後にどの（Wi-Fi）ネットワークでアクティブだったかを把握するのに役立ちます。結果は、プラットフォーム、Entra デバイス グループ、および/またはプライマリ ユーザーのユーザー グループで絞り込めます。必要に応じて、完全なインベントリを CSV および/または Excel（xlsx）の添付ファイルとしてメール レポートで送信することも、Azure Storage Account にアップロードして期限付きのダウンロード リンクを返すこともできます。受信者もダウンロード リンク オプションも指定しない場合、ランブックは結果をジョブ出力にのみ表示します。ReportFileFormat パラメーターは、生成および配信されるファイル形式（CSV のみ、CSV & XLSX、または XLSX のみ）を制御します。CSV 添付ファイルがメール サイズ上限を超え、"CSV & XLSX" が選択されている場合、メールは Excel ワークブックのみになります。

### 出力列

ランブックは要約ブロック（プラットフォームごとのデバイス数、コンプライアンス状態と所有権、適用済みフィルター、さらにネットワーク詳細が有効な場合は、報告された IP アドレスがないデバイス数）を出力し、その後に最大 3 つの表を続けます。同じデータは、必要に応じてメール レポートおよび/またはダウンロード リンクとして配信できます。詳細は [レポート配信](#report-delivery).

#### インベントリ（常に表示）

| 列                    | 由来と意味                                                                   |
| -------------------- | ----------------------------------------------------------------------- |
| DeviceName           | Intune によって報告されたデバイス名                                                   |
| User                 | プライマリ ユーザーのユーザー プリンシパル名                                                 |
| OS / OSVersion       | オペレーティング システム（Android、iOS、iPadOS）とバージョン                                 |
| Manufacturer / Model | ハードウェアの製造元とモデル                                                          |
| SerialNumber         | ハードウェアのシリアル番号                                                           |
| IMEI                 | デバイスの International Mobile Equipment Identity                           |
| PhoneNumber          | SIM の電話番号 - 次の場合にのみ表示されます `IncludePhoneNumber` が有効な場合。それ以外では列は完全に省略されます |
| Carrier              | SIM の加入者キャリア                                                            |
| Ownership            | `企業` または `個人`                                                           |
| Compliance           | Intune のコンプライアンス状態                                                      |
| LastSync             | 最後に成功した Intune チェックインのタイムスタンプ                                           |

#### セキュリティと登録（常に表示）

| 列                                  | 由来と意味                                                                             |
| ---------------------------------- | --------------------------------------------------------------------------------- |
| Supervised                         | iOS/iPadOS の監視モード                                                                 |
| Encrypted                          | デバイスの暗号化状態                                                                        |
| Jailbroken                         | デバイスが脱獄済みか root 化されているかどうか                                                        |
| ThreatState                        | モバイル脅威防御（MTD）パートナーによって報告された脅威状態（MTD パートナーが接続されている場合にのみ意味があります）                    |
| PatchLevel                         | Android のセキュリティ パッチ レベル（iOS/iPadOS では空）                                           |
| EnrollmentType / EnrollmentProfile | デバイスがどのように登録されたかと、使用された登録プロファイル                                                   |
| Category                           | Intune デバイス カテゴリ                                                                  |
| FreeGB / TotalGB                   | 空き容量と合計ストレージ（デバイスが使用可能なストレージ インベントリを報告しない場合は空。Android Enterprise のワーク プロファイルで一般的） |
| Enrolled                           | 登録日                                                                               |

#### ネットワークとSIM（ `IncludeNetworkDetails` を有効にした場合のみ - 既定では無効）

| 列             | 由来と意味                                                                 |
| ------------- | --------------------------------------------------------------------- |
| IPv4 / Subnet | デバイスによって報告された最後の IP アドレスとサブネット - デバイスが最後にアクティブだった（Wi-Fi）ネットワークの最も近い指標 |
| WiFiMAC       | デバイスの Wi-Fi MAC アドレス                                                  |
| ICCID         | SIM カードの一意の識別番号                                                       |
| ESIM          | eSIM がプロビジョニングされている場合の eSIM 識別子                                       |
| Cellular      | デバイスのセルラー技術                                                           |
| UDID          | 一意のデバイス識別子（iOS/iPadOS）                                                |
| BatteryHealth | 報告されている場合のバッテリー健全性の割合                                                 |
| Shared        | デバイスが Shared iPad であるかどうか                                             |
| LastSync      | 最後に成功した Intune チェックインのタイムスタンプ - IP 情報の古さを示します                         |

この表はサブネット順に並べ替えられているため、デバイスは最後に検出されたネットワークごとに視覚的にグループ化されます。

### データの鮮度と制約

すべての値は、最後に成功した Intune デバイス チェックインの状態を表しており、必ずしも現在の状態ではありません。常に LastSync 列と合わせて解釈してください。Intune はデバイスの Wi-Fi SSID を報告しません。最後に報告された IP アドレスとサブネットが最も近いネットワークの指標です。なお、報告された IP アドレスは、デバイスが最後にモバイル データ経由でチェックインした場合、セルラー接続に由来することもあります。Intune は個人所有デバイスの電話番号を部分的にマスクしますが、それは `IncludePhoneNumber` 設定から取得されます。

### パフォーマンス上の考慮事項

ネットワーク/SIM の詳細は既定で無効であり、大規模な Tenant や多数のモバイル デバイスがある場合は慎重に有効化してください。Microsoft Graph はこれらの値を単一デバイス要求でのみ返し、デバイス一覧応答では返しません。ランブックは常に Graph バッチ エンドポイント経由で、最大 20 件ずつのチャンクに分けてこれらの要求を送信しますが、実行時間はデバイス数に比例して増加します。数千台のモバイル デバイスがあると、それに応じて実行時間が長くなり、Graph のスロットリング リスクも高まります（スロットルされた要求は、Graph によって報告された待機時間を使って自動的に再試行されます）。大規模な環境では、 `IncludeNetworkDetails` グループ スコープ フィルターと組み合わせてください。

### スコープ フィルタリング

スコープは、Entra デバイス グループのメンバー（`IncludeDeviceGroup`）および/またはプライマリ ユーザーがユーザー グループのメンバーであるデバイス（`IncludeUserGroup`）に限定できます。両方のフィルターが設定されている場合、デバイスは両方に一致する必要があります。推移的なメンバーシップが解決されるため、ネストされたグループのメンバーも含まれます。

### レポート配信

既定では、ランブックは表をジョブ出力に表示するだけです。組み合わせ可能な任意の配信チャネルが 2 つあります:

* **メール レポート** (`EmailTo`）：完全なインベントリを CSV および/または Excel ワークブック（`ReportFileFormat`、既定 `XLSX のみ`）です。 `RJReport.EmailSender` 設定が必要です。メールのブランディングは `RJReport.Branding.*` 設定から取得され、他のレポート ランブックと同様です。CSV 添付ファイルがメール サイズ上限を超え、 `CSV と XLSX` が選択されている場合、メールは Excel ワークブックのみになります。
* **ダウンロード リンク** (`CreateDownloadLink`）：レポート ファイルを、 `RJReport.StorageAccount.*` 設定（コンテナー `list-mobile-devices` を既定で使用し、時間制限付きの SAS ダウンロード リンクをジョブ出力に出力します。インベントリがメール添付には大きすぎる場合や、資産管理に直接渡す必要がある場合に適しています。

上記の表のすべての列が含まれます。 `DeviceId`。 `PhoneNumber` ネットワーク/SIM 列は、対応するオプションが有効な場合にのみファイルに含まれます。コンプライアンス違反のデバイスは Excel ワークブックで強調表示されます。選択したプラットフォームとフィルターに一致するモバイル デバイスがない場合、ファイルは作成されません。

### 場所

Organization → Devices → List Mobile Devices

**完全な runbook 名**

rjgit-org\_devices\_list-mobile-devices

### 詳細

| プロパティ    | 値                                                                                                                 |
| -------- | ----------------------------------------------------------------------------------------------------------------- |
| バージョン    | 1.0.0                                                                                                             |
| 必要なモジュール | <p>RealmJoin.RunbookHelper (>= 0.8.9)<br>Microsoft.Graph.Authentication (>= 2.39.0)<br>Az.Accounts (>= 5.5.2)</p> |
| スケジュール可能 | いいえ                                                                                                               |

### 注記

Intune はデバイスの Wi-Fi SSID を報告しません。最後に報告された IP アドレスとサブネットが最も近いネットワークの指標であり、最後のデバイス チェックインの状態を表す Last Sync 列と常に合わせて解釈する必要があります。これはモバイル データ経由で発生していた可能性もあります。

前提条件:

* メール レポートが要求される場合、ランブックのカスタマイズ（RJReport.EmailSender 設定）で EmailFrom パラメーターを構成する必要があります
* ダウンロード リンクが要求される場合、RJReport.StorageAccount.\* 設定を構成する必要があります

データ ソースと鮮度: すべての値は、各デバイスの Intune インベントリから取得され、通常のデバイス チェックインで更新されます。したがって、これらは最後に成功したチェックインの状態を示しており、必ずしも現在の状態ではありません。ネットワークおよび SIM の詳細（IP アドレス、サブネット、ICCID、UDID など）は Graph のデバイス一覧応答には含まれず、デバイスごとに 1 回の追加 Graph 要求で取得されます。これらの要求は、Graph バッチ エンドポイント経由で最大 20 件ずつ送信されます。

パフォーマンス: ネットワーク/SIM の詳細は既定で無効です。有効にすると、実行時間はモバイル デバイス数に比例して増加します。モバイル デバイスが多い Tenant では、このオプションをグループ スコープ フィルターと組み合わせてください。

一般的な使用例:

* IMEI、シリアル番号、電話番号、キャリアを含むすべてのモバイル デバイスのインベントリ
* 倉庫の各拠点など、モバイル デバイスが最後にアクティブだった（Wi-Fi）ネットワークを特定する
* モバイル フリートのコンプライアンス、監視、暗号化状態を確認する
* ICCID と eSIM 識別子による SIM/eSIM インベントリ
* 完全なモバイル インベントリを Excel ワークブックまたは CSV ファイルとして資産管理に渡す

### アクセス許可

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

* **種類**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *ハードウェア、SIM、ネットワークの詳細を含む Intune 管理モバイル デバイスを一覧表示します*
  * Directory.Read.All *（任意 — 機能: グループ スコープ フィルタリング）*
    * *任意のデバイス/ユーザー グループのスコープ フィルターを解決するためにグループ メンバーを読み取ります*
  * Organization.Read.All *（任意 — 機能: メール レポート / ダウンロード リンク）*
    * *レポート ファイル名、メール件名、メール フッターに使用される Tenant 名を取得するために /organization を読み取ります。これがない場合、ランブックは 'Unknown Tenant' にフォールバックします*
  * Mail.Send *(オプション — 機能: メール レポート)*
    * *EmailTo が構成されている場合、Send-RjRbReportEmail を使用してレポート メールを送信します*

#### アクセス許可に関する注記

Azure Storage Account: 対象 Storage Account 上の Automation Account のマネージド ID に対する 'Storage Account Contributor' ロール - アップロードでは listKeys 経由でアカウント キーを取得します（CreateDownloadLink を使用する場合のみ必要）

### パラメーター

#### Android

結果に Android デバイスを含めます。

| プロパティ   | 値                |
| ------- | ---------------- |
| 必須      | いいえ              |
| 既定値     | True             |
| 種類      | ブール値             |
| ポータル表示名 | Android デバイスを含める |

#### iOS

結果に iOS および iPadOS デバイスを含めます。

| プロパティ   | 値                   |
| ------- | ------------------- |
| 必須      | いいえ                 |
| 既定値     | True                |
| 種類      | ブール値                |
| ポータル表示名 | iOS/iPadOS デバイスを含める |

#### IncludeNetworkDetails

最後に報告された IP アドレスとサブネット、ICCID、eSIM 識別子、セルラー技術、UDID、バッテリー状態、Shared iPad の状態を出力に追加します。デバイスごとに 1 回の追加 Graph 要求（20 台ずつ送信）を必要とするため、実行時間はデバイス数とともに増加します。既定では無効です。

| プロパティ   | 値                                                                |
| ------- | ---------------------------------------------------------------- |
| 必須      | いいえ                                                              |
| 既定値     | False                                                            |
| 種類      | ブール値                                                             |
| ポータル表示名 | ネットワーク/SIM の詳細を含める（デバイスごとに Graph 呼び出しが 1 回増えるため、多数のデバイスでは遅くなります） |

#### IncludePhoneNumber

電話番号を取得して表示するかどうかを制御します。無効にすると、電話番号列は完全に省略されます。なお、Intune はともかく個人所有デバイスの電話番号を部分的にマスクします。

| プロパティ   | 値           |
| ------- | ----------- |
| 必須      | いいえ         |
| 既定値     | True        |
| 種類      | ブール値        |
| ポータル表示名 | 出力に電話番号を含める |

#### IncludeDeviceGroup

この Entra デバイス グループのメンバーであるデバイスのみを含めます。ネストされたグループのメンバーシップは解決されます。すべてのモバイル デバイスを含めるには空欄のままにしてください。

| プロパティ   | 値                 |
| ------- | ----------------- |
| 必須      | いいえ               |
| 既定値     |                   |
| 種類      | 文字列               |
| ポータル表示名 | グループ内のデバイスに限定（任意） |

#### IncludeUserGroup

この Entra ユーザー グループのメンバーであるプライマリ ユーザーを持つデバイスのみを含めます。ネストされたグループのメンバーシップは解決されます。すべてのモバイル デバイスを含めるには空欄のままにしてください。

| プロパティ   | 値                       |
| ------- | ----------------------- |
| 必須      | いいえ                     |
| 既定値     |                         |
| 種類      | 文字列                     |
| ポータル表示名 | グループ内のプライマリ ユーザーに限定（任意） |

#### EmailFrom

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

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

#### BrandingHeaderImageUrl

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

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

#### BrandingFooterImageUrl

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

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

#### BrandingFooterLink

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

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

#### BrandingAccentColor

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

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

#### BrandingTextColor

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

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

#### ReportFileFormat

生成および配信されるレポート ファイル形式を制御します: "CSV only"、"CSV & XLSX"、または "XLSX only"（既定）。

| プロパティ   | 値          |
| ------- | ---------- |
| 必須      | いいえ        |
| 既定値     | XLSX のみ    |
| 種類      | 文字列        |
| ポータル表示名 | レポートファイル形式 |

**ポータル オプション**

| ポータル オプション | 値 |
| ---------- | - |
| CSV と XLSX |   |
| CSV のみ     |   |
| XLSX のみ    |   |

#### CreateDownloadLink

有効にすると、レポート ファイルは Azure Storage Account にアップロードされ、期限付きのダウンロード リンクが返されます。既定では無効です。

| プロパティ   | 値                                         |
| ------- | ----------------------------------------- |
| 必須      | いいえ                                       |
| 既定値     | False                                     |
| 種類      | ブール値                                      |
| ポータル表示名 | ファイルのダウンロードリンクを作成しますか（レポートをストレージにアップロード）？ |

**ポータル オプション**

| ポータル オプション                       | 値   |
| -------------------------------- | --- |
| はい - レポートをアップロードしてダウンロードリンクを返します | はい  |
| いいえ - ダウンロードリンクを作成しません           | いいえ |

#### ContainerName

アップロードに使用するストレージ コンテナー名。runbook ごとに構成されます（グローバルな RJReport 設定ではありません）。

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

#### ResourceGroupName

Storage Account を含むリソース グループ。RJReport のテナント設定から取得されます。

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

#### StorageAccountName

アップロードに使用する Storage Account 名。RJReport のテナント設定から取得されます。

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

#### LinkExpiryDays

生成されたダウンロードリンクの有効期限が切れるまでの日数。RJReport のテナント設定から取得されます。

| プロパティ     | 値                        |
| --------- | ------------------------ |
| 必須        | いいえ                      |
| 既定値       | 6                        |
| 種類        | Int32                    |
| ポータルでは非表示 | はい（runbook のカスタマイズで事前設定） |

#### EmailTo

指定した場合、レポートを含むメールが指定された宛先アドレスに送信されます。1 つのアドレスでも、カンマ区切りの複数アドレスでも指定できます（文字列）。関数はプライバシー保護のため、受信者ごとに個別のメールを送信します。

| プロパティ   | 値                                        |
| ------- | ---------------------------------------- |
| 必須      | いいえ                                      |
| 既定値     |                                          |
| 種類      | 文字列                                      |
| ポータル表示名 | 受信者のメール アドレス（複数可）（任意 - 空欄のままにするとジョブ出力のみ） |

[Runbook Reference の概要に戻る](/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/devices/list-mobile-devices.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.