> 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/zhan-kai/onboarding-realmjoin-portal/advanced-setup.md).

# 高度なセットアップ

高度なセットアップでは、アクセス許可をより細かくカスタマイズして割り当てることができます。この方法はより柔軟ですが、より複雑で、RealmJoin PowerShell モジュールの実行が必要です。

RealmJoin PowerShell モジュールは、お使いの RealmJoin Tenant のセットアップを自動化します。以下を行います:

* RealmJoin アプリケーションに必要な Microsoft Entra ID のサービス プリンシパルを作成します
* 選択した機能に基づいて適切な Microsoft Graph のアクセス許可を割り当てます
* RealmJoin の機能（Portal、Intune LAPS、Autopilot、デバイス アクション、修復スクリプト、セキュリティ機能）を構成します
* 以前の構成からレガシー アプリケーションをクリーンアップします

このモジュールは次に公開されています: [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin).

## 前提条件

{% hint style="info" %}
必要な Azure PowerShell モジュール（`Az.Accounts`, `Az.Resources`, `Az.Automation`）は、コマンドを初めて実行したときに、モジュールで固定されているバージョンが現在のユーザー向けに自動的にインストールされます。
{% endhint %}

* **PowerShell 5.1** 以降（Windows PowerShell または PowerShell 7）
* 次のことができるアカウント: **サービス プリンシパルを作成し、アプリケーションのアクセス許可を付与する** Microsoft Entra ID で — たとえば *Global Administrator* または *Privileged Role Administrator*
* サインインは `Connect-AzAccount` を通じて行われます。これは **Azure PowerShell** ファーストパーティ アプリケーションです。ユーザーの同意を制限している Tenant では、まずそのアプリケーションに対して管理者の同意を付与するために管理者が必要になる場合があります。
* へのアクセス [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin) モジュールをインストールするには

Azure サブスクリプションが必要なのは、Azure リソース（`Set-RJLogAnalyticsWorkspace`, `Set-RJAutomationAccount`). `New-RJTenant` と `Update-RJTenant` サブスクリプションのない Tenant でも動作します。次でサインインしてください: `Connect-AzAccount -Tenant <tenant-id>` まず。

## 推奨セットアップ

RealmJoin Portal に表示されるセットアップ コマンドは、 `Complete-RJTenantOnboarding` （の別名 `Update-RJTenant`）を機能選択なしで実行します。必須機能およびすべての既定機能のアクセス許可を割り当てます:

* コア ポータル機能（`RealmJoinPortal`、必須）
* Intune LAPS（`IntuneLAPS`)
* サインイン データ（`ShowSignin`)
* Autopilot（`Autopilot`)
* Intune デバイス アクション（`DeviceIntuneActions`)
* 修復スクリプト（`DeviceHealthScript`)
* BitLocker 回復キー（`BitLockerRecoveryKeys`)
* Windows デバイス更新の登録（`WindowsDeviceUpdateEnrollment`)

たとえば、Tenant ですでに構成されている機能は `SecurityFeatures` または `クライアント`は保持されます。すべての機能または個別の機能を追加するには、 [その他のコマンド](#other-commands).

{% stepper %}
{% step %}

#### Windows/Mac で PowerShell を開く

RealmJoin PowerShell モジュールは、次の環境でインストールおよび実行することを推奨します: **新しく開いた** Azure Cloud Shell ではなく、ご自身のデバイス上の PowerShell セッション。モジュールは、各 `Az.*` モジュール（`Az.Accounts` 5.5.x、 `Az.Resources` 10.2.x、 `Az.Automation` 1.12.x）について固定されたマイナー バージョン系を必要とします。別のバージョンがすでにセッションに読み込まれている場合（通常、Cloud Shell ではその状態です）、新しいセッションを開かない限り解決できないバージョン競合で停止します。

昇格した（"Run as administrator"）セッションは必要ありません。モジュールは `-Scope CurrentUser`.
{% endstep %}

{% step %}

#### RealmJoin オンボーディング スクリプトをコピーして実行する

スクリプトは Azure へのサインインを求めます。サービス プリンシパルを作成し、アプリケーションのアクセス許可を付与できるアカウントを使用してください。たとえば、Global Administrator です。

コマンド内のトークンは、実行を RealmJoin Portal のお使いの Tenant に関連付けます。有効期間は 1 時間です。期限切れの場合は、ポータルの Advanced Setup ページをもう一度開いて、新しいトークンを含むコマンドを取得してください。

```powershell
Install-Module -Force -Name RealmJoin
Complete-RJTenantOnboarding -Token 1234ABCD 6>&1
```

{% hint style="info" %}
**について `6>&1`:** これらのコマンドは進行状況の更新を PowerShell の Information ストリームに書き込みます。 `6>&1` リダイレクトにより、その出力がコンソールに表示されます。これがないと、実行中の詳細な進行メッセージは表示されません。
{% endhint %}

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FdxYM2mTZ5LNcJhgudknf%2FSnipaste_2026-01-27_12-00-54.png?alt=media&amp;token=1fa4cd4e-485a-43e4-8a90-f6e6f6f57cb5" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### RealmJoin を使い始める

アクセス許可が割り当てられると、コマンドはトークンを RealmJoin API に送信します。ポータルの Advanced Setup ページは、トークンが使用されたかどうかを定期的に確認し、使用済みになるとポータルへリダイレクトします。コマンドの実行中はページを開いたままにしてください。

以前から Tenant に RealmJoin Portal の service principal が存在していなかった場合、コマンドはブラウザーで RealmJoin Portal も開きます。

{% hint style="info" %}
**その後のサインアウト:** Azure へのサインインは、コマンド完了後もアクティブなままです。終わったら `Disconnect-AzAccount`  を実行して、既存のセッションからサインアウトしてください。
{% endhint %}
{% endstep %}
{% endstepper %}

## その他のコマンド

### 対話型セットアップ

Tenant セットアップ、構成変更、Log Analytics Workspace、および Automation アカウントを対象にした、ガイド付きのメニュー形式の操作を行うには:

```powershell
Show-RJInteractiveSetup
```

何も構成する前に、利用可能な機能を確認するには:

```powershell
Show-RJFeatureInfo
```

### カスタム構成

`New-RJTenant` 選択した機能だけで Tenant を構成します。まだ構成されていない Tenant で使用します。

{% hint style="warning" %}
すでに構成済みの Tenant では、 `New-RJTenant` 選択に含まれない構成済み機能のアクセス許可をすべて削除し、アクセス許可が残らない service principals を削除します。たとえば、 `New-RJTenant` パラメーターなしでは削除します `SecurityFeatures` と `クライアント`。既存の構成を変更するには、 [`Update-RJTenant`](#updating-existing-configuration).
{% endhint %}

#### 既定の機能

必須のコア ポータル機能に加えて、既定のオプション機能（以下を除くすべて）を有効にします: `クライアント`, `SecurityFeatures` と `AndroidApps`):

```powershell
New-RJTenant 6>&1
```

#### 最小機能（必須機能のみ）

```powershell
New-RJTenant -Features @('RealmJoinPortal') 6>&1
```

#### 全機能セット

```powershell
New-RJTenant -All 6>&1
```

#### 読み取り専用のアクセス許可

利用可能な場合は読み取り専用のアクセス許可を割り当てます（たとえば、 `Group.ReadWrite.All` は次のようになります `Group.Read.All`):

```powershell
New-RJTenant -ReadOnly 6>&1
```

3 つの機能には読み取り専用のバリアントがなく、次の状態のままアクセス許可が維持されます: `-ReadOnly`:

| 機能                              | 権限                                                        |
| ------------------------------- | --------------------------------------------------------- |
| `DeviceIntuneActions`           | `DeviceManagementManagedDevices.PrivilegedOperations.All` |
| `WindowsDeviceUpdateEnrollment` | `WindowsUpdates.ReadWrite.All`                            |
| `AndroidApps`                   | `DeviceManagementConfiguration.ReadWrite.All`             |

書き込みアクセス許可のない構成にするには、次の機能を除外してください:

```powershell
New-RJTenant -Features @('IntuneLAPS', 'ShowSignin', 'Autopilot', 'DeviceHealthScript', 'BitLockerRecoveryKeys') -ReadOnly 6>&1
```

#### カスタム機能の選択

```powershell
New-RJTenant -Features @('RealmJoinPortal', 'IntuneLAPS', 'Autopilot') 6>&1
```

### 既存の構成の更新

`Update-RJTenant` すでに構成済みの Tenant を調整します。別名 `Complete-RJTenantOnboarding` は次と同様に使用できます: `Update-RJTenant`.

* 次を指定しない場合 `-Features`, `-All`, `-AddFeatures` または `-RemoveFeatures`、Tenant ですでに構成済みの機能は保持され、既定の機能が追加されます。削除されるものはありません。
* `-Features` 構成を置き換えます。リストに含まれない構成済み機能は、その service principal を含めて削除されます。空のリストは拒否されます。
* `-AddFeatures` と `-RemoveFeatures` 指定された機能のみを変更します。
* 実行のたびに、Tenant からレガシーな RealmJoin アプリケーションも削除されます。詳しくは [Quick Setup からの切り替え](#switching-from-quick-setup).

#### 新しい機能の追加

```powershell
Update-RJTenant -AddFeatures @('SecurityFeatures') 6>&1
```

#### 機能の削除

```powershell
Update-RJTenant -RemoveFeatures @('ShowSignin') 6>&1
```

#### 読み取り専用のアクセス許可に切り替える

構成済み機能と既定の機能を、それぞれの読み取り専用アクセス許可に切り替えます。以下に一覧表示されている機能は [読み取り専用のアクセス許可](#read-only-permissions) 書き込みアクセス許可を保持します。

```powershell
Update-RJTenant -ReadOnly 6>&1
```

と組み合わせると `-AddFeatures`, `-ReadOnly` 追加された機能のみに適用され、すでに構成済みの機能のアクセス許可は変更されません。

#### 変更のプレビュー

```powershell
Update-RJTenant -AddFeatures @('SecurityFeatures') -WhatIf 6>&1
```

### Azure リソース

このモジュールは、RealmJoin が使用する付随的な Azure リソースもデプロイします。これらは Graph のアクセス許可機能ではなく、次では選択されません: `-Features`:

* `Set-RJLogAnalyticsWorkspace` — カスタム テーブルとデータ収集ルールを備えた Log Analytics Workspace をデプロイします。詳しくは [Azure Log Analytics Workspace の接続](https://docs.realmjoin.com/ja/torogu/log-analytics.md)
* `Set-RJAutomationAccount` — マネージド ID と必要なアクセス許可を備えた RealmJoin Automation アカウントをデプロイします。詳しくは [Azure Automation の接続](https://docs.realmjoin.com/ja/zi-dong-hua/connecting-azure-automation.md)

どちらのコマンドも、RealmJoin Portal の該当する設定ページで、対応するパラメーターとオンボーディング トークンを使用して生成されます。

## 利用可能な機能

次の機能名を `-Features`, `-AddFeatures`、および `-RemoveFeatures` パラメーターと組み合わせて使用してください。必須機能は常に有効です。既定の構成（`New-RJTenant` パラメーターなし）では以下にマークされた機能が有効になります。 **SecurityFeatures**, **クライアント** と **AndroidApps** は明示的に選択する必要があります。

| 機能                              | 説明                                                                                                                                                                            | 既定値 |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-: |
| `RealmJoinPortal`               | ユーザーのセルフサービスと管理者のやり取りのためのコア ポータル機能（必須）                                                                                                                                        |  ☑️ |
| `IntuneLAPS`                    | Intune LAPS を使用してローカル管理者パスワードを取得および管理する                                                                                                                                       |  ☑️ |
| `ShowSignin`                    | ユーザーのサインイン履歴と監査ログを表示する                                                                                                                                                        |  ☑️ |
| `Autopilot`                     | Windows Autopilot の展開プロファイルと状態を表示する                                                                                                                                           |  ☑️ |
| `DeviceIntuneActions`           | 特権デバイス操作（同期、再起動、ワイプなど）を実行する                                                                                                                                                   |  ☑️ |
| `DeviceHealthScript`            | PowerShell 修復スクリプトをデバイスに対して管理および展開する                                                                                                                                          |  ☑️ |
| `BitLockerRecoveryKeys`         | 管理対象デバイスの BitLocker 回復キーを表示する                                                                                                                                                 |  ☑️ |
| `WindowsDeviceUpdateEnrollment` | Windows Device Updates の登録を管理する                                                                                                                                               |  ☑️ |
| `SecurityFeatures`              | [Defender for Endpoint の統合](https://docs.realmjoin.com/ja/ugd-management/defender-integration.md) デバイス ページ上で（MDE ライセンスが必要）                                                    |     |
| `クライアント`                        | RealmJoin Agent — デバイス管理用のクライアント アプリケーション                                                                                                                                     |     |
| `AndroidApps`                   | [Android アプリの展開](https://docs.realmjoin.com/ja/apurikshon/packages/android-apps-managed-google-play.md) Managed Google Play 経由（`DeviceManagementConfiguration.ReadWrite.All`) |     |

## Quick Setup からの切り替え

Quick Setup でオンボードされた Tenant は、 **RealmJoin Portal - コア機能** すべてのポータルのアクセス許可を保持するアプリ登録です。Advanced Setup に移行するには、 **Organization → Features** を RealmJoin Portal で開き、 **高度なモードに移動** の **Advanced setup** カードを選択します。するとポータルは、次に記載されているように、トークン付きのオンボーディング コマンドを表示します: [推奨セットアップ](#recommended-setup).

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-90feb65a312dda59e5e23473be499c34566c8b1c%2Forganization-features-advanced-setup-switch.png?alt=media" alt="Advanced setup card on the Organization Features page"><figcaption><p>Quick Setup の Tenant 用 Advanced setup カード</p></figcaption></figure>

コマンドの実行時に、モジュールは選択された機能の service principals を作成し、 **RealmJoin Portal - コア機能** アプリ登録をレガシー アプリケーションとして削除します。新しいアクセス許可が適用されると、ポータルは Tenant を Advanced Setup に切り替えます。

{% hint style="warning" %}
切り替えは一方向です。Core Features のアプリ登録が削除されると、アクセス許可の管理は RealmJoin PowerShell モジュールのみで行われます。
{% endhint %}

## トラブルシューティング

{% hint style="warning" %}
**「権限が不十分です」** — service principals の作成とアプリケーションのアクセス許可の付与には、適切な権限を持つアカウントが必要です。たとえば *Global Administrator* または *Privileged Role Administrator*。こちらも参照してください [前提条件](#prerequisites).
{% endhint %}

{% hint style="warning" %}
**「Need admin approval」またはサインイン中の同意エラー** — サインインには **Azure PowerShell** ファーストパーティ アプリケーションを使用します。テナントがユーザー同意を制限している場合、管理者がそのアプリケーションへの管理者同意を一度付与する必要があります。
{% endhint %}

{% hint style="warning" %}
**「RealmJoin module is outdated - execution cannot proceed」** — 各コマンドは、現在実行しているのが最新の公開バージョンであることをセッションごとに 1 回確認します。現在のバージョンをインストールし、その後セッションを閉じて新しいセッションを開いてください:

```powershell
Install-Module -Name RealmJoin -Force -Scope CurrentUser
```

{% endhint %}

{% hint style="warning" %}
**「認証に失敗しました (401)。トークンが無効または期限切れの可能性があります。」** — アクセス許可は割り当てられましたが、オンボーディング トークンの期限切れ（1 時間後）または無効により、Tenant を RealmJoin に登録できませんでした。RealmJoin Portal で Advanced Setup ページをもう一度開き、新しいトークンでコマンドを実行してください。再実行しても、すでに適用済みのアクセス許可は変更されません。
{% endhint %}

{% hint style="warning" %}
**module のバージョン競合が報告される** — `Az.*` モジュールが固定しているものとは別のバージョンのモジュールがすでに読み込まれています。これは実行中のセッションでは修正できません。PowerShell を閉じ、新しいセッションを開いて、コマンドを再実行してください。
{% endhint %}

モジュールが見つからない場合は、PowerShell Gallery が利用可能であることを確認し、再インストールしてください:

```powershell
Get-PSRepository
Install-Module -Name RealmJoin -Force -Scope CurrentUser
```

### ヘルプの取得

```powershell
Get-Help New-RJTenant -Full
Get-Help Update-RJTenant -Examples
Get-Help Show-RJInteractiveSetup -Detailed
```


---

# 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/zhan-kai/onboarding-realmjoin-portal/advanced-setup.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.
