Get-EntraDeletedAdministrativeUnit
Retrieves the list of previously deleted administrative units.
Syntax
Get-EntraDeletedAdministrativeUnit
[-Filter <String>]
[-All]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>] Get-EntraDeletedAdministrativeUnit
-AdministrativeUnitId <String>
[-Property <String[]>]
[<CommonParameters>] Get-EntraDeletedAdministrativeUnit
[-SearchString <String>]
[-All]
[-Property <String[]>]
[<CommonParameters>] Description
The Get-EntraDeletedAdministrativeUnit cmdlet Retrieves the list of previously deleted administrative units.
Examples
Example 1: Get list of deleted administrative units
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraDeletedAdministrativeUnit | Select-Object Id, DisplayName, MembershipType, Visibility, DeletedDateTime, DeletionAgeInDays | Format-Table -AutoSize
Id DisplayName MembershipType Visibility DeletedDateTime DeletionAgeInDays
-- ----------- -------------- ---------- --------------- -----------------
gggggggg-8888-9999-aaaa-hhhhhhhhhhhh Americas Administrative Unit Dynamic HiddenMembership 2/12/2025 12:40:52 PM 10This cmdlet retrieves the list of deleted administrative units.
Example 2: Get list of deleted administrative units using All parameter
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraDeletedAdministrativeUnit -All | Select-Object Id, DisplayName, MembershipType, Visibility, DeletedDateTime, DeletionAgeInDays | Format-Table -AutoSize
Id DisplayName MembershipType Visibility DeletedDateTime DeletionAgeInDays
-- ----------- -------------- ---------- --------------- -----------------
gggggggg-8888-9999-aaaa-hhhhhhhhhhhh Americas Administrative Unit Dynamic HiddenMembership 2/12/2025 12:40:52 PM 10This cmdlet retrieves the list of deleted administrative units using All parameter.
Example 3: Get top two deleted administrative units
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraDeletedAdministrativeUnit -Top 2 | Select-Object Id, DisplayName, MembershipType, Visibility, DeletedDateTime, DeletionAgeInDays | Format-Table -AutoSize
Id DisplayName MembershipType Visibility DeletedDateTime DeletionAgeInDays
-- ----------- -------------- ---------- --------------- -----------------
gggggggg-8888-9999-aaaa-hhhhhhhhhhhh Americas Administrative Unit Dynamic HiddenMembership 2/12/2025 12:40:52 PM 10This cmdlet retrieves top two deleted administrative units. You can use -Limit as an alias for -Top.
Example 4: Get deleted administrative units using SearchString parameter
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraDeletedAdministrativeUnit -SearchString 'Americas Administrative Unit' | Select-Object Id, DisplayName, MembershipType, Visibility, DeletedDateTime, DeletionAgeInDays | Format-Table -AutoSize
Id DisplayName MembershipType Visibility DeletedDateTime DeletionAgeInDays
-- ----------- -------------- ---------- --------------- -----------------
gggggggg-8888-9999-aaaa-hhhhhhhhhhhh Americas Administrative Unit Dynamic HiddenMembership 2/12/2025 12:40:52 PM 10This cmdlet retrieves deleted administrative units using SearchString parameter.
Example 5: Get deleted administrative units filter by display name
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraDeletedAdministrativeUnit -Filter "DisplayName eq 'Americas Administrative Unit'" | Select-Object Id, DisplayName, MembershipType, Visibility, DeletedDateTime, DeletionAgeInDays | Format-Table -AutoSize
Id DisplayName MembershipType Visibility DeletedDateTime DeletionAgeInDays
-- ----------- -------------- ---------- --------------- -----------------
gggggggg-8888-9999-aaaa-hhhhhhhhhhhh Americas Administrative Unit Dynamic HiddenMembership 2/12/2025 12:40:52 PM 10This cmdlet retrieves deleted administrative units having specified display name.
Example 6: Get deleted administrative unit by AdministrativeUnitId
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraDeletedAdministrativeUnit -AdministrativeUnitId 'gggggggg-8888-9999-aaaa-hhhhhhhhhhhh' | Select-Object Id, DisplayName, MembershipType, Visibility, DeletedDateTime, DeletionAgeInDays | Format-Table -AutoSize
Id DisplayName MembershipType Visibility DeletedDateTime DeletionAgeInDays
-- ----------- -------------- ---------- --------------- -----------------
gggggggg-8888-9999-aaaa-hhhhhhhhhhhh Americas Administrative Unit Dynamic HiddenMembership 2/12/2025 12:40:52 PM 10This cmdlet retrieves deleted administrative unit by AdministrativeUnitId.
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 administrative units 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[] |
| Aliases: | Select |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SearchString
Retrieve only those administrative units 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 administrative units.
| Type: | System.Int32 |
| Aliases: | Limit |
| 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