Get-EntraDeletedGroup
Recupera grupos apagados manualmente no Microsoft Entra ID.
Sintaxe
GetQuery (Predefinição)
Get-EntraDeletedGroup
[-Top <Int32>]
[-All]
[-Filter <String>]
[-Property <String[]>]
[<CommonParameters>]
GetByValue
Get-EntraDeletedGroup
[-SearchString <String>]
[-All]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraDeletedGroup
-GroupId <String>
[-Property <String[]>]
[<CommonParameters>]
GetVague
Get-EntraDeletedGroup
[-All]
[-SearchString <String>]
[-Property <String[]>]
[<CommonParameters>]
Descrição
O Get-EntraDeletedGroup cmdlet recupera grupos que foram apagados suavemente do diretório. Os grupos eliminados podem ser recuperados dentro de 30 dias, após os quais são eliminados permanentemente.
A eliminação suave aplica-se atualmente apenas a Grupos Unificados (Grupos do Microsoft 365).
Exemplos
Exemplo 1: Eliminar grupos no diretório
Connect-Entra -Scopes 'Group.Read.All'
Get-EntraDeletedGroup | Select-Object Id, DisplayName, MailNickname, GroupTypes, DeletedDateTime, DeletionAgeInDays | Format-Table -AutoSize
Id DisplayName MailNickname GroupTypes DeletedDateTime DeletionAgeInDays
-- ----------- ------------ ---------- --------------- -----------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Contoso Group contosogroup {Unified} 2/12/2025 12:34:13 PM 10
Este cmdlet recupera todos os grupos eliminados recuperáveis no Microsoft Entra ID.
Exemplo 2: Eliminar grupos no diretório usando o parâmetro All
Connect-Entra -Scopes 'Group.Read.All'
Get-EntraDeletedGroup -All | Select-Object Id, DisplayName, MailNickname, GroupTypes, DeletedDateTime, DeletionAgeInDays | Format-Table -AutoSize
Id DisplayName MailNickname GroupTypes DeletedDateTime DeletionAgeInDays
-- ----------- ------------ ---------- --------------- -----------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Contoso Group contosogroup {Unified} 2/12/2025 12:34:13 PM 10
Este cmdlet recupera todos os grupos eliminados recuperáveis no diretório, usando o parâmetro Todos.
Exemplo 3: Obtém os dois primeiros grupos eliminados
Connect-Entra -Scopes 'Group.Read.All'
Get-EntraDeletedGroup -Top 2 | Select-Object Id, DisplayName, MailNickname, GroupTypes, DeletedDateTime, DeletionAgeInDays | Format-Table -AutoSize
Id DisplayName MailNickname GroupTypes DeletedDateTime DeletionAgeInDays
-- ----------- ------------ ---------- --------------- -----------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Contoso Group contosogroup {Unified} 2/12/2025 12:34:13 PM 10
Este cmdlet recupera os dois principais grupos eliminados no diretório. Você pode usar -Limit como um alias para -Top.
Exemplo 4: Eliminar grupos que contêm a string 'test2'
Connect-Entra -Scopes 'Group.Read.All'
Get-EntraDeletedGroup -SearchString 'Contoso Group' | Select-Object Id, DisplayName, MailNickname, GroupTypes, DeletedDateTime, DeletionAgeInDays | Format-Table -AutoSize
Id DisplayName MailNickname GroupTypes DeletedDateTime DeletionAgeInDays
-- ----------- ------------ ---------- --------------- -----------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Contoso Group contosogroup {Unified} 2/12/2025 12:34:13 PM 10
Este cmdlet recupera grupos eliminados no diretório, que contêm a cadeia especificada.
Exemplo 5: Eliminar grupos Filtrar por nome de exibição
Connect-Entra -Scopes 'Group.Read.All'
Get-EntraDeletedGroup -Filter "displayName eq 'Contoso Group'" | Select-Object Id, DisplayName, MailNickname, GroupTypes, DeletedDateTime, DeletionAgeInDays | Format-Table -AutoSize
Id DisplayName MailNickname GroupTypes DeletedDateTime DeletionAgeInDays
-- ----------- ------------ ---------- --------------- -----------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Contoso Group contosogroup {Unified} 2/12/2025 12:34:13 PM 10
Este cmdlet recupera grupos eliminados no diretório, tendo o nome de exibição especificado.
Exemplo 6: Eliminar o grupo pelo GroupId
Connect-Entra -Scopes 'Group.Read.All'
Get-EntraDeletedGroup -GroupId 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb' | Select-Object Id, DisplayName, MailNickname, GroupTypes, DeletedDateTime, DeletionAgeInDays | Format-Table -AutoSize
Id DisplayName MailNickname GroupTypes DeletedDateTime DeletionAgeInDays
-- ----------- ------------ ---------- --------------- -----------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Contoso Group contosogroup {Unified} 2/12/2025 12:34:13 PM 10
Este cmdlet recupera o grupo eliminado especificado pelo GroupId.
-
-GroupIdo parâmetro especifica o grupo GroupId. eliminado.
Parâmetros
-All
Liste todas as páginas.
Propriedades dos parâmetros
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predefinido: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Filter
Especifica uma instrução de filtro OData v4.0. Este parâmetro controla quais os objetos que são devolvidos.
Propriedades dos parâmetros
| Tipo: | System.String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
GetQuery
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-GroupId
O GroupID do grupo eliminado a ser recuperado.
Propriedades dos parâmetros
| Tipo: | System.String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Id |
Conjuntos de parâmetros
GetById
| Posto: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Property
Especifica propriedades a serem devolvidas
Propriedades dos parâmetros
| Tipo: | System.String[] |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Select |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-SearchString
Especifica uma cadeia de pesquisa.
Propriedades dos parâmetros
| Tipo: | System.String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
GetVague
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Top
Especifica o número máximo de registos a devolver.
Propriedades dos parâmetros
| Tipo: | System.Int32 |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Limit |
Conjuntos de parâmetros
GetQuery
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
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]]