Get-EntraDevice

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

Ruft ein Gerät von Microsoft Entra ID ab.

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

Beschreibung

Das Get-EntraDevice Cmdlet ruft ein Gerät von Microsoft Entra ID ab. Geben Sie den DeviceId Parameter an, um ein bestimmtes Gerät abzurufen.

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss der angemeldete Benutzer über eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit den erforderlichen Berechtigungen verfügen. Die folgenden am wenigsten privilegierten Rollen werden unterstützt:

Cloudgeräteadministrator
Intune-Administrator
Windows 365-Administrator
Compliance-Administrator
Gerätemanager

Beispiele

Beispiel 1: Abrufen eines Geräts nach 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

In diesem Beispiel wird gezeigt, wie Sie ein Gerät mit seiner ID abrufen.

Beispiel 2: Abrufen eines Geräts nach 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

In diesem Beispiel wird gezeigt, wie Sie ein Gerät mithilfe der DeviceID abrufen.

Beispiel 3: Abrufen aller Geräte

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

In diesem Beispiel wird veranschaulicht, wie alle Geräte aus Microsoft Entra ID abgerufen werden.

Beispiel 4: Abrufen der beiden wichtigsten Geräte

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

In diesem Beispiel wird veranschaulicht, wie die beiden obersten Geräte von Microsoft Entra ID abgerufen werden. Sie können -Limit als Alias für -Top verwenden.

Beispiel 5: Abrufen eines Geräts nach Anzeigename

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

In diesem Beispiel wird das Abrufen des Geräts mithilfe des Anzeigenamens veranschaulicht.

Beispiel 6: Abrufen eines Geräts mithilfe des Anzeigenamens

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

In diesem Beispiel wird veranschaulicht, wie alle Geräte abgerufen werden, deren Anzeigename mit dem Wort Woodgrovebeginnt.

Beispiel 7: Suchen zwischen abgerufenen Geräten

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

In diesem Beispiel wird gezeigt, wie Geräte abgerufen werden, die das Wort "DESKTOP" enthalten.

Beispiel 8: Auflisten doppelter Geräte

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

Die Ausgabe listet doppelte Geräte nach Anzeigename, Betriebssystem und Anzahl auf.

Beispiel 9: Auflisten nicht kompatibler Geräte

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

Beispiel 10: Auflisten fehlerhafter Geräte mit Jailbreak

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

Beispiel 11: Auflisten verwalteter Geräte

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

Beispiel 12: Auflisten aktivierter Geräte

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

Beispiel 13: Auflisten von Geräten mit einem bestimmten Betriebssystem und einer bestimmten Version

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

Beispiel 14: Abrufen veralteter Geräte (inaktiv für 2+ Monate)

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

In diesem Beispiel wird veranschaulicht, wie Geräte abgerufen werden, die sich 2 Monate oder mehr nicht angemeldet haben.

Beispiel 15: Abrufen von Geräten, die vor einem bestimmten Datum angemeldet sind

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

In diesem Beispiel wird veranschaulicht, wie Geräte mit der letzten Anmeldung vor dem 1. September 2024 abgerufen werden.

Beispiel 16: Abrufen nicht kompatibler Geräte mithilfe des Parameters "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

In diesem Beispiel wird veranschaulicht, wie Geräte abgerufen werden, die nicht den Organisationsrichtlinien entsprechen.

Beispiel 17: Abrufen verwalteter Geräte

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

In diesem Beispiel wird veranschaulicht, wie Geräte abgerufen werden, die von einer Mobile Geräteverwaltung (MDM)-Lösung verwaltet werden.

Beispiel 18: Abrufen von Microsoft Entra verbundenen Geräten

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

In diesem Beispiel wird veranschaulicht, wie Geräte abgerufen werden, die Microsoft Entra verbunden sind.

Beispiel 19: Abrufen von Microsoft Entra hybrid verbundenen Geräten

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

In diesem Beispiel wird veranschaulicht, wie Geräte abgerufen werden, die Microsoft Entra hybrid eingebunden sind.

Beispiel 20: Kombinieren mehrerer Filterparameter

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

In diesem Beispiel wird veranschaulicht, wie Sie mehrere Filterparameter kombinieren, um nach veralteten, nicht kompatiblen und verwalteten Geräten zu suchen.

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

-DeviceId

Gibt die ID eines Geräts in Microsoft Entra ID an.

Parametereigenschaften

Typ:	System.String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	Objekt-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

Gibt die OData v4.0-Filter-Anweisung an. Dieser Parameter steuert, welche Objekte zurückgegeben werden.

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

-IsManaged

Filtern Sie Geräte basierend darauf, ob sie von einer Mobile Geräteverwaltung (MDM)-Lösung verwaltet werden. Wird für verwaltete Geräte oder $true für nicht verwaltete Geräte verwendet$false.

Parametereigenschaften

Typ:	System.Nullable`1[System.Boolean]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

GetQuery

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

GetVague

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

-JoinType

Filtern von Geräten nach Verknüpfungstyp: MicrosoftEntraJoined, MicrosoftEntraHybridJoined oder MicrosoftEntraRegistered.

Parametereigenschaften

Typ:	System.String
Standardwert:	None
Zulässige Werte:	MicrosoftEntraJoined, MicrosoftEntraHybridJoined, MicrosoftEntraRegistered
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

GetQuery

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

GetVague

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

-LogonTimeBefore

Filtert Geräte mit der letzten Anmeldung vor einem angegebenen Datum.

Parametereigenschaften

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

Parametersätze

GetQuery

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

GetVague

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

-NonCompliant

Filtern Sie Geräte, die nicht den Organisationsrichtlinien entsprechen.

Parametereigenschaften

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

Parametersätze

GetQuery

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

GetVague

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
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

Gibt eine Suchzeichenfolge an.

Parametereigenschaften

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

Parametersätze

GetValue

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

-Stale

Filtern Sie Geräte, die seit 2 Monaten oder mehr nicht angemeldet sind.

Parametereigenschaften

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

Parametersätze

GetQuery

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

GetVague

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

-Top

Gibt die maximale Anzahl der zurückzugebenden Datensätze an.

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.

Feedback

War diese Seite hilfreich?

Get-EntraDevice

Syntax

GetQuery (Standard)

GetByValue

GetById

Beschreibung

Beispiele

Beispiel 1: Abrufen eines Geräts nach ID

Beispiel 2: Abrufen eines Geräts nach DeviceID

Beispiel 3: Abrufen aller Geräte

Beispiel 4: Abrufen der beiden wichtigsten Geräte

Beispiel 5: Abrufen eines Geräts nach Anzeigename

Beispiel 6: Abrufen eines Geräts mithilfe des Anzeigenamens

Beispiel 7: Suchen zwischen abgerufenen Geräten

Beispiel 8: Auflisten doppelter Geräte

Beispiel 9: Auflisten nicht kompatibler Geräte

Beispiel 10: Auflisten fehlerhafter Geräte mit Jailbreak

Beispiel 11: Auflisten verwalteter Geräte

Beispiel 12: Auflisten aktivierter Geräte

Beispiel 13: Auflisten von Geräten mit einem bestimmten Betriebssystem und einer bestimmten Version

Beispiel 14: Abrufen veralteter Geräte (inaktiv für 2+ Monate)

Beispiel 15: Abrufen von Geräten, die vor einem bestimmten Datum angemeldet sind

Beispiel 16: Abrufen nicht kompatibler Geräte mithilfe des Parameters "NonCompliant"

Beispiel 17: Abrufen verwalteter Geräte

Beispiel 18: Abrufen von Microsoft Entra verbundenen Geräten

Beispiel 19: Abrufen von Microsoft Entra hybrid verbundenen Geräten

Beispiel 20: Kombinieren mehrerer Filterparameter

Parameter

-All

Parametereigenschaften

Parametersätze

-DeviceId

Parametereigenschaften

Parametersätze

-Filter

Parametereigenschaften

Parametersätze

-IsManaged

Parametereigenschaften

Parametersätze

-JoinType

Parametereigenschaften

Parametersätze

-LogonTimeBefore

Parametereigenschaften

Parametersätze

-NonCompliant

Parametereigenschaften

Parametersätze

-Property

Parametereigenschaften

Parametersätze

-SearchString

Parametereigenschaften

Parametersätze

-Stale

Parametereigenschaften

Parametersätze

-Top

Parametereigenschaften

Parametersätze

CommonParameters

Ähnliche Themen

Feedback