Get-EntraDeletedUser

Módulo:: Microsoft.Entra.Users Module v1.3

Recupera usuarios eliminados temporalmente (eliminados recientemente) en Microsoft Entra ID.

Sintaxis

GetQuery (valor predeterminado)

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>]

Description

El Get-EntraDeletedUser cmdlet recupera usuarios eliminados temporalmente (eliminados recientemente) del directorio. Los usuarios eliminados se pueden recuperar en un plazo de 30 días, después de lo cual se eliminan permanentemente.

Ejemplos

Ejemplo 1: Obtención de usuarios eliminados en el directorio

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

En este ejemplo se muestra cómo recuperar todos los usuarios eliminados recuperables en el Microsoft Entra ID.

Ejemplo 2: Obtención de usuarios eliminados en el directorio mediante el 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

En este ejemplo se muestra cómo recuperar todos los usuarios eliminados recuperables mediante el parámetro All.

Ejemplo 3: Obtener los dos principales usuarios 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

En este ejemplo se muestra cómo recuperar los dos primeros usuarios eliminados recuperables en el directorio. Puede usar -Limit como alias para -Top.

Ejemplo 4: Obtención de usuarios eliminados que contienen la cadena "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

En este ejemplo se muestra cómo recuperar usuarios eliminados en el directorio, que contiene la cadena especificada.

Ejemplo 5: Obtener el filtro de usuarios eliminados por nombre para mostrar

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

En este ejemplo se muestra cómo recuperar usuarios eliminados en el directorio, con el nombre para mostrar especificado.

Ejemplo 6: Obtención del usuario eliminado por 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

En este ejemplo se muestra cómo recuperar el usuario eliminado especificado por UserId.

-UserId parameter especifica el user UserId eliminado.

Parámetros

-All

Enumera todas las páginas.

Propiedades de parámetro

Tipo:	System.Management.Automation.SwitchParameter
Valor predeterminado:	False
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Filter

Especifica una instrucción de filtro de OData v4.0. Este parámetro controla qué objetos se devuelven.

Propiedades de parámetro

Tipo:	System.String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

GetQuery

Posición:	Named
Obligatorio:	False
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-Property

Especifica las propiedades que se van a devolver.

Propiedades de parámetro

Tipo:	System.String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	Select

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-SearchString

Especifica una cadena de búsqueda.

Propiedades de parámetro

Tipo:	System.String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

GetVague

Posición:	Named
Obligatorio:	False
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-Top

Especifica el número máximo de registros que se van a devolver.

Propiedades de parámetro

Tipo:	System.Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	Limit

Conjuntos de parámetros

GetQuery

Posición:	Named
Obligatorio:	False
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-UserId

ObjectId o Nombre principal de usuario del usuario eliminado que se va a recuperar.

Propiedades de parámetro

Tipo:	System.String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	ObjectId (identificador de objeto), UPN, Identity, NombrePrincipalDelUsuario, Id

Conjuntos de parámetros

GetById

Posición:	Named
Obligatorio:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea 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]]

Salidas

System.Object

Comentarios

¿Le ha resultado útil esta página?