For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 サービス プランがあることを確認します( ライセンス確認).

  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

必須モジュール

RealmJoin.RunbookHelper (>= 0.8.10) Microsoft.Graph.Authentication (>= 2.41.2) PnP.PowerShell (>= 3.4.1)

スケジュール可能

いいえ

アクセス許可

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

  • 型: 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 ライセンスを確認しますか?

最終更新

役に立ちましたか?