> 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).

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

在庫情報とネットワーク詳細を含む管理対象モバイル デバイスを一覧表示

### 説明

Intune で管理されている Android、iOS、iPadOS デバイスをすべて一覧表示し、在庫情報として IMEI、シリアル番号、電話番号、キャリア、所有形態、コンプライアンス、登録状況を示します。必要に応じて、最後に報告された IP アドレスとサブネット、ICCID、eSIM 識別子、携帯通信技術、UDID、バッテリーの状態、Shared iPad の状態も追加されます。これにより、デバイスが最後にどのネットワークでアクティブだったかが分かります。リストはプラットフォーム、デバイス グループ、またはプライマリ ユーザーのグループで絞り込めます。レポートはメールで送信するか、ダウンロード リンクとして提供できます。

### 一般的な使用例

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

### 出力列

各実行では、 **概要** 表（プラットフォームごとのデバイス数、非準拠デバイスと個人所有デバイス、さらにネットワーク詳細を有効にした場合は報告された IP アドレスを持たないデバイス数）と、最大 3 つのデバイス表を RealmJoin ポータルの Output Data タブに出力します。コンソール出力には、同じ件数に加えて、コンプライアンス状態と所有形態による内訳、および適用されたフィルターが表示されます。同じデータは、メールおよび/またはダウンロード リンクとしてレポート ファイルで配信することもできます。以下のレポート配信のセクションを参照してください。

#### 在庫情報（常に表示）

| 列                           | ソースと意味                                                                          |
| --------------------------- | ------------------------------------------------------------------------------- |
| デバイス名                       | Intune に報告されたデバイス名                                                              |
| PrimaryUser                 | プライマリ ユーザーのユーザー プリンシパル名                                                         |
| OperatingSystem / OSVersion | オペレーティング システム（Android、iOS、iPadOS）とバージョン                                         |
| Manufacturer / Model        | ハードウェアのメーカーとモデル                                                                 |
| シリアル番号                      | ハードウェアのシリアル番号                                                                   |
| IMEI                        | デバイスの International Mobile Equipment Identity                                   |
| PhoneNumber                 | SIM の電話番号 - 次の場合のみ表示されます `IncludePhoneNumber` が有効になっている場合。そうでない場合、この列は完全に省略されます |
| Carrier                     | SIM の契約通信事業者                                                                    |
| Ownership                   | `会社` または `個人`                                                                   |
| Compliance                  | Intune のコンプライアンス状態                                                              |
| LastSync                    | 最後に成功した Intune チェックインのタイムスタンプ                                                   |

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

| 列                                  | ソースと意味                                                                      |
| ---------------------------------- | --------------------------------------------------------------------------- |
| Supervised                         | iOS/iPadOS の監視モード                                                           |
| Encrypted                          | デバイスの暗号化状態                                                                  |
| Jailbroken                         | デバイスが脱獄または root 化されているかどうか                                                  |
| ThreatState                        | Mobile Threat Defense パートナーによって報告された脅威状態（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 の詳細は既定で無効であり、大規模なテナントや多数のモバイル デバイスがある場合は慎重に有効化してください: Microsoft Graph はこれらの値を単一デバイスの要求でのみ返し、デバイス一覧の応答では返しません。この runbook は常にこれらの要求を Graph バッチ エンドポイント経由で最大 20 件ずつ送信しますが、実行時間はデバイス数に比例して増加します。数千台のモバイル デバイスがあると、それに応じて実行時間が長くなり、Graph のスロットリングのリスクも高まります（スロットリングされた要求は、Graph が報告した待機時間で自動的に再試行されます）。大規模な環境では、 `IncludeNetworkDetails` グループ スコープ フィルターと組み合わせてください。

### スコープの絞り込み

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

### レポート配信

レポート ファイルは、次の場合にのみ生成されます: **レポート配信** オプションにメールまたはダウンロード リンクが含まれている場合。 *Output Data のみ* を選択すると、結果は RealmJoin ポータルの Output Data タブで直接読み取られ、各表は Excel にもエクスポートできます。メール配信とダウンロード リンク生成は独立しており、組み合わせることもできます。 *レポート ファイルの形式* 既定では Excel ワークブックのみになります。

* **メール**：完全な在庫情報を CSV および/または Excel ワークブックとして添付した要約メールを送信します。CSV 添付ファイルがメール サイズの上限を超え、 *CSV と XLSX* が選択されている場合、メールは Excel ワークブックのみを送るようにフォールバックします。条件に一致するモバイル デバイスがない場合、メールにはデバイスが見つからなかった旨が記載され、添付ファイルは付きません。
* **ダウンロード リンク**：レポート ファイルを、設定済みの Azure Storage Account にアップロードします。 `RJReport.StorageAccount.*` テナント設定の（コンテナー `list-mobile-devices` が既定）に保存し、ジョブ出力に時間制限付きの SAS ダウンロード リンクを出力します。在庫がメール添付には大きすぎる場合や、資産管理に直接引き渡すべき場合に適しています。ストレージへのアップロードは Automation account のマネージド ID で認証されます。その ID には **Reader and Data Access** RBAC ロールがターゲットの Storage Account に必要です（これは Azure RBAC の割り当てであり、Graph アプリケーション権限ではありません）。

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

次の前に作成されたスケジュールは **レポート配信** オプションが存在していた場合でも、保存された受信者だけで引き続きそのメール送信が有効になります。このようなスケジュールを編集のために開くと、オプションは *Output Data のみ*と表示されます。保存する前に配信方法を再度選択してください。そうしないと、スケジュールはレポートの送信を停止します。

### メール送信に関する設定

メール レポートの送信は任意であり、次の場合にのみ行われます **レポート配信** オプションにメールが含まれる場合、受信者が必要になります。送信者アドレスは次から取得されます: `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).

### 場所

Organization → Devices → List Mobile Devices

**完全な Runbook 名**

rjgit-org\_devices\_list-mobile-devices

### 詳細

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

### 権限

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

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

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

Azure Storage Account: Automation Account のマネージド ID に対してターゲットの Storage Account 上で 'Reader and Data Access' ロールを付与します。アップロードでは listKeys を使用してアカウント キーを取得します（ダウンロードリンクのオプションでのみ必要です）

### パラメーター

#### Android

Android デバイスを含みます。

| プロパティ   | 値                   |
| ------- | ------------------- |
| 必須      | false               |
| 既定値     | True                |
| 種類      | ブール値                |
| ポータル表示名 | Android デバイスを含めますか？ |

#### iOS

iOS および iPadOS デバイスを含みます。

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

#### IncludeNetworkDetails

IP アドレス、サブネット、ICCID、eSIM 識別子、携帯通信技術、UDID、バッテリーの状態、Shared iPad の状態を追加します。デバイスごとに追加で 1 回要求が必要なため、大規模なテナントでは時間が長くなります。

| プロパティ   | 値                      |
| ------- | ---------------------- |
| 必須      | false                  |
| 既定値     | False                  |
| 種類      | ブール値                   |
| ポータル表示名 | ネットワークと SIM の詳細を含めますか？ |

#### IncludePhoneNumber

電話番号列を表示します。Intune は、個人所有デバイスでは番号の一部をいずれにしてもマスクします。

| プロパティ   | 値           |
| ------- | ----------- |
| 必須      | false       |
| 既定値     | True        |
| 種類      | ブール値        |
| ポータル表示名 | 電話番号を含めますか？ |

#### IncludeDeviceGroup

この Entra ID グループ内のデバイスのみ（ネストされたグループを含む）。すべてのモバイル デバイスを対象にするには空欄のままにしてください。

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

#### IncludeUserGroup

プライマリ ユーザーがこのグループに属するデバイスのみ（ネストされたグループを含む）。すべて対象にするには空欄のままにしてください。

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

#### 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                     |
| 既定値      | XLSX のみ                   |
| 種類       | 文字列                       |
| ポータル表示名  | レポート ファイルの形式              |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

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

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

#### CreateDownloadLink

レポートもアップロードし、数日後に期限切れになるダウンロード リンクを返します。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      | False                     |
| 種類       | ブール値                      |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### コンテナー名

レポート ファイルがアップロードされるストレージ コンテナーです。runbook ごとに設定します。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      | list-mobile-devices       |
| 種類       | 文字列                       |
| ポータルで非表示 | はい (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 のカスタマイズで事前設定) |

#### SendEmailReport

レポートを受信者のメールアドレスに送信します。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      | False                     |
| 種類       | ブール値                      |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### EmailTo

レポートをこれらの宛先に送信します。複数ある場合はカンマで区切ってください。各受信者には個別のメールが届きます。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータル表示名  | 宛先メールアドレス                 |
| ポータルで非表示 | はい (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/list-mobile-devices.md?ask=<question>&goal=<user_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.