Restore-MsolUser

Restores a deleted user.

Syntax

Restore-MsolUser [-AutoReconcileProxyConflicts] [-NewUserPrincipalName <String>] -ObjectId <Guid>
 [-TenantId <Guid>] [<CommonParameters>]
Restore-MsolUser [-AutoReconcileProxyConflicts] [-NewUserPrincipalName <String>] -UserPrincipalName <String>
 [-TenantId <Guid>] [<CommonParameters>]

Description

The Restore-MsolUser cmdlet restores a user that is in the Deleted users view to its original state. Deleted users remain in the Deleted users view for 30 days.

Examples

Example 1: Restore a user

PS C:\> Restore-MsolUser -UserPrincipalName "davidchew@contoso.com"

This command restores the user "davidchew@contoso.com" from the Deleted users container to the Active users container.

Example 2: Restore a user and remove conflicts

PS C:\> Restore-MsolUser -UserPrincipalName "davidchew@contoso.com" -AutoReconcileProxyConflicts

This command restores the user davidchew@contoso.com from the Deleted users container to the Active users container, removing any conflicting proxy addresses. Use this option if restore fails due to proxy conflicts.

Example 3: Restore a user

PS C:\> Restore-MsolUser -UserPrincipalName "davidchew@contoso.com" -NewUserPrincipalName "davidchew02@contoso.com"

This command restores the user davidchew@contoso.com from the Deleted users container to the Active users container as davidchew02@contoso.com. Use this option if restore fails due to a user principal name conflict.

Parameters

-AutoReconcileProxyConflicts

Indicates that any proxy addresses that cause conflicts are removed for the user. Specify this parameter if one or more of the proxy addresses of the user is also used for another active user.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-NewUserPrincipalName

Specifies a new user principal name to use when restoring the user. Specify this parameter if the original user principal name of the user is in use by another active user.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ObjectId

Specifies the unique Object ID of the user to restore.

Type:Guid
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-UserPrincipalName

Specifies the user ID of the user to restore.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-TenantId

Specifies the unique ID of the tenant on which to perform the operation. The default value is the tenant of the current user. This parameter applies only to partner users.

Type:Guid
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False