Get-EntraDevice

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

Hämtar en enhet från Microsoft Entra ID.

Syntax

GetQuery (Standard)

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

Cmdleten Get-EntraDevice hämtar en enhet från Microsoft Entra ID. Ange parametern DeviceId för att hämta en specifik enhet.

I delegerade scenarier med arbets- eller skolkonton måste den inloggade användaren ha en Microsoft Entra roll som stöds eller en anpassad roll med nödvändiga behörigheter. Följande minst privilegierade roller stöds:

Moln-enhetsadministratör
Intune-administratör
Windows 365 administratör
Efterlevnadsadministratör
Enhetshanterare

Exempel

Exempel 1: Hämta en enhet efter ID

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

Det här exemplet visar hur du hämtar en enhet med dess ID.

Exempel 2: Hämta en enhet efter DeviceID

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

Det här exemplet visar hur du hämtar en enhet med hjälp av DeviceID.

Exempel 3: Hämta alla enheter

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

Det här exemplet visar hur du hämtar alla enheter från Microsoft Entra ID.

Exempel 4: Hämta de två översta enheterna

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

Det här exemplet visar hur du hämtar de två översta enheterna från Microsoft Entra ID. Du kan använda -Limit som ett alias för -Top.

Exempel 5: Hämta en enhet efter visningsnamn

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

Det här exemplet visar hur du hämtar enheten med visningsnamnet.

Exempel 6: Hämta en enhet med visningsnamnet

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

Det här exemplet visar hur du hämtar alla enheter vars visningsnamn börjar med ordet Woodgrove.

Exempel 7: Sök bland hämtade enheter

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

Det här exemplet visar hur du hämtar enheter som innehåller ordet "DESKTOP".

Exempel 8: Lista dubblettenheter

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

Resultatet visar duplicerade enheter sorterade efter visningsnamn, operativsystem och antal.

Exempel 9: Lista icke-kompatibla enheter

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

Exempel 10: Lista jail broken devices

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

Exempel 11: Lista hanterade enheter

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

Exempel 12: Lista aktiverade enheter

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

Exempel 13: Lista enheter med specifika operativsystem och versioner

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

Exempel 14: Hämta inaktuella enheter (inaktiva i 2+ månader)

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

Det här exemplet visar hur du hämtar enheter som inte har loggat in på två månader eller mer.

Exempel 15: Hämta enheter som har loggat in före ett visst datum

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

Det här exemplet visar hur du hämtar enheter med senaste inloggning före den 1 september 2024.

Exempel 16: Hämta icke-kompatibla enheter med parametern NonCompliant

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

Det här exemplet visar hur du hämtar enheter som inte är kompatibla med organisationsprinciper.

Exempel 17: Hämta hanterade enheter

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

Det här exemplet visar hur du hämtar enheter som hanteras av en MDM-lösning (Mobile Správa zariadení).

Exempel 18: Hämta Microsoft Entra anslutna enheter

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

Det här exemplet visar hur du hämtar enheter som är Microsoft Entra anslutna.

Exempel 19: Hämta Microsoft Entra Hybrid-anslutna enheter

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

Det här exemplet visar hur du hämtar enheter som är Microsoft Entra Hybrid-anslutna.

Exempel 20: Kombinera flera filterparametrar

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

Det här exemplet visar hur du kombinerar flera filterparametrar för att hitta enheter som är inaktuella, inkompatibla och hanterade.

Parametrar

-All

Visa en lista över alla sidor.

Parameteregenskaper

Typ:	System.Management.Automation.SwitchParameter
Standardvärde:	False
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-DeviceId

Anger ID för en enhet i Microsoft Entra ID.

Parameteregenskaper

Typ:	System.String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	Objekt-ID

Parameteruppsättningar

GetById

Position:	Named
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-Filter

Anger filtersatsen OData v4.0. Den här parametern styr vilka objekt som returneras.

Parameteregenskaper

Typ:	System.String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

GetQuery

Position:	Named
Obligatorisk:	False
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-IsManaged

Filtrera enheter baserat på om de hanteras av en MDM-lösning (Mobile Správa zariadení). Används $true för hanterade enheter eller $false för ohanterade enheter.

Parameteregenskaper

Typ:	System.Nullable`1[System.Boolean]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

GetQuery

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

GetVague

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-JoinType

Filtrera enheter efter kopplingstyp: MicrosoftEntraJoined, MicrosoftEntraHybridJoined eller MicrosoftEntraRegistered.

Parameteregenskaper

Typ:	System.String
Standardvärde:	None
Godkända värden:	MicrosoftEntraJoined, MicrosoftEntraHybridJoined, MicrosoftEntraRegistered
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

GetQuery

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

GetVague

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-LogonTimeBefore

Filtrera enheter med senaste inloggning före ett angivet datum.

Parameteregenskaper

Typ:	System.DateTime
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

GetQuery

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

GetVague

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-NonCompliant

Filtrera enheter som inte är kompatibla med organisationsprinciper.

Parameteregenskaper

Typ:	System.Management.Automation.SwitchParameter
Standardvärde:	False
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

GetQuery

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

GetVague

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-Property

Anger egenskaper som ska returneras

Parameteregenskaper

Typ:	System.String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	Select

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-SearchString

Anger en söksträng.

Parameteregenskaper

Typ:	System.String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

GetValue

Position:	Named
Obligatorisk:	False
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-Stale

Filtrera enheter som inte har loggat in på två månader eller mer.

Parameteregenskaper

Typ:	System.Management.Automation.SwitchParameter
Standardvärde:	False
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

GetQuery

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

GetVague

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-Top

Anger det maximala antalet poster som ska returneras.

Parameteregenskaper

Typ:	System.Int32
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	Limit

Parameteruppsättningar

GetQuery

Position:	Named
Obligatorisk:	False
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Feedback

Var den här sidan till hjälp?

Get-EntraDevice

Syntax

GetQuery (Standard)

GetByValue

GetById

Description

Exempel

Exempel 1: Hämta en enhet efter ID

Exempel 2: Hämta en enhet efter DeviceID

Exempel 3: Hämta alla enheter

Exempel 4: Hämta de två översta enheterna

Exempel 5: Hämta en enhet efter visningsnamn

Exempel 6: Hämta en enhet med visningsnamnet

Exempel 7: Sök bland hämtade enheter

Exempel 8: Lista dubblettenheter

Exempel 9: Lista icke-kompatibla enheter

Exempel 10: Lista jail broken devices

Exempel 11: Lista hanterade enheter

Exempel 12: Lista aktiverade enheter

Exempel 13: Lista enheter med specifika operativsystem och versioner

Exempel 14: Hämta inaktuella enheter (inaktiva i 2+ månader)

Exempel 15: Hämta enheter som har loggat in före ett visst datum

Exempel 16: Hämta icke-kompatibla enheter med parametern NonCompliant

Exempel 17: Hämta hanterade enheter

Exempel 18: Hämta Microsoft Entra anslutna enheter

Exempel 19: Hämta Microsoft Entra Hybrid-anslutna enheter

Exempel 20: Kombinera flera filterparametrar

Parametrar

-All

Parameteregenskaper

Parameteruppsättningar

-DeviceId

Parameteregenskaper

Parameteruppsättningar

-Filter

Parameteregenskaper

Parameteruppsättningar

-IsManaged

Parameteregenskaper

Parameteruppsättningar

-JoinType

Parameteregenskaper

Parameteruppsättningar

-LogonTimeBefore

Parameteregenskaper

Parameteruppsättningar

-NonCompliant

Parameteregenskaper

Parameteruppsättningar

-Property

Parameteregenskaper

Parameteruppsättningar

-SearchString

Parameteregenskaper

Parameteruppsättningar

-Stale

Parameteregenskaper

Parameteruppsättningar

-Top

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Relaterade länkar

Feedback