> 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/user/collab/pre-provision-onedrive.md).

# OneDrive を事前プロビジョニング

このユーザーの OneDrive を最初のサインイン前に要求します

### 説明

このユーザーの SharePoint Online 上の OneDrive を要求し、初回サインイン前に利用可能にします。アカウントは有効である必要があり、ライセンス確認が有効な場合は SharePoint サービス プランが割り当てられている必要があります。OneDrive がすでに存在する場合は何も要求しません。SharePoint はバックグラウンドで OneDrive を作成し、通常は数分以内、場合によっては 24 時間後になってから作成されますが、実行は完了を待ちません。

### 仕組み

各実行で、runbook は次の処理を行います:

1. Automation アカウントのマネージド ID を使用して Microsoft Graph と SharePoint Online (PnP PowerShell) に接続します。SharePoint 管理センターの URL は Tenant のルート サイトから自動的に導出されます。
2. 選択されたユーザー（`ユーザー名`）を Microsoft Entra ID から読み取り、アカウントが存在しないか、または **無効**.
3. オプションで、ユーザーに有効な **SharePoint** サービス プランがあることを確認します（ [ライセンス確認](#license-check)).
4. ユーザーの OneDrive がすでにアクティブなサイト コレクションとして存在するかどうかを確認します。存在する場合、要求を送信せずに実行は終了します。
5. Tenant のごみ箱でユーザーの削除済み OneDrive を探し、見つかった場合は警告を表示します。
6. OneDrive の作成を次でキューに入れます： `New-PnPPersonalSite` そして結果を出力します。

runbook は RealmJoin ポータルのユーザー オブジェクトから開始されるため、ユーザーは常に事前選択され、自由入力はありません。

#### アカウントは有効である必要があります

SharePoint は、サインインを許可されたユーザーに対してのみ OneDrive を作成します。ブロックされたユーザーからの要求は受け入れられますが、通知なく無視されるため、誤解を招く「キューに登録済み」メッセージが表示されることになります。そのため runbook は、次の場合にエラーで中止します： `accountEnabled` ある `false`。まずアカウントを有効にしてから、runbook を再実行してください。

によって適用されたサインイン ブロックは **Conditional Access** runbook では検出できません。

#### ライセンス確認

次の場合は **先に SharePoint ライセンスを確認しますか？** (`CheckSharePointLicense`（既定で有効）runbook は、ユーザーに有効な SharePoint サービス プランがない場合に中止します。このチェックではユーザーの `assignedPlans`を評価するため、すべてのライセンス ソースが対象になります：

* Microsoft 365 / Office 365 スイート（例：E3、E5、F3、Business Standard）
* SharePoint Online Plan 1 / Plan 2 および OneDrive 単体プラン
* 直接割り当てとグループ ベースのライセンス割り当て

チェックが無効でも、要求はそのままキューに入ります。ただし、SharePoint ライセンスが割り当てられていない限り、SharePoint は OneDrive を作成しません。ライセンスを割り当てた後は、その割り当てが反映されるまで少し待ってから runbook を実行してください。

#### 設計上、冪等

* OneDrive がすでにアクティブなサイト コレクションとして存在する場合、runbook は次を報告します： `AlreadyProvisioned` そして要求は送信しません。
* すでに OneDrive を持つユーザーに対して要求を送っても無害です。SharePoint はそれを無視します。

#### ごみ箱内の削除済み OneDrive

Tenant のごみ箱で、ユーザーの削除済み OneDrive（サイト所有者で一致）が見つかった場合、runbook は URL と削除時刻を含む警告を表示します。新しい空の OneDrive を作成するより、既存の OneDrive を復元するほうが望ましい場合があります。警告によって run は停止しません。

#### 非同期プロビジョニング

runbook は **キューに入れるだけです** 要求を送信します。OneDrive は後で SharePoint のタイマー ジョブによって作成されます。通常は数分で完了しますが、24 時間以上かかることもあります。runbook は完了を待たないため、結果の確認には runbook **OneDrive の状態を確認** (Org \ Collab) で結果を確認してください。

runbook は次のプロパティを持つオブジェクトを返します： `ユーザー プリンシパル名`, `状態` (`AlreadyProvisioned` または `ProvisioningRequested`), `OneDriveUrl` と `RequestedAt` (UTC)。

#### 前提条件

次の権限は **Office 365 SharePoint Online** API の権限は、Microsoft Graph の自動権限設定では割り当てられません。初回実行前に、Tenant ごとに 1 回、Automation アカウントのシステム割り当てマネージド ID に付与してください。

### 場所

ユーザー → Collab → OneDrive の事前プロビジョニング

**完全な Runbook 名**

rjgit-user\_collab\_pre-provision-onedrive

### 詳細

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

### アクセス許可

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

* **型**: Microsoft Graph
  * Sites.Read.All
    * *Tenant のルート サイト（/sites/root）を読み取り、Connect-PnPOnline で使用する SharePoint 管理センターの URL を導出します。*
  * User.Read.All
    * *選択されたユーザー（accountEnabled、userPrincipalName、assignedPlans）を読み取り、プロビジョニング要求を送信する前に、アカウントが有効であること、および必要に応じて有効な SharePoint サービス プランが割り当てられていることを確認します。*
* **型**: Office 365 SharePoint Online
  * Sites.FullControl.All
    * *SharePoint 管理センターに対する Connect-PnPOnline と、OneDrive の個人サイト、Tenant のごみ箱を参照し、OneDrive の作成をキューに入れる tenant-admin コマンドレット Get-PnPTenantSite、Get-PnPTenantDeletedSite、New-PnPPersonalSite に必要です。より下位のサイト スコープでは tenant-admin エンドポイントには不十分です。*
  * User.ReadWrite.All
    * *PnP PowerShell では、アプリケーション権限（ユーザー プロファイル サービス）を使用する New-PnPPersonalSite に必要と文書化されています。また、Get-PnPUserProfileProperty による PersonalUrl の読み取りも含みます。*

#### 権限に関する注意事項

SharePoint Online: Office 365 SharePoint Online API（AppId 00000003-0000-0ff1-ce00-000000000000）に対する 'Sites.FullControl.All' と 'User.ReadWrite.All' のアプリケーション権限を、Automation アカウントのシステム割り当てマネージド ID に付与してください。この SharePoint のアプリ専用付与は、Microsoft Graph で使用される標準の Entra アプリ ロール割り当て自動化では設定できず、Tenant ごとに手動で割り当てる必要があります。

### パラメーター

#### ユーザー名

Runbook が操作対象とするユーザーのユーザー プリンシパル名です。ポータルで選択したユーザーから設定されます。

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

#### CheckSharePointLicense

有効な場合、このユーザーに、直接またはグループ経由で割り当てられたライセンスのうち有効な SharePoint サービス プランが 1 つもなければ、runbook は停止します。無効な場合でも要求は送信されますが、SharePoint はライセンスが割り当てられるまで OneDrive を作成しません。

| プロパティ    | 値                           |
| -------- | --------------------------- |
| 必須       | false                       |
| 既定値      | True                        |
| 型        | ブール値                        |
| ポータルの表示名 | 先に SharePoint ライセンスを確認しますか？ |

[Runbook リファレンスの概要に戻る](https://docs.realmjoin.com/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/user/collab/pre-provision-onedrive.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.
