Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

Remove-MsolUser

Published: March 22, 2013

Updated: January 21, 2014

Applies To: Office 365, Windows Azure, Windows Intune

noteNote
  • This topic provides online help content for cloud services, such as Windows Intune and Office 365, which rely on Windows Azure Active Directory for identity and directory services.

  • The Windows Azure Active Directory Module for Windows PowerShell cmdlets were previously known as the Microsoft Online Services Module for Windows PowerShell cmdlets.

The Remove-MsolUser cmdlet is used to remove a user from the Windows Azure Active Directory (Windows Azure AD). This cmdlet will delete the user, their licenses, and any other associated data.

Remove-MsolUser -UserPrincipalName <string> [-RemoveFromRecycleBin <switch>] [-Force] [-TenantId <Guid>] [<CommonParameters>]

    -Force [<SwitchParameter>]
        Used to bypass onscreen confirmation.
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -ObjectId <Guid>
        The object ID of the user to remove.
        
        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       true (ByPropertyName)
        Accept wildcard characters?  false
        
    -RemoveFromRecycleBin <switch>
        Permanently removes the user from Windows Azure AD recycle bin. 
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       true (ByPropertyName)
        Accept wildcard characters?  false
        
    -TenantId <Guid>
        The unique ID of the tenant to perform the operation on. If this is 
        not provided then the value will default to the tenant of the current 
        user. This parameter is only applicable to partner users.
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       true (ByPropertyName)
        Accept wildcard characters?  false
        
    -UserPrincipalName <string>
        The user ID of the user to remove.
        
        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       true (ByPropertyName)
        Accept wildcard characters?  false
        
    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

The following examples show the use of this cmdlet.

This command removes user@contoso.com from the Windows Azure AD. If the user has any licenses these will be removed as well. A confirmation prompt is shown, so that you can confirm the operation.

Remove-MsolUser -UserPrincipalName user@contoso.com

This command removes CCole@contoso.com from the Windows Azure AD. If the user has any licenses these will be removed as well.

Remove-MsolUser -UserPrincipalName CCole@contoso.com -force

This command removes CCole@contoso.com from the Windows Azure AD recycle bin. A confirmation prompt will be output to the screen to confirm the operation. This command will permanently remove the user with no opportunity to recover the user.

Remove-MsolUser -UserPrincipalName CCole@contoso.com -RemoveFromRecycleBin

See Also

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.