Get-EntraDeletedUser

Moduł:: Microsoft.Entra.Users Module v1.3

Pobiera użytkowników usuniętych nietrwale (ostatnio usuniętych) w Microsoft Entra ID.

Składnia

GetQuery (domyślnie)

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

Opis

Polecenie Get-EntraDeletedUser cmdlet pobiera użytkowników usuniętych nietrwale (ostatnio usuniętych) z katalogu. Usuniętych użytkowników można odzyskać w ciągu 30 dni, po czym zostaną trwale usunięci.

Przykłady

Przykład 1. Pobieranie usuniętych użytkowników w katalogu

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

W tym przykładzie pokazano, jak pobrać wszystkich możliwych do odzyskania usuniętych użytkowników w Microsoft Entra ID.

Przykład 2. Pobieranie usuniętych użytkowników w katalogu przy użyciu parametru Wszystkie

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

W tym przykładzie pokazano, jak pobrać wszystkich możliwych do odzyskania usuniętych użytkowników przy użyciu parametru Wszystkie.

Przykład 3. Pobieranie dwóch pierwszych usuniętych użytkowników

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

W tym przykładzie pokazano, jak pobrać dwóch pierwszych usuniętych użytkowników z katalogu. Możesz użyć -Limit jako aliasu dla -Top.

Przykład 4. Pobieranie usuniętych użytkowników zawierających ciąg "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

W tym przykładzie pokazano, jak pobrać usuniętych użytkowników w katalogu zawierającym określony ciąg.

Przykład 5. Pobieranie usuniętych użytkowników filtruje według nazwy wyświetlanej

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

W tym przykładzie pokazano, jak pobrać usuniętych użytkowników w katalogu z określoną nazwą wyświetlaną.

Przykład 6. Pobieranie usuniętego użytkownika według identyfikatora użytkownika

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

W tym przykładzie pokazano, jak pobrać usuniętego użytkownika określonego przez userId.

-UserId parametr określa usunięty identyfikator userId.

Parametry

-All

Wyświetl listę wszystkich stron.

Właściwości parametru

Typ:	System.Management.Automation.SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Filter

Określa instrukcję filtru OData w wersji 4.0. Ten parametr określa, które obiekty są zwracane.

Właściwości parametru

Typ:	System.String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

GetQuery

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Property

Określa właściwości, które mają być zwracane

Właściwości parametru

Typ:	System.String[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Select

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-SearchString

Określa ciąg wyszukiwania.

Właściwości parametru

Typ:	System.String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

GetVague

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Top

Określa maksymalną liczbę rekordów do zwrócenia.

Właściwości parametru

Typ:	System.Int32
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Ograniczenie

Zestawy parametrów

GetQuery

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-UserId

Identyfikator ObjectId lub główna nazwa użytkownika usuniętego użytkownika, który ma zostać pobrany.

Właściwości parametru

Typ:	System.String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Identyfikator Obiektu, nazwa UPN, Identity, NazwaGłównaUżytkownika, Id

Zestawy parametrów

GetById

Position:	Named
Obowiązkowe:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

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

Dane wyjściowe

System.Object

Opinia

Czy ta strona była pomocna?