Get-EntraDeletedDevice

Ruft die Liste der zuvor gelöschten Geräte ab.

Syntax

GetQuery (Standard)

Get-EntraDeletedDevice

    [-Filter <String>]
    [-All]
    [-Top <Int32>]
    [-Property <String[]>]
    [<CommonParameters>]

GetVague

Get-EntraDeletedDevice

    [-SearchString <String>]
    [-All]
    [-Property <String[]>]
    [<CommonParameters>]

GetById

Get-EntraDeletedDevice

    -DeviceObjectId <String>
    [-Property <String[]>]
    [<CommonParameters>]

Beschreibung

Das Get-EntraDeletedDevice Cmdlet ruft die Liste der zuvor gelöschten Geräte ab.

Beispiele

Beispiel 1: Abrufen einer Liste gelöschter Geräte

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDeletedDevice -All | Select-Object DeletedDateTime, Id, AccountEnabled, ApproximateLastSignInDateTime, DeviceId, DisplayName, DeletionAgeInDays | Format-Table -AutoSize
DeletedDateTime         Id                                   AccountEnabled ApproximateLastSignInDateTime DeviceId                             DisplayName      DeletionAgeInDays
---------------         --                                   -------------- ----------------------------- --------                             -----------      -------------------
11/11/2024 5:16:25 PM  bbbbbbbb-1111-2222-3333-cccccccccccc False          7/12/2024 8:36:17 PM          aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Network           10
11/6/2024 7:24:39 PM   dddddddd-3333-4444-5555-eeeeeeeeeeee True           10/29/2024 9:07:18 PM         eeeeeeee-4444-5555-6666-ffffffffffff iPhone 12 Pro     15
10/28/2024 4:16:02 PM  cccccccc-2222-3333-4444-dddddddddddd True           6/24/2024 8:00:39 PM          bbbbbbbb-1111-2222-3333-cccccccccccc Contoso Desktop   28

Dieses Cmdlet ruft die Liste der gelöschten Geräte ab.

Beispiel 2: Abrufen einer Liste der gelöschten Geräte mit dem Parameter "Alle"

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDeletedDevice -All | Select-Object DeletedDateTime, Id, AccountEnabled, ApproximateLastSignInDateTime, DeviceId, DisplayName, DeletionAgeInDays | Format-Table -AutoSize
DeletedDateTime         Id                                   AccountEnabled ApproximateLastSignInDateTime DeviceId                             DisplayName      DeletionAgeInDays
---------------         --                                   -------------- ----------------------------- --------                             -----------      -------------------
11/11/2024 5:16:25 PM  bbbbbbbb-1111-2222-3333-cccccccccccc False          7/12/2024 8:36:17 PM          aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Network           10
11/6/2024 7:24:39 PM   dddddddd-3333-4444-5555-eeeeeeeeeeee True           10/29/2024 9:07:18 PM         eeeeeeee-4444-5555-6666-ffffffffffff iPhone 12 Pro     15
10/28/2024 4:16:02 PM  cccccccc-2222-3333-4444-dddddddddddd True           6/24/2024 8:00:39 PM          bbbbbbbb-1111-2222-3333-cccccccccccc Contoso Desktop   28

Mit diesem Cmdlet wird die Liste der gelöschten Geräte mithilfe des Parameters "All" abgerufen.

Beispiel 3: Abrufen der beiden wichtigsten gelöschten Geräte

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDeletedDevice -Top 2 | Select-Object DeletedDateTime, Id, AccountEnabled, ApproximateLastSignInDateTime, DeviceId, DisplayName, DeletionAgeInDays | Format-Table -AutoSize
DeletedDateTime         Id                                   AccountEnabled ApproximateLastSignInDateTime DeviceId                             DisplayName      DeletionAgeInDays
---------------         --                                   -------------- ----------------------------- --------                             -----------      -------------------
11/11/2024 5:16:25 PM  bbbbbbbb-1111-2222-3333-cccccccccccc False          7/12/2024 8:36:17 PM          aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Network           10
10/28/2024 4:16:02 PM  cccccccc-2222-3333-4444-dddddddddddd True           6/24/2024 8:00:39 PM          bbbbbbbb-1111-2222-3333-cccccccccccc Contoso Desktop   28

Dieses Cmdlet ruft die beiden wichtigsten gelöschten Geräte ab. Sie können -Limit als Alias für -Top verwenden.

Beispiel 4: Abrufen gelöschter Geräte mithilfe des SearchString-Parameters

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDeletedDevice -SearchString 'Contoso Desktop' | Select-Object DeletedDateTime, Id, AccountEnabled, ApproximateLastSignInDateTime, DeviceId, DisplayName, DeletionAgeInDays | Format-Table -AutoSize
DeletedDateTime         Id                                   AccountEnabled ApproximateLastSignInDateTime DeviceId                             DisplayName      DeletionAgeInDays
---------------         --                                   -------------- ----------------------------- --------                             -----------      -------------------
10/28/2024 4:16:02 PM  cccccccc-2222-3333-4444-dddddddddddd True           6/24/2024 8:00:39 PM          bbbbbbbb-1111-2222-3333-cccccccccccc Contoso Desktop   28

Dieses Cmdlet ruft gelöschte Geräte mithilfe des SearchString-Parameters ab.

Beispiel 5: Abrufen des Filters für gelöschte Geräte nach Anzeigename

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDeletedDevice -Filter "DisplayName eq 'Contoso Desktop'" | Select-Object DeletedDateTime, Id, AccountEnabled, ApproximateLastSignInDateTime, DeviceId, DisplayName, DeletionAgeInDays | Format-Table -AutoSize
DeletedDateTime         Id                                   AccountEnabled ApproximateLastSignInDateTime DeviceId                             DisplayName      DeletionAgeInDays
---------------         --                                   -------------- ----------------------------- --------                             -----------      -------------------
10/28/2024 4:16:02 PM  cccccccc-2222-3333-4444-dddddddddddd True           6/24/2024 8:00:39 PM          bbbbbbbb-1111-2222-3333-cccccccccccc Contoso Desktop   28

Mit diesem Cmdlet werden gelöschte Geräte mit dem angegebenen Anzeigenamen abgerufen.

Beispiel 6: Abrufen eines gelöschten Geräts durch DeviceObjectId

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDeletedDevice -DeviceObjectId 'cccccccc-2222-3333-4444-dddddddddddd' | Select-Object DeletedDateTime, Id, AccountEnabled, ApproximateLastSignInDateTime, DeviceId, DisplayName, DeletionAgeInDays | Format-Table -AutoSize
DeletedDateTime         Id                                   AccountEnabled ApproximateLastSignInDateTime DeviceId                             DisplayName
---------------         --                                   -------------- ----------------------------- --------                             ------
10/28/2024 4:16:02 PM  cccccccc-2222-3333-4444-dddddddddddd True           6/24/2024 8:00:39 PM          bbbbbbbb-1111-2222-3333-cccccccccccc Woodgrove Desktop

Dieses Cmdlet ruft das durch DeviceObjectId angegebene gelöschte Gerät ab.

  • -DeviceObjectId der Parameter gibt die gelöschte Geräte-ID an.

Beispiel 7: Abrufen eines gelöschten Geräts nach DeviceId

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDeletedDevice -Filter "deviceId eq 'bbbbbbbb-1111-2222-3333-cccccccccccc'"
DeletedDateTime         Id                                   AccountEnabled ApproximateLastSignInDateTime DeviceId                             DisplayName
---------------         --                                   -------------- ----------------------------- --------                             ------
10/28/2024 4:16:02 PM  cccccccc-2222-3333-4444-dddddddddddd True           6/24/2024 8:00:39 PM          bbbbbbbb-1111-2222-3333-cccccccccccc Woodgrove Desktop

Dieses Cmdlet ruft das durch DeviceId angegebene gelöschte Gerät ab.

  • -DeviceId der Parameter gibt die gelöschte Geräte-ID an.

Parameter

-All

Alle Seiten auflisten.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DeviceObjectId

Die eindeutige ID des gelöschten Geräts, das abgerufen werden soll.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Id

Parametersätze

GetById
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Filter

Rufen Sie nur die gelöschten Geräte ab, die den Filter erfüllen.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetQuery
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Property

Gibt eigenschaften an, die zurückgegeben werden sollen

Parametereigenschaften

Typ:

System.String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Select

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SearchString

Rufen Sie nur die Geräte ab, die den -SearchString Wert erfüllen.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetVague
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Top

Die maximale Anzahl von Geräten.

Parametereigenschaften

Typ:System.Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Begrenzung

Parametersätze

GetQuery
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

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

Ausgaben

System.Object