Remove-EntraBetaDeletedDirectoryObject

Reference

Module:: Microsoft.Entra.Beta

Permanently delete a previously deleted directory object.

Syntax

Remove-EntraBetaDeletedDirectoryObject
      -Id <String>
      [<CommonParameters>]

Description

The Remove-EntraBetaDeletedDirectoryObject cmdlet is used to permanently delete a previously deleted directory object.

When a directory object is permanently deleted, it can no longer be restored.

For delegated scenarios, the calling user needs to have at least one of the following Microsoft Entra roles.

To permanently delete applications or service principals: Application Administrator, Cloud Application Administrator, or Hybrid Identity Administrator.
To permanently delete users: User Administrator.
To permanently delete groups: Groups Administrator.

Examples

Example 1: Delete a previously deleted directory object

Connect-Entra -Scopes 'Application.ReadWrite.All','Group.ReadWrite.All','Application.ReadWrite.All','User.ReadWrite.All'
$deletedApplication = Get-EntraBetaDeletedApplication -SearchString 'My PowerShell Application'
Remove-EntraBetaDeletedDirectoryObject -DirectoryObjectId $deletedApplication.Id

This example demonstrates how to permanently delete a previously deleted directory object by ID.

-Id parameter specifies the ID of the directory object that is permanently deleted.

Parameters

-Id

The ID of the directory object that is permanently deleted.

Type:	System.String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Inputs

System.String

Outputs

System.Object

Share via