Request-SPOPersonalSite
個人用サイトを作成するには、1 人以上のユーザーがキューに入っている必要があります。
構文
Default (既定)
Request-SPOPersonalSite
-UserEmails <String[]>
[-NoWait]
[<CommonParameters>]
説明
Request-SPOPersonalSite コマンドレットは、指定したユーザーがそれぞれの個人用サイトを作成できるようにエンキューするように要求します。 実際の個人用サイトはタイマー ジョブによって後から作成されます。 ユーザーに個人用サイトが既に作成されている場合、ユーザーの作成要求は自動的に無視されます。
注:
- 1 つ以上の有効なユーザー メール (ログイン) を含み、空のフィールドを含むことができないユーザー ログインの文字列配列を指定する必要があります。 コマンドは、配列内の空の文字列が検出されると停止します。 最大 200 人のユーザーを指定できます。
- このコマンドレットを実行するアクターには、少なくとも SharePoint Online 管理者ロールが割り当てられ、OneDrive for Business サイトをプロビジョニングできるようにするために SharePoint Online ライセンスが割り当てられている必要があります。 サイトをプロビジョニングするユーザーには、SharePoint ライセンスも割り当てられている必要があります。
- このコマンドレットはOneDrive Multi-Geo認識されていません。 複数地域対応テナントの個人用サイトを要求する必要がある場合は、データをホストするリージョンのユーザーに対してこのコマンドレットを実行する必要があります。 特定の PDL を持つユーザーを取得するには、次のサンプルを使用します:
Get-EntraUser | Where {$_.PreferredDataLocation -eq "EUR"}。
詳細とその他の例については、organizationのユーザーに対する OneDrive の事前プロビジョニングに関するページを参照してください。
例
例 1
$emails = "user1@contoso.com", "user2@contoso.com"
Request-SPOPersonalSite -UserEmails $emails
次の使用例は、個人用サイトの作成に 2 人のユーザーをエンキューするように要求します。
例 2
Request-SPOPersonalSite -UserEmails $emails
次の使用例は、個人用サイトの作成のために多くのユーザーにキューに入れるよう要求します。 ユーザーは変数 $emails を使用して事前に定義されています。
パラメーター
-NoWait
適用対象: SharePoint Online
ポーリングされる状態なしに操作を続けます。 多数のユーザーメールが指定されている場合、アクションのポーリングによって進行状況が遅くなる可能性があります。
パラメーターのプロパティ
| 型: | System.Management.Automation.SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UserEmails
適用対象: SharePoint Online
1 人以上のユーザー ログインを指定して、個人用サイトを作成するためにキューに入れます。 個人用サイトはタイマー ジョブによって後から作成されます。 1 から 200 の間でユーザーを指定できます。
注:
多数のユーザーに対して OneDrive を事前プロビジョニングする場合、OneDrive の場所が作成されるまでに数日かかる場合があります。
パラメーターのプロパティ
| 型: | System.String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。