Restore-EntraDeletedDirectoryObject

Restore-EntraDeletedDirectoryObject

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

Polecenie Restore-EntraDeletedDirectoryObject cmdlet służy do przywracania wcześniej usuniętych obiektów, takich jak aplikacja, grupa, jednostka usługi, jednostka administracyjna lub obiekty użytkownika.

Usunięcie grupy lub aplikacji początkowo jest nietrwałe i można je odzyskać w ciągu pierwszych 30 dni. Po upływie 30 dni usunięty obiekt zostanie trwale usunięty i nie można go odzyskać.

Notatki:

• Można przywrócić tylko ujednolicone grupy (znane również jako Grupy Microsoft 365). Nie można przywrócić grup zabezpieczeń.
• Przywracanie aplikacji nie powoduje automatycznego przywrócenia skojarzonej jednostki usługi. Aby przywrócić usuniętą jednostkę usługi, musisz jawnie użyć tego polecenia cmdlet.

W przypadku scenariuszy delegowanych użytkownik wywołujący musi mieć co najmniej jedną z następujących ról Microsoft Entra:

• Aby przywrócić usunięte aplikacje lub jednostki usługi: Administrator aplikacji, administrator aplikacji w chmurze lub administrator tożsamości hybrydowej.
• Aby przywrócić usuniętych użytkowników: Administrator użytkowników.
  • Jednak aby przywrócić użytkowników z rolami uprzywilejowanego administratora:
    • W scenariuszach delegowanych aplikacja musi mieć przypisane Directory.AccessAsUser.All uprawnienia delegowane, a użytkownik wywołujący musi mieć również przypisaną wyższą rolę administratora uprzywilejowanego.
    • W scenariuszach tylko dla aplikacji, oprócz udzielenia User.ReadWrite.All uprawnień aplikacji, aplikacja musi mieć przypisaną wyższą rolę administratora uprzywilejowanego.
• Aby przywrócić usunięte grupy: Administrator grup.
  • Jednak aby przywrócić grupy z możliwością przypisywania ról, użytkownik wywołujący musi mieć przypisaną rolę Administrator ról uprzywilejowanych.

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

W tym przykładzie pokazano, jak przywrócić usunięty obiekt w Microsoft Entra ID.

• -Id parametr określa identyfikator obiektu katalogu do przywrócenia.

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

W tym przykładzie pokazano, jak przywrócić usunięty obiekt w Microsoft Entra ID.

• -Id parametr określa identyfikator obiektu katalogu do przywrócenia.
• -AutoReconcileProxyConflict Parametr usuwa wszelkie powodujące konflikty adresy proxy podczas przywracania nietrwałego użytkownika, którego co najmniej jeden adres proxy jest obecnie używany dla aktywnego użytkownika.

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

W tym przykładzie pokazano, jak przywrócić usunięty obiekt w Microsoft Entra ID.

• -Id parametr określa identyfikator obiektu katalogu do przywrócenia.
• -NewUserPrincipalName przypisuje nową nazwę UserPrincipalName do przywróconego użytkownika.

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.