Get-EntraDeletedDevice
Pobiera listę wcześniej usuniętych urządzeń.
Składnia
GetQuery (domyślnie)
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>]
Opis
Polecenie Get-EntraDeletedDevice cmdlet pobiera listę wcześniej usuniętych urządzeń.
Przykłady
Przykład 1. Pobieranie listy usuniętych urządzeń
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
To polecenie cmdlet pobiera listę usuniętych urządzeń.
Przykład 2. Pobieranie listy usuniętych urządzeń przy użyciu parametru Wszystkie
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
To polecenie cmdlet pobiera listę usuniętych urządzeń przy użyciu parametru Wszystkie.
Przykład 3: Pobieranie dwóch pierwszych usuniętych urządzeń
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
To polecenie cmdlet pobiera dwa pierwsze usunięte urządzenia. Możesz użyć -Limit jako aliasu dla -Top.
Przykład 4. Pobieranie usuniętych urządzeń przy użyciu parametru SearchString
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
To polecenie cmdlet pobiera usunięte urządzenia przy użyciu parametru SearchString.
Przykład 5. Pobieranie usuniętego filtru urządzeń według nazwy wyświetlanej
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
To polecenie cmdlet pobiera usunięte urządzenia o określonej nazwie wyświetlanej.
Przykład 6. Pobieranie usuniętego urządzenia według identyfikatora 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
To polecenie cmdlet pobiera usunięte urządzenie określone przez identyfikator DeviceObjectId.
-
-DeviceObjectIdparametr określa identyfikator usuniętego urządzenia.
Przykład 7. Pobieranie usuniętego urządzenia za pomocą identyfikatora 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
To polecenie cmdlet pobiera usunięte urządzenie określone przez deviceId.
-
-DeviceIdparametr określa identyfikator usuniętego urządzenia.
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 |
-DeviceObjectId
Unikatowy identyfikator usuniętego urządzenia do pobrania.
Właściwości parametru
| Typ: | System.String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | 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 |
-Filter
Pobierz tylko te usunięte urządzenia, które spełniają filtr.
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
Pobierz tylko te urządzenia, które spełniają wartość -SearchString.
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
Maksymalna liczba urządzeń.
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 |
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]]