Get-EntraDeletedApplication

Retrieves the list of previously deleted applications.

Syntax

Get-EntraDeletedApplication
   [-Filter <String>]
   [-All]
   [-Top <Int32>]
   [-Property <String[]>]
   [<CommonParameters>]
Get-EntraDeletedApplication
   [-SearchString <String>]
   [-All]
   [-Property <String[]>]
   [<CommonParameters>]

Description

The Get-EntraDeletedApplication cmdlet Retrieves the list of previously deleted applications.

Note: Deleted security groups are permanently removed and cannot be retrieved.

Examples

Example 1: Get list of deleted applications

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraDeletedApplication

DisplayName Id                                   AppId                                SignInAudience PublisherDomain
----------- --                                   -----                                -------------- ---------------
TestApp1    aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb bbbbbbbb-1111-2222-3333-cccccccccccc AzureADMyOrg   contoso.com
TestApp2    cccccccc-4444-5555-6666-dddddddddddd dddddddd-5555-6666-7777-eeeeeeeeeeee AzureADMyOrg   contoso.com
TestApp3    eeeeeeee-6666-7777-8888-ffffffffffff ffffffff-7777-8888-9999-gggggggggggg AzureADMyOrg   contoso.com
TestApp4    gggggggg-8888-9999-aaaa-hhhhhhhhhhhh hhhhhhhh-9999-aaaa-bbbb-iiiiiiiiiiii AzureADMyOrg   contoso.com

This cmdlet retrieves the list of deleted applications.

Example 2: Get list of deleted applications using All parameter

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraDeletedApplication -All

DisplayName Id                                   AppId                                SignInAudience PublisherDomain
----------- --                                   -----                                -------------- ---------------
TestApp1    aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb bbbbbbbb-1111-2222-3333-cccccccccccc AzureADMyOrg   contoso.com
TestApp2    cccccccc-4444-5555-6666-dddddddddddd dddddddd-5555-6666-7777-eeeeeeeeeeee AzureADMyOrg   contoso.com
TestApp3    eeeeeeee-6666-7777-8888-ffffffffffff ffffffff-7777-8888-9999-gggggggggggg AzureADMyOrg   contoso.com
TestApp4    gggggggg-8888-9999-aaaa-hhhhhhhhhhhh hhhhhhhh-9999-aaaa-bbbb-iiiiiiiiiiii AzureADMyOrg   contoso.com

This cmdlet retrieves the list of deleted applications using All parameter.

Example 3: Get top two deleted applications

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraDeletedApplication -Top 2

DisplayName Id                                   AppId                                SignInAudience PublisherDomain
----------- --                                   -----                                -------------- ---------------
TestApp1    aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb bbbbbbbb-1111-2222-3333-cccccccccccc AzureADMyOrg   contoso.com
TestApp2    cccccccc-4444-5555-6666-dddddddddddd dddddddd-5555-6666-7777-eeeeeeeeeeee AzureADMyOrg   contoso.com

This cmdlet retrieves top two deleted applications.

Example 4: Get deleted applications using SearchString parameter

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraDeletedApplication -SearchString 'TestApp1'

DisplayName Id                                   AppId                                SignInAudience PublisherDomain
----------- --                                   -----                                -------------- ---------------
TestApp1    aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb bbbbbbbb-1111-2222-3333-cccccccccccc AzureADMyOrg   contoso.com

This cmdlet retrieves deleted applications using SearchString parameter.

Example 5: Get deleted applications filter by display name

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraDeletedApplication -Filter "DisplayName eq 'TestApp1'"

DisplayName Id                                   AppId                                SignInAudience PublisherDomain
----------- --                                   -----                                -------------- ---------------
TestApp1    aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb bbbbbbbb-1111-2222-3333-cccccccccccc AzureADMyOrg   contoso.com

This cmdlet retrieves deleted applications having specified display name.

Example 6: Get deleted applications with deletion age in days

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraDeletedApplication |
    Select-Object DisplayName, Id, AppId, SignInAudience, PublisherDomain, DeletedDateTime,
        @{Name='DeletionAgeInDays'; Expression={(Get-Date) - $_.DeletedDateTime | Select-Object -ExpandProperty Days}} |
    Format-Table -AutoSize

DisplayName           Id                                   AppId                                SignInAudience PublisherDomain        DeletedDateTime      DeletionAgeInDays
-----------           --                                   -----                                -------------- ---------------        ---------------      -----------------
Entra PowerShell App aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb bbbbbbbb-1111-2222-3333-cccccccccccc AzureADMyOrg   contoso.com 9/18/2024 7:41:44 AM                 1

This cmdlet retrieves deleted applications with deletion age in days.

Parameters

-All

List all pages.

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

Retrieve only those deleted applications that satisfy the filter.

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

-Property

Specifies properties to be returned

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

-SearchString

Retrieve only those applications that satisfy the -SearchString value.

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

-Top

The maximum number of applications returned by this cmdlet. The default value is 100.

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

Inputs

System.String

System.Nullable`1[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]] System.Nullable`1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Outputs

System.Object