Request-SPOPersonalSite

Requests that one or more users be enqueued for a Personal Site to be created.

Syntax

Request-SPOPersonalSite
       [-NoWait]
       -UserEmails <String[]>
       [<CommonParameters>]

Description

The Request-SPOPersonalSite cmdlet requests that the users specified be enqueued so that a Personal Site be created for each. The actual Personal site is created by a Timer Job later.

Note

You must specify a string array of user logins that contains one or more valid user email (logins) and cannot contain any empty fields. The command will stop if it encounters any empty strings in the array. A maximum of 200 users can be specified.

Note

The actor executing this cmdlet must be at least assigned the SharePoint Online administrator role and have been assigned a SharePoint Online license to be able to provision the OneDrive for Business sites. The users who the sites will be provisioned for must also have a SharePoint license assigned.

Note

This commandlet is NOT OneDrive Multi-Geo aware. If you need to request Personal Sites for Multi-Geo enabled tenants, you must run this commandlet for users in the region their data is to be hosted in. To retrieve users with a specific PDL, use the following sample: get-MSOLUser | Where {$_.PreferredDataLocation -eq "EUR"]

Examples

----------------------EXAMPLE 1-----------------------

$emails = "user1@contoso.com", "user2@contoso.com"
Request-SPOPersonalSite -UserEmails $emails

This example requests that two users to be enqueued for the creation of a Personal Site.

----------------------EXAMPLE 2-----------------------

Request-SPOPersonalSite -UserEmails $emails

This example requests that many users to be queued for the creation of a Personal Site. The users are previously defined using the variable $emails.

Parameters

-NoWait

Continues without the status being polled. Polling the action can slow it’s progress if lots of user emails are specified.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online
-UserEmails

Specifies one or more user logins to be enqueued for the creation of a Personal Site. The Personal site is created by a Timer Job later. You can specify between 1 and 200 users.

Note

If you are Pre-Provisioning OneDrive for Many Users, it might take up to 24 hours for the OneDrive locations to be created. If a user's OneDrive isn't ready after 24 hours, please contact Support.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
Applies to:SharePoint Online

Inputs

System.String[]

Outputs

System.Object