Get-EntraDeletedUser
Recupera utilizadores apagados de forma suave (recentemente eliminados) no Microsoft Entra ID.
Sintaxe
GetQuery (Predefinição)
Get-EntraDeletedUser
[-Top <Int32>]
[-All]
[-Filter <String>]
[-Property <String[]>]
[<CommonParameters>]
GetVague
Get-EntraDeletedUser
[-SearchString <String>]
[-All]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraDeletedUser
-UserId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
Descrição
O Get-EntraDeletedUser cmdlet recupera utilizadores apagados de forma suave (recentemente eliminados) do diretório. Os utilizadores eliminados podem ser recuperados em 30 dias, após os quais são eliminados permanentemente.
Exemplos
Exemplo 1: Eliminar utilizadores no diretório
Connect-Entra -Scopes 'User.Read.All'
Get-EntraDeletedUser | Select-Object Id, UserPrincipalName, DisplayName, AccountEnabled, DeletedDateTime, DeletionAgeInDays, UserType | Format-Table -AutoSize
Id UserPrincipalName DisplayName AccountEnabled DeletedDateTime DeletionAgeInDays UserType
-- ----------------- ----------- -------------- --------------- ----------------- --------
dddddddd-3333-4444-5555-eeeeeeeeeeee dddddddd-3333-4444-5555-eeeeeeeeeeeeAveryS@contoso.com Avery Smith False 2/12/2025 1:15:34 PM 3 Member
Este exemplo mostra como recuperar todos os utilizadores eliminados recuperáveis no Microsoft Entra ID.
Exemplo 2: Eliminar utilizadores no diretório usando o parâmetro All
Connect-Entra -Scopes 'User.Read.All'
Get-EntraDeletedUser -All | Select-Object Id, UserPrincipalName, DisplayName, AccountEnabled, DeletedDateTime, DeletionAgeInDays, UserType | Format-Table -AutoSize
Id UserPrincipalName DisplayName AccountEnabled DeletedDateTime DeletionAgeInDays UserType
-- ----------------- ----------- -------------- --------------- ----------------- --------
dddddddd-3333-4444-5555-eeeeeeeeeeee dddddddd-3333-4444-5555-eeeeeeeeeeeeAveryS@contoso.com Avery Smith False 2/12/2025 1:15:34 PM 3 Member
Este exemplo mostra como recuperar todos os utilizadores eliminados recuperáveis, usando o parâmetro Todos.
Exemplo 3: Obter os dois utilizadores mais eliminados
Connect-Entra -Scopes 'User.Read.All'
Get-EntraDeletedUser -Top 2 | Select-Object Id, UserPrincipalName, DisplayName, AccountEnabled, DeletedDateTime, DeletionAgeInDays, UserType | Format-Table -AutoSize
Id UserPrincipalName DisplayName AccountEnabled DeletedDateTime DeletionAgeInDays UserType
-- ----------------- ----------- -------------- --------------- ----------------- --------
dddddddd-3333-4444-5555-eeeeeeeeeeee dddddddd-3333-4444-5555-eeeeeeeeeeeeAveryS@contoso.com Avery Smith False 2/12/2025 1:15:34 PM 3 Member
Este exemplo mostra como recuperar os dois utilizadores eliminados mais recuperáveis no diretório. Você pode usar -Limit como um alias para -Top.
Exemplo 4: Elimine utilizadores que contenham a string 'Avery Smith'
Connect-Entra -Scopes 'User.Read.All'
Get-EntraDeletedUser -SearchString 'Avery Smith' | Select-Object Id, UserPrincipalName, DisplayName, AccountEnabled, DeletedDateTime, DeletionAgeInDays, UserType | Format-Table -AutoSize
Id UserPrincipalName DisplayName AccountEnabled DeletedDateTime DeletionAgeInDays UserType
-- ----------------- ----------- -------------- --------------- ----------------- --------
dddddddd-3333-4444-5555-eeeeeeeeeeee dddddddd-3333-4444-5555-eeeeeeeeeeeeAveryS@contoso.com Avery Smith False 2/12/2025 1:15:34 PM 3 Member
Este exemplo mostra como recuperar utilizadores eliminados no diretório que contém a cadeia especificada.
Exemplo 5: Eliminar utilizadores filtrar por nome de exibição
Connect-Entra -Scopes 'User.Read.All'
Get-EntraDeletedUser -Filter "displayName eq 'Avery Smith'" | Select-Object Id, UserPrincipalName, DisplayName, AccountEnabled, DeletedDateTime, DeletionAgeInDays, UserType | Format-Table -AutoSize
Id UserPrincipalName DisplayName AccountEnabled DeletedDateTime DeletionAgeInDays UserType
-- ----------------- ----------- -------------- --------------- ----------------- --------
dddddddd-3333-4444-5555-eeeeeeeeeeee dddddddd-3333-4444-5555-eeeeeeeeeeeeAveryS@contoso.com Avery Smith False 2/12/2025 1:15:34 PM 3 Member
Este exemplo mostra como recuperar utilizadores eliminados no diretório, tendo o nome de exibição especificado.
Exemplo 6: Eliminar utilizador pelo UserId
Connect-Entra -Scopes 'User.Read.All'
Get-EntraDeletedUser -UserId 'dddddddd-3333-4444-5555-eeeeeeeeeeee' | Select-Object Id, UserPrincipalName, DisplayName, AccountEnabled, DeletedDateTime, DeletionAgeInDays, UserType | Format-Table -AutoSize
Id UserPrincipalName DisplayName AccountEnabled DeletedDateTime DeletionAgeInDays UserType
-- ----------------- ----------- -------------- --------------- ----------------- --------
dddddddd-3333-4444-5555-eeeeeeeeeeee dddddddd-3333-4444-5555-eeeeeeeeeeeeAveryS@contoso.com Avery Smith False 2/12/2025 1:15:34 PM 3 Member
Este exemplo mostra como recuperar o utilizador eliminado especificado pelo UserId.
-
-UserIdparâmetro especifica o utilizador UserID 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 |
-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 |
-UserId
O ObjectId ou Nome Principal do Utilizador do utilizador eliminado a ser recuperado.
Propriedades dos parâmetros
| Tipo: | System.String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | IdentificadorDoObjeto, UPN, Identidade, Nome Principal do Utilizador, 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 |
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]]