Restore-EntraDeletedDirectoryObject

Restore-EntraDeletedDirectoryObject

    -Id <String>
    [-AutoReconcileProxyConflict]
    [-NewUserPrincipalName <String>]
    [<CommonParameters>]

L’applet Restore-EntraDeletedDirectoryObject de commande permet de restaurer des objets précédemment supprimés, tels que l’application, le groupe, le principal de service, l’unité administrative ou les objets utilisateur.

Lorsqu’un groupe ou une application est supprimé, il est initialement supprimé de manière réversible et peut être récupéré dans les 30 premiers jours. Après 30 jours, l’objet supprimé est définitivement supprimé et ne peut pas être récupéré.

Remarques :

• Seuls les groupes unifiés (également appelés Groupes Microsoft 365) peuvent être restaurés ; Les groupes de sécurité ne peuvent pas être restaurés.
• La restauration d’une application ne restaure pas automatiquement son principal de service associé. Vous devez utiliser explicitement cette applet de commande pour restaurer le principal de service supprimé.

Pour les scénarios délégués, l’utilisateur appelant doit avoir au moins l’un des rôles Microsoft Entra suivants :

• Pour restaurer des applications ou des principaux de service supprimés : Administrateur d’application, administrateur d’application cloud ou administrateur d’identité hybride.
• Pour restaurer les utilisateurs supprimés : Administrateur utilisateur.
  • Toutefois, pour restaurer les utilisateurs avec des rôles d’administrateur privilégiés :
    • Dans les scénarios délégués, l’application doit être affectée à l’autorisation Directory.AccessAsUser.All déléguée, et l’utilisateur appelant doit également avoir un rôle d’administrateur privilégié supérieur.
    • Dans les scénarios d’application uniquement, outre l’octroi de l’autorisation User.ReadWrite.All d’application, l’application doit avoir un rôle d’administrateur privilégié supérieur.
• Pour restaurer des groupes supprimés : Administrateur de groupes.
  • Toutefois, pour restaurer des groupes assignables à un rôle, l’utilisateur appelant doit avoir le rôle Administrateur de rôle privilégié.

Connect-Entra -Scopes 'User.ReadWrite.All', 'AdministrativeUnit.ReadWrite.All', 'Application.ReadWrite.All', 'Group.ReadWrite.All'
$deletedUser = Get-EntraDeletedUser -Filter "DisplayName eq 'Adele Vance'"
Restore-EntraDeletedDirectoryObject -Id $deletedUser.Id

Id                                   DeletedDateTime
--                                   ---------------
dddddddd-3333-4444-5555-eeeeeeeeeeee

Cet exemple montre comment restaurer un objet supprimé dans Microsoft Entra ID.

• -Id spécifie l’ID de l’objet de répertoire à restaurer.

Connect-Entra -Scopes 'User.ReadWrite.All'
$deletedUser = Get-EntraDeletedUser -Filter "DisplayName eq 'Adele Vance'"
Restore-EntraDeletedDirectoryObject -Id $deletedUser.Id -AutoReconcileProxyConflict

Id                                   DeletedDateTime
--                                   ---------------
dddddddd-3333-4444-5555-eeeeeeeeeeee

Cet exemple montre comment restaurer un objet supprimé dans Microsoft Entra ID.

• -Id spécifie l’ID de l’objet de répertoire à restaurer.
• -AutoReconcileProxyConflict le paramètre supprime les adresses proxy en conflit lors de la restauration d’un utilisateur supprimé de manière réversible dont une ou plusieurs adresses proxy sont actuellement utilisées pour un utilisateur actif.

Connect-Entra -Scopes 'User.ReadWrite.All'
$deletedUser = Get-EntraBetaDeletedUser -Filter "DisplayName eq 'Sawyer M'"
Restore-EntraBetaDeletedDirectoryObject -Id $deletedUser.Id -NewUserPrincipalName 'SawyerM@contoso.com'

Id                                   DeletedDateTime
--                                   ---------------
dddddddd-3333-4444-5555-eeeeeeeeeeee

Cet exemple montre comment restaurer un objet supprimé dans Microsoft Entra ID.

• -Id spécifie l’ID de l’objet de répertoire à restaurer.
• -NewUserPrincipalName affecte un nouvel userPrincipalName à l’utilisateur restauré.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.