Revoke-SPOUserSession

Provides IT administrators the ability to invalidate a particular users' O365 sessions across all their devices.

Syntax

Revoke-SPOUserSession
      [-User] <String>
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

You must be a Global Administrator to run the cmdlet.

Requires a valid Connect-SPOService context to identify the tenant. For information about how to connect to the tenant, see Connect-SPOService.

When the cmdlet is run the following will occur:

User will be signed out of browser, desktop and mobile applications accessing Office 365 resources across all devices.

Will not be applicable for guest users.

Possible results for this cmdlet are:

Result	Reason
Warning : We couldn't find the [email protected]. Check for typos and try again.	Invalid input for -User parameter.
We successfully signed out from all devices.	Successful instantaneous revocation.
It can take up to an hour to sign out from all devices.	Successful non-instantaneous revocation.
Sorry, something went wrong and we couldn't sign out from any device.	The cmdlet did not successfully execute.
The cmdlet will be available in the future, but it isn't ready for use in your organization yet.	The cmdlet has been disabled for the tenant.

Revoke-SPOUserSession -User [email protected]

This example signs out user1 in the Contoso tenancy from all devices.

Revoke-SPOUserSession -User [email protected] -Confirm:$false

This example signs out user1 in the Contoso tenancy from all devices without prompting for confirmation.

Prompts you for confirmation before running the cmdlet.

Specifies a user name. For example, [email protected]

Shows what would happen if the cmdlet runs. The cmdlet is not run.

None

System.Object