Get-EntraDevice

Modul:: Microsoft.Entra.DirectoryManagement Module v1.3

Lekéri az eszközt Microsoft Entra ID.

Syntax

GetQuery (Alapértelmezett)

Get-EntraDevice

    [-Top <Int32>]
    [-All]
    [-Filter <String>]
    [-Property <String[]>]
    [-LogonTimeBefore <DateTime>]
    [-Stale]
    [-NonCompliant]
    [-IsManaged <Boolean>]
    [-JoinType <String>]
    [<CommonParameters>]

GetByValue

Get-EntraDevice

    [-SearchString <String>]
    [-All]
    [-Property <String[]>]
    [-LogonTimeBefore <DateTime>]
    [-Stale]
    [-NonCompliant]
    [-IsManaged <Boolean>]
    [-JoinType <String>]
    [<CommonParameters>]

GetById

Get-EntraDevice

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

Description

A Get-EntraDevice parancsmag lekéri az eszközt Microsoft Entra ID. Adja meg a DeviceId paramétert egy adott eszköz lekéréséhez.

Munkahelyi vagy iskolai fiókkal rendelkező delegált forgatókönyvekben a bejelentkezett felhasználónak támogatott Microsoft Entra szerepkörrel vagy a szükséges engedélyekkel rendelkező egyéni szerepkörrel kell rendelkeznie. A következő legkevésbé kiemelt szerepkörök támogatottak:

Felhőeszköz-rendszergazda
Intune-rendszergazda
Windows 365 rendszergazda
Megfelelőségi rendszergazda
Eszközkezelők

Példák

1. példa: Eszköz lekérése azonosító alapján

Connect-Entra -Scopes 'Device.Read.All'
$device = Get-EntraDevice -SearchString '<device-display-name>'
Get-EntraDevice -ObjectId $device.ObjectId

DeletedDateTime Id                                   AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId                             DeviceMetadata DeviceOwnership
--------------- --                                   -------------- ----------------------------- ---------------------------- -------------- --------                             -------------- ---------------
                bbbbbbbb-1111-2222-3333-cccccccccccc True                                                                                     eeeeeeee-4444-5555-6666-ffffffffffff MetaData

Ez a példa bemutatja, hogyan kérhető le egy eszköz az azonosítójával.

2. példa: Eszköz lekérése DeviceID alapján

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -Filter "DeviceId eq 'eeeeeeee-4444-5555-6666-ffffffffffff'"

DeletedDateTime Id                                   AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId                             DeviceMetadata DeviceOwnership
--------------- --                                   -------------- ----------------------------- ---------------------------- -------------- --------                             -------------- ---------------
                bbbbbbbb-1111-2222-3333-cccccccccccc True                                                                                     eeeeeeee-4444-5555-6666-ffffffffffff MetaData

Ez a példa bemutatja, hogyan lehet lekérni egy eszközt a DeviceID használatával.

3. példa: Az összes eszköz lekérése

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice

DeletedDateTime Id                                   AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId                             DeviceMetadata DeviceOwnership
--------------- --                                   -------------- ----------------------------- ---------------------------- -------------- --------                             -------------- ---------------
                bbbbbbbb-1111-2222-3333-cccccccccccc True                                                                                     eeeeeeee-4444-5555-6666-ffffffffffff MetaData
                cccccccc-2222-3333-4444-dddddddddddd True                                                                                     eeeeeeee-4444-5555-6666-ffffffffffff MetaData

Ez a példa bemutatja, hogyan kérhető le az összes eszköz Microsoft Entra ID.

4. példa: A két legjobb eszköz lekérése

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -Top 2

DeletedDateTime Id                                   AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId                             DeviceMetadata DeviceOwnership
--------------- --                                   -------------- ----------------------------- ---------------------------- -------------- --------                             -------------- ---------------
                bbbbbbbb-1111-2222-3333-cccccccccccc True                                                                                     eeeeeeee-4444-5555-6666-ffffffffffff MetaData
                cccccccc-2222-3333-4444-dddddddddddd True                                                                                     eeeeeeee-4444-5555-6666-ffffffffffff MetaData

Ez a példa bemutatja, hogyan lehet lekérni az első két eszközt a Microsoft Entra ID. A -Limit a -Topaliasaként is használható.

5. példa: Eszköz lekérése megjelenítendő név alapján

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -Filter "DisplayName eq 'Woodgrove Desktop'"

DeletedDateTime Id                                   AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId                             DeviceMetadata DeviceOwnership
--------------- --                                   -------------- ----------------------------- ---------------------------- -------------- --------                             -------------- ---------------
                bbbbbbbb-1111-2222-3333-cccccccccccc True                                                                                     eeeeeeee-4444-5555-6666-ffffffffffff MetaData

Ez a példa bemutatja, hogyan kérhető le az eszköz a megjelenítendő névvel.

6. példa: Eszköz lekérése megjelenítendő névvel

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -Filter "startsWith(DisplayName,'Woodgrove')"

DeletedDateTime Id                                   AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId                             DeviceMetadata DeviceOwnership
--------------- --                                   -------------- ----------------------------- ---------------------------- -------------- --------                             -------------- ---------------
                bbbbbbbb-1111-2222-3333-cccccccccccc True                                                                                     eeeeeeee-4444-5555-6666-ffffffffffff MetaData

Ez a példa bemutatja, hogyan lehet lekérni az összes olyan eszközt, amelynek a megjelenítendő neve a szóval Woodgrovekezdődik.

7. példa: Keresés a lekért eszközök között

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -SearchString 'DESKTOP'

DeletedDateTime Id                                   AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId                             DeviceMetadata DeviceOwnership
--------------- --                                   -------------- ----------------------------- ---------------------------- -------------- --------                             -------------- ---------------
                bbbbbbbb-1111-2222-3333-cccccccccccc True                                                                                     eeeeeeee-4444-5555-6666-ffffffffffff MetaData

Ez a példa bemutatja, hogyan lehet lekérni az "ASZTALI" szót tartalmazó eszközöket.

8. példa: Ismétlődő eszközök listázása

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -All -Select DisplayName, OperatingSystem |
Group-Object DisplayName |
Where-Object { $_.Count -gt 1 } |
Select-Object Name, @{Name = "OperatingSystem"; Expression = { ($_.Group | Select-Object -First 1).OperatingSystem } }, Count | Sort-Object Count -Descending |
Format-Table Name, OperatingSystem, Count -AutoSize

Name                       OperatingSystem Count
----                       --------------- -----
iPhone                     iOS               175
samsungSM-S928B            Android            15
woodgrove-win11-client     Windows             2

A kimenet megjelenítendő név, operációs rendszer és darabszám alapján listázza az ismétlődő eszközöket.

9. példa: Nem megfelelő eszközök listázása

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -Filter "isCompliant eq false"

10. példa: A feltört eszközök listázása

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -All | Where-Object { $_.isRooted -eq $true }

11. példa: Felügyelt eszközök listázása

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -Filter "isManaged eq true"

12. példa: Engedélyezett eszközök listázása

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -Filter "accountEnabled eq true" -All

13. példa: Adott operációs rendszerrel és verzióval rendelkező eszközök listázása

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -Filter "operatingSystem eq 'Windows Server' and operatingSystemVersion eq '10.0.20348.3091'"

14. példa: Elavult eszközök lekérése (2+ hónap inaktív)

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -Stale

DeletedDateTime Id                                   AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId                             DeviceMetadata DeviceOwnership
--------------- --                                   -------------- ----------------------------- ---------------------------- -------------- --------                             -------------- ---------------
                bbbbbbbb-1111-2222-3333-cccccccccccc True           2024-08-15T10:30:00Z                                                      eeeeeeee-4444-5555-6666-ffffffffffff MetaData

Ez a példa bemutatja, hogyan lehet lekérni azokat az eszközöket, amelyek nem jelentkeznek be 2 hónapja vagy annál több éve.

15. példa: Adott dátum előtt bejelentkezett eszközök lekérése

Connect-Entra -Scopes 'Device.Read.All'
$date = Get-Date "2024-09-01"
Get-EntraDevice -LogonTimeBefore $date

DeletedDateTime Id                                   AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId                             DeviceMetadata DeviceOwnership
--------------- --                                   -------------- ----------------------------- ---------------------------- -------------- --------                             -------------- ---------------
                bbbbbbbb-1111-2222-3333-cccccccccccc True           2024-08-15T10:30:00Z                                                      eeeeeeee-4444-5555-6666-ffffffffffff MetaData

Ez a példa bemutatja, hogyan kérhetők le az utolsó bejelentkezéssel rendelkező eszközök 2024. szeptember 1. előtt.

16. példa: Nem megfelelő eszközök lekérése nem megfelelő paraméterrel

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -NonCompliant

DeletedDateTime Id                                   AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId                             DeviceMetadata DeviceOwnership
--------------- --                                   -------------- ----------------------------- ---------------------------- -------------- --------                             -------------- ---------------
                bbbbbbbb-1111-2222-3333-cccccccccccc True                                                                                     eeeeeeee-4444-5555-6666-ffffffffffff MetaData

Ez a példa bemutatja, hogyan kérhetők le olyan eszközök, amelyek nem felelnek meg a szervezeti szabályzatoknak.

17. példa: Felügyelt eszközök lekérése

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -IsManaged $true

DeletedDateTime Id                                   AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId                             DeviceMetadata DeviceOwnership
--------------- --                                   -------------- ----------------------------- ---------------------------- -------------- --------                             -------------- ---------------
                bbbbbbbb-1111-2222-3333-cccccccccccc True                                                                                     eeeeeeee-4444-5555-6666-ffffffffffff MetaData

Ez a példa bemutatja, hogyan kérhetők le a Mobile Eszközkezelés (MDM) megoldások által felügyelt eszközök.

18. példa: Microsoft Entra csatlakoztatott eszközök lekérése

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -JoinType "MicrosoftEntraJoined"

DeletedDateTime Id                                   AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId                             DeviceMetadata DeviceOwnership
--------------- --                                   -------------- ----------------------------- ---------------------------- -------------- --------                             -------------- ---------------
                bbbbbbbb-1111-2222-3333-cccccccccccc True                                                                                     eeeeeeee-4444-5555-6666-ffffffffffff MetaData

Ez a példa bemutatja, hogyan kérhetők le az Microsoft Entra csatlakoztatott eszközök.

19. példa: Microsoft Entra hibrid csatlakoztatott eszközök lekérése

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -JoinType "MicrosoftEntraHybridJoined"

Ez a példa bemutatja, hogyan kérhetők le a hibrid csatlakoztatott Microsoft Entra eszközök.

20. példa: Több szűrőparaméter kombinálása

Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -Stale -NonCompliant -IsManaged $true

DeletedDateTime Id                                   AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId                             DeviceMetadata DeviceOwnership
--------------- --                                   -------------- ----------------------------- ---------------------------- -------------- --------                             -------------- ---------------
                bbbbbbbb-1111-2222-3333-cccccccccccc True           2024-08-15T10:30:00Z                                                      eeeeeeee-4444-5555-6666-ffffffffffff MetaData

Ez a példa bemutatja, hogyan kombinálhat több szűrőparamétert az elavult, nem megfelelő és felügyelt eszközök megkereséséhez.

Paraméterek

-All

Az összes oldal listázása.

Paramétertulajdonságok

Típus:	System.Management.Automation.SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-DeviceId

Egy eszköz azonosítóját adja meg a Microsoft Entra ID.

Paramétertulajdonságok

Típus:	System.String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	ObjectId (objektumazonosító)

Paraméterkészletek

GetById

Position:	Named
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Filter

Megadja az OData v4.0 szűrőutasítást. Ez a paraméter szabályozza, hogy mely objektumok lesznek visszaadva.

Paramétertulajdonságok

Típus:	System.String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

GetQuery

Position:	Named
Kötelező:	False
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-IsManaged

Az eszközök szűrése attól függően, hogy mobil Eszközkezelés (MDM) megoldás kezeli-e őket. Felügyelt vagy $true nem felügyelt eszközökhöz használható$false.

Paramétertulajdonságok

Típus:	System.Nullable`1[System.Boolean]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

GetQuery

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

GetVague

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-JoinType

Eszközök szűrése illesztési típus szerint: MicrosoftEntraJoined, MicrosoftEntraHybridJoined vagy MicrosoftEntraRegistered.

Paramétertulajdonságok

Típus:	System.String
Alapértelmezett érték:	None
Elfogadott értékek:	MicrosoftEntraJoined, MicrosoftEntraHybridJoined, MicrosoftEntraRegistered
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

GetQuery

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

GetVague

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-LogonTimeBefore

Az utolsó bejelentkezéssel rendelkező eszközök szűrése egy megadott dátum előtt.

Paramétertulajdonságok

Típus:	System.DateTime
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

GetQuery

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

GetVague

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-NonCompliant

Szűrje azokat az eszközöket, amelyek nem felelnek meg a szervezeti szabályzatnak.

Paramétertulajdonságok

Típus:	System.Management.Automation.SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

GetQuery

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

GetVague

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Property

Megadja a visszaadandó tulajdonságokat

Paramétertulajdonságok

Típus:	System.String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Select

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-SearchString

Keresési sztringet ad meg.

Paramétertulajdonságok

Típus:	System.String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

GetValue

Position:	Named
Kötelező:	False
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Stale

Szűrje azokat az eszközöket, amelyek nem jelentkeznek be 2 hónapja vagy annál több éve.

Paramétertulajdonságok

Típus:	System.Management.Automation.SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

GetQuery

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

GetVague

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Top

Megadja a visszaadni kívánt rekordok maximális számát.

Paramétertulajdonságok

Típus:	System.Int32
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Limit

Paraméterkészletek

GetQuery

Position:	Named
Kötelező:	False
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Get-EntraDevice

Syntax

GetQuery (Alapértelmezett)

GetByValue

GetById

Description

Példák

1. példa: Eszköz lekérése azonosító alapján

2. példa: Eszköz lekérése DeviceID alapján

3. példa: Az összes eszköz lekérése

4. példa: A két legjobb eszköz lekérése

5. példa: Eszköz lekérése megjelenítendő név alapján

6. példa: Eszköz lekérése megjelenítendő névvel

7. példa: Keresés a lekért eszközök között

8. példa: Ismétlődő eszközök listázása

9. példa: Nem megfelelő eszközök listázása

10. példa: A feltört eszközök listázása

11. példa: Felügyelt eszközök listázása

12. példa: Engedélyezett eszközök listázása

13. példa: Adott operációs rendszerrel és verzióval rendelkező eszközök listázása

14. példa: Elavult eszközök lekérése (2+ hónap inaktív)

15. példa: Adott dátum előtt bejelentkezett eszközök lekérése

16. példa: Nem megfelelő eszközök lekérése nem megfelelő paraméterrel

17. példa: Felügyelt eszközök lekérése

18. példa: Microsoft Entra csatlakoztatott eszközök lekérése

19. példa: Microsoft Entra hibrid csatlakoztatott eszközök lekérése

20. példa: Több szűrőparaméter kombinálása

Paraméterek

-All

Paramétertulajdonságok

Paraméterkészletek

-DeviceId

Paramétertulajdonságok

Paraméterkészletek

-Filter

Paramétertulajdonságok

Paraméterkészletek

-IsManaged

Paramétertulajdonságok

Paraméterkészletek

-JoinType

Paramétertulajdonságok

Paraméterkészletek

-LogonTimeBefore

Paramétertulajdonságok

Paraméterkészletek

-NonCompliant

Paramétertulajdonságok

Paraméterkészletek

-Property

Paramétertulajdonságok

Paraméterkészletek

-SearchString

Paramétertulajdonságok

Paraméterkészletek

-Stale

Paramétertulajdonságok

Paraméterkészletek

-Top

Paramétertulajdonságok

Paraméterkészletek

CommonParameters

Kapcsolódó hivatkozások

Visszajelzés