Command
Get-OneDriveURL
Description
The command to get a user's OneDrive URL, or provision the URL so it can be migrated to.
Note: It can take up to 24 hours for a OneDrive to be provisioned in Microsoft 365.
Index
Examples
Get URL for a single user's existing OneDrive site using browser authentication.
$tenant = Connect-Site -Url "https://mytenant-admin.sharepoint.com" -Browser
Get-OneDriveUrl -Tenant $tenant -Email myuser@mytenant.onmicrosoft.com
Send a provisioning request for a user's OneDrive site and wait for the response.
$tenant = Connect-Site -Url "https://mytenant-admin.sharepoint.com" -Browser
Get-OneDriveUrl -Tenant $tenant -Email myuser@mytenant.onmicrosoft.com -ProvisionIfRequired
Send a provisioning request for a user's OneDrive site and do not wait for the response.
$tenant = Connect-Site -Url "https://mytenant-admin.sharepoint.com" -Browser
Get-OneDriveUrl -Tenant $tenant -Email myuser@mytenant.onmicrosoft.com -ProvisionIfRequired -DoNotWaitForProvisioning
Send provisioning requests for multiple users from a CSV file.
This will be much quicker than waiting on each result. You can then rerun the same command once the OneDrive sites have been provisioned and you will have all the URLs.
$tenant = Connect-Site -Url "https://mytenant-admin.sharepoint.com" -Browser
$csvFile = "C:\CSVfile.csv"
$table = Import-Csv $csvFile -Delimiter ","
foreach ($row in $table) {
Get-OneDriveUrl -Tenant $tenant -Email $row.Email -ProvisionIfRequired -DoNotWaitForProvisioning
}
Note: You need a CSV file with a row titled Email and all your users' email addresses underneath. Modify "c:\CSVfile.csv" to match its location.
Syntax
Get-OneDriveUrl -Email <String> -Tenant <Site> [-ProvisionIfRequired <SwitchParameter>] [-DoNotWaitForProvisioning <SwitchParameter>]
Parameters
-DoNotWaitForProvisioning <SwitchParameter>
Skip waiting for the completion of the provisioning.
| Required? | False |
| Default value | None |
| Accept pipeline input? | False |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
-Email <String>
Specifies the user's email address.
| Required? | True |
| Default value | None |
| Accept pipeline input? | False |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
-ProvisionIfRequired <SwitchParameter>
Provision the user's one drive if it has not already been provisioned.
| Required? | False |
| Default value | None |
| Accept pipeline input? | False |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
-Tenant <Site>
Specifies the SharePoint admin center site.
| Required? | True |
| Default value | None |
| Accept pipeline input? | True (ByValue, ByPropertyName) |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
Note: The URL of the provisioned OneDrive site if already available or if the ProvisionIfRequired and WaitOnProvision flags are set.