Export (0) Print
Expand All

Remove-SPOExternalUser

Applies to:  SharePoint Online 

Removes a collection of external users from the tenancy's folder.

Remove-SPOExternalUser [-UniqueIDs] <String[]> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter Required Type Description

UniqueIDs

Required

System.String[]

Specifies an ID that can be used to identify an external user based on their Windows Live ID.

Confirm

Optional

System.Management.Automation.SwitchParameter

Prompts you for confirmation before executing the command. For more information, type the following command: get-help about_commonparameters

WhatIf

Optional

System.Management.Automation.SwitchParameter

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

Detailed Description

The Remove-SPOExternalUser cmdlet permanently removes a collection of external users from the tenancy's folder.

noteNote:

Users who are removed lose access to all tenant resources.

Input Types

Return Types

------------EXAMPLE-----------

$user = Get-SPOExternalUser -Filter someone@example.com
Remove-SPOExternalUser -UniqueIDs @($user.UniqueId)

This example removes a specific external user who has the address “someone@example.com”. Organization members may still see the external user name displayed in the Shared With dialog, but the external user will not be able to sign in and will not be able to access any tenant resources.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft