OneDrive を事前プロビジョニング
このユーザーの OneDrive を最初のサインイン前に要求します
説明
このユーザーの SharePoint Online 上の OneDrive を要求し、初回サインイン前に利用可能にします。アカウントは有効である必要があり、ライセンス確認が有効な場合は SharePoint サービス プランが割り当てられている必要があります。OneDrive がすでに存在する場合は何も要求しません。SharePoint はバックグラウンドで OneDrive を作成し、通常は数分以内、場合によっては 24 時間後になってから作成されますが、実行は完了を待ちません。
仕組み
各実行で、runbook は次の処理を行います:
Automation アカウントのマネージド ID を使用して Microsoft Graph と SharePoint Online (PnP PowerShell) に接続します。SharePoint 管理センターの URL は Tenant のルート サイトから自動的に導出されます。
選択されたユーザー(
ユーザー名)を Microsoft Entra ID から読み取り、アカウントが存在しないか、または 無効.オプションで、ユーザーに有効な SharePoint サービス プランがあることを確認します( ライセンス確認).
ユーザーの OneDrive がすでにアクティブなサイト コレクションとして存在するかどうかを確認します。存在する場合、要求を送信せずに実行は終了します。
Tenant のごみ箱でユーザーの削除済み OneDrive を探し、見つかった場合は警告を表示します。
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 ライセンスを確認しますか?
最終更新
役に立ちましたか?