Restore-EntraDeletedDirectoryObject
Een eerder verwijderd object herstellen.
Syntax
Default (Standaard)
Restore-EntraDeletedDirectoryObject
-Id <String>
[-AutoReconcileProxyConflict]
[-NewUserPrincipalName <String>]
[<CommonParameters>]
Description
De Restore-EntraDeletedDirectoryObject cmdlet wordt gebruikt om eerder verwijderde objecten te herstellen, zoals toepassing, groep, service-principal, beheereenheid of gebruikersobjecten.
Wanneer een groep of toepassing wordt verwijderd, wordt deze in eerste instantie voorlopig verwijderd en kan deze binnen de eerste 30 dagen worden hersteld. Na 30 dagen wordt het verwijderde object definitief verwijderd en kan het niet worden hersteld.
Notes:
- Alleen geïntegreerde groepen (ook wel Microsoft 365 Groepen genoemd) kunnen worden hersteld; Beveiligingsgroepen kunnen niet worden hersteld.
- Als u een toepassing herstelt, wordt de bijbehorende service-principal niet automatisch hersteld. U moet deze cmdlet expliciet gebruiken om de verwijderde service-principal te herstellen.
Voor gedelegeerde scenario's moet de aanroepende gebruiker ten minste een van de volgende Microsoft Entra rollen hebben:
- Verwijderde toepassingen of service-principals herstellen: Toepassingsbeheerder, cloudtoepassingsbeheerder of hybride identiteitsbeheerder.
-
Verwijderde gebruikers herstellen: Gebruikersbeheerder.
- Als u gebruikers met bevoorrechte beheerdersrollen wilt herstellen:
- In gedelegeerde scenario's moet aan de app de
Directory.AccessAsUser.Allgedelegeerde machtiging worden toegewezen en moet de aanroepende gebruiker ook een beheerdersrol met hogere bevoegdheden krijgen. - In alleen-app-scenario's moet niet alleen de
User.ReadWrite.Alltoepassingsmachtiging worden verleend, maar moet de app ook een beheerdersrol met hogere bevoegdheden krijgen.
- In gedelegeerde scenario's moet aan de app de
- Als u gebruikers met bevoorrechte beheerdersrollen wilt herstellen:
-
Verwijderde groepen herstellen: Groepsbeheerder.
- Als u echter roltoewijzingsgroepen wilt herstellen, moet aan de aanroepende gebruiker de rol Beheerder met bevoorrechte rol worden toegewezen.
Voorbeelden
Voorbeeld 1: Een verwijderd object herstellen met id
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
In dit voorbeeld ziet u hoe u een verwijderd object herstelt in Microsoft Entra ID.
-
-Idparameter geeft de id van het mapobject te herstellen.
Voorbeeld 2: een Soft-Deleted gebruiker herstellen en conflicterende proxyadressen verwijderen
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
In dit voorbeeld ziet u hoe u een verwijderd object herstelt in Microsoft Entra ID.
-
-Idparameter geeft de id van het mapobject te herstellen. -
-AutoReconcileProxyConflictparameter verwijdert conflicterende proxyadressen tijdens het herstellen van een voorlopig verwijderde gebruiker waarvan een of meer proxyadressen momenteel worden gebruikt voor een actieve gebruiker.
Voorbeeld 3: Een verwijderde gebruiker herstellen en een nieuwe UserPrincipalName toewijzen
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
In dit voorbeeld ziet u hoe u een verwijderd object herstelt in Microsoft Entra ID.
-
-Idparameter geeft de id van het mapobject te herstellen. -
-NewUserPrincipalNamewijst een nieuwe UserPrincipalName toe aan de herstelde gebruiker.
Parameters
-AutoReconcileProxyConflict
Hiermee geeft u op of Microsoft Entra ID conflicterende proxyadressen moet verwijderen bij het herstellen van een voorlopig verwijderde gebruiker, als een van de proxyadressen van de gebruiker momenteel wordt gebruikt door een actieve gebruiker. Deze parameter is alleen van toepassing wanneer u een voorlopig verwijderde gebruiker herstelt. De standaardwaarde is false.
Parametereigenschappen
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Id
De id van het mapobject dat moet worden hersteld.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-NewUserPrincipalName
De UPN (User Principal Name) die is toegewezen aan de herstelde gebruiker.
De UPN is een aanmeldingsnaam in internetstijl voor de gebruiker op basis van de internetstandaard RFC 822.
Deze UPN moet standaard worden toegewezen aan de e-mailnaam van de gebruiker.
De algemene indeling is 'alias@domain'.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.