Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Microsoft Entra PowerShell bietet leistungsstarke Cmdlets zum Verwalten von Geräteidentitäten und zur Überwachung verwandter Ereignisse. Eine effektive Geräteverwaltung ist für die Aufrechterhaltung der Sicherheit, die Sicherstellung der Compliance und die Unterstützung reibungsloser Vorgänge innerhalb einer Organisation unerlässlich.
Mit Microsoft Entra PowerShell können Sie Geräte nach Bedarf hinzufügen, aktualisieren und entfernen sowie Geräteinformationen abrufen, detaillierte Gerätedaten anzeigen und Geräteeinstellungen verwalten. Dieser Artikel enthält ein umfassendes Handbuch zum Verwalten von Geräten mit Microsoft Entra PowerShell.
In diesem Artikel erfahren Sie, wie Sie Geräteidentitäten und -einstellungen mithilfe von Microsoft Entra PowerShell effektiv verwalten. Es behandelt Aufgaben wie Anzeigen, Filtern, Aktivieren, Deaktivieren und Löschen von Geräten und Exportieren von Gerätedaten.
Voraussetzungen
Um Geräte mit Microsoft Entra PowerShell zu verwalten, benötigen Sie Folgendes:
- Ein Microsoft Entra Benutzerkonto. Falls Sie über keins verfügen, können Sie ein kostenloses Konto erstellen.
- Eine der folgenden Rollen:
- Cloud-Geräteadministrator (Lesen und Ändern)
- Intune-Administrator (schreibgeschützt)
- Windows 365 Administrator (schreibgeschützt)
- Microsoft Entra PowerShell-Modul installiert. Befolgen Sie die Anleitung zum Installieren des Microsoft Entra PowerShell-Moduls, um das Modul zu installieren.
Anzeigen und Filtern Ihrer Geräte
Verwenden Sie Microsoft Entra PowerShell, um die Geräteliste nach den folgenden Attributen zu filtern:
Geräte-ID, Anzeigename, Aktivierungsstatus, Konformitätsstatus, Beitrittstyp, Zeitstempel der Aktivität, Betriebssystemtyp, Betriebssystemversion, Gerätetyp, MDM, Autopilot, Erweiterungsattribute, Verwaltungseinheit, Besitzer, Hersteller, Modell und Seriennummer.
Alle Geräte anzeigen
Verwenden Sie das folgende Cmdlet, um alle Geräte anzuzeigen:
Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -All | Select-Object AccountEnabled, DeviceId, OperatingSystem, ApproximateLastSignInDateTime, DisplayName | ft
AccountEnabled DeviceId OperatingSystem ApproximateLastSignInDateTime DisplayName
-------------- -------- --------------- ----------------------------- -----------
True aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Windows 10/16/2024 4:53:46 PM devicesTest2
True bbbbbbbb-1111-2222-3333-cccccccccccc Windows 10/15/2024 4:11:33 PM LAPTOP-2222
True cccccccc-4444-5555-6666-dddddddddddd Windows 9/13/2024 5:46:08 PM AdminTest
True dddddddd-5555-6666-7777-eeeeeeeeeeee Windows 10/15/2024 8:28:18 PM DESKTOP-1111
Ein Gerät anhand der ID abrufen
Um ein bestimmtes Gerät anhand seiner ID abzurufen, verwenden Sie Folgendes:
Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -ObjectId 'bbbbbbbb-1111-2222-3333-cccccccccccc'
DeletedDateTime Id AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId DeviceMetadata DeviceOwnership
--------------- -- -------------- ----------------------------- ---------------------------- -------------- -------- -------------- --------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb False 10/2/2024 10:26:38 AM eeeeeeee-5555-6666-7777-ffffffffffff
Ein Gerät anhand des Anzeigenamens abrufen
Um Geräte anhand des Anzeigenamens zu finden, verwenden Sie Folgendes:
Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -Filter "startsWith(DisplayName,'Woodgrove')"
DeletedDateTime Id AccountEnabled ApproximateLastSignInDateTime ComplianceExpirationDateTime DeviceCategory DeviceId DeviceMetadata DeviceOwnershi
p
--------------- -- -------------- ----------------------------- ---------------------------- -------------- -------- -------------- --------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb True 10/1/2024 4:11:35 PM gggggggg-6666-7777-8888-hhhhhhhhhhhh
bbbbbbbb-1111-2222-3333-cccccccccccc False 10/2/2024 10:26:38 AM hhhhhhhh-7777-8888-9999-iiiiiiiiiiii
In diesem Beispiel wird veranschaulicht, wie alle Geräte abgerufen werden, deren Anzeigename mit "Woodgrove" beginnt.
Anzahl der Geräte gruppiert nach Verknüpfungstyp abrufen
Um alle Gerätetypen zu ermitteln, die mit Microsoft Entra PowerShell in Ihr Verzeichnis eingebunden sind, können Sie das Get-EntraDevice Cmdlet verwenden und die Ergebnisse nach der TrustType Eigenschaft gruppieren.
Connect-Entra -Scopes 'Device.Read.All'
Get-EntraDevice -All | Group-Object -Property TrustType | Select-Object Name, Count
-
Get-EntraDevice -All: Ruft alle Geräte in Ihrem Verzeichnis ab. -
Group-Object -Property TrustType: Gruppiert die Geräte nach der EigenschaftTrustType, die den Beitrittstyp angibt, z. B. Microsoft Entra-verbunden und hybrid mit Microsoft Entra verbunden. -
Select-Object Name, Count: Wählt den Namen jeder Gruppe (den Typ der Verknüpfung) und die Anzahl der Geräte in jeder Gruppe aus. -
Join typebezieht sich darauf, wie ein Gerät verbunden ist, z. B. Microsoft Entra-verbunden, Hybrid-Microsoft Entra und andere Typen.
In diesem Beispiel wird veranschaulicht, wie die Anzahl der Geräte für jeden Gerätetyp abgerufen wird.
Name Count
---- -----
14
EntraID 66
ServerAd 18
Workplace 393
Doppelte Geräte auflisten
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
Die Ausgabe listet doppelte Geräte nach Anzeigename, Betriebssystem und Anzahl auf.
Name OperatingSystem Count
---- --------------- -----
iPhone iOS 175
samsungSM-S928B Android 15
woodgrove-win11-client Windows 2
Geräte suchen
Bestimmtes Gerät mithilfe von
DeviceIdabrufenConnect-Entra -Scopes 'Device.Read.All' Get-EntraDevice -Filter "DeviceId eq 'dddddddd-5555-6666-7777-eeeeeeeeeeee'" | Select-Object Id, AccountEnabled,DeviceId, DisplayNameDie Ausgabe zeigt Gerätedetails basierend auf einer
DeviceIdSuche an.Id AccountEnabled DeviceId DisplayName -- -------------- -------- ----------- aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb True dddddddd-5555-6666-7777-eeeeeeeeeeee ADFS DeviceAuflisten nicht kompatibler Geräte
Connect-Entra -Scopes 'Device.Read.All' Get-EntraDevice -Filter "isCompliant eq false" | Select-Object Id, isCompliant,DeviceId, DisplayNameDie Ausgabe listet nicht kompatible Geräte auf.
Id IsCompliant DeviceId DisplayName -- ----------- -------- ----------- aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb False gggggggg-6666-7777-8888-hhhhhhhhhhhh ADFS Device bbbbbbbb-1111-2222-3333-cccccccccccc False hhhhhhhh-7777-8888-9999-iiiiiiiiiiii Woodgrove DeviceGeräte mit Jailbreak auflisten
Connect-Entra -Scopes 'Device.Read.All' Get-EntraDevice -All | Where-Object { $_.isRooted -eq $true } | Select-Object Id, IsRooted,DeviceId, DisplayNameDie Ausgabe listet Geräte mit Jailbreak auf.
Id IsRooted DeviceId DisplayName -- -------- -------- ----------- aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb True gggggggg-6666-7777-8888-hhhhhhhhhhhh ADFS DeviceVerwaltete Geräte auflisten
Connect-Entra -Scopes 'Device.Read.All' Get-EntraDevice -Filter "isManaged eq true" | Select-Object Id, isManaged,DeviceId, DisplayNameDie Ausgabe listet verwaltete Geräte auf.
Id IsManaged DeviceId DisplayName -- --------- -------- ----------- aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb True gggggggg-6666-7777-8888-hhhhhhhhhhhh ADFS Device bbbbbbbb-1111-2222-3333-cccccccccccc True hhhhhhhh-7777-8888-9999-iiiiiiiiiiii Woodgrove DeviceAuflisten aktivierter Geräte
Connect-Entra -Scopes 'Device.Read.All' Get-EntraDevice -Filter "accountEnabled eq true" -All | Select-Object Id, AccountEnabled,DeviceId, DisplayNameDie Ausgabe listet aktivierte Geräte auf.
Id AccountEnabled DeviceId DisplayName -- -------------- -------- ----------- aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb True gggggggg-6666-7777-8888-hhhhhhhhhhhh ADFS Device bbbbbbbb-1111-2222-3333-cccccccccccc True hhhhhhhh-7777-8888-9999-iiiiiiiiiiii Woodgrove DeviceAuflisten 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'" | Select-Object Id, AccountEnabled,DeviceId, DisplayName, operatingSystem, operatingSystemVersion | Format-Table -AutoSizeDie Ausgabe zeigt Benutzerdetails auf Grundlage einer Suche mit
operatingSystemundoperatingSystemVersionan.Id AccountEnabled DeviceId DisplayName OperatingSystem OperatingSystemVersion -- -------------- -------- ----------- --------------- ---------------------- aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb True gggggggg-6666-7777-8888-hhhhhhhhhhhh ADFS Device Windows Server 10.0.20348.3091 bbbbbbbb-1111-2222-3333-cccccccccccc True hhhhhhhh-7777-8888-9999-iiiiiiiiiiii Woodgrove Device Windows Server 10.0.20348.3091
Aktivieren oder Deaktivieren eines Microsoft Entra Geräts
Um ein Gerät zu aktivieren oder zu deaktivieren, verwenden Sie das Set-EntraDevice Cmdlet, und legen Sie die -AccountEnabled Eigenschaft auf true (aktivieren) oder false (deaktivieren) fest.
Von Bedeutung
- Sie müssen ein Intune-Administrator oder Cloudgeräteadministrator sein, um ein Gerät zu aktivieren oder zu deaktivieren.
- Durch das Deaktivieren eines Geräts wird verhindert, dass es über Microsoft Entra ID authentifiziert wird, auf Ressourcen zugreift, die durch gerätebasierten bedingten Zugriff geschützt sind und Windows Hello for Business Anmeldeinformationen verwenden.
- Durch das Deaktivieren eines Geräts werden sowohl das primäre Aktualisierungstoken (Primary Refresh Token, PRT) als auch etwaige Aktualisierungstoken (Refresh Tokens, RT) auf dem Gerät widerrufen.
- Drucker können in Microsoft Entra ID nicht aktiviert oder deaktiviert werden.
Führen Sie zum Aktivieren eines Geräts das folgende Cmdlet aus:
Connect-Entra -Scopes 'Device.ReadWrite.All'
Set-EntraDevice -ObjectId 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb' -AccountEnabled $true
Löschen eines Microsoft Entra-Geräts
Um eine saubere und sichere Umgebung aufrechtzuerhalten, löschen Sie Geräte, die nicht mehr verwendet werden. Wenn ein Gerät von einem anderen System verwaltet wird, z. B. Microsoft Intune, stellen Sie sicher, dass Sie es zurücksetzen oder zurückziehen, bevor Sie es löschen. Informieren Sie sich über das Verwalten veralteter Geräte, bevor Sie ein Gerät löschen.
Von Bedeutung
- Sie müssen ein Cloudgeräteadministrator, Intune-Administrator oder Windows 365 Administrator sein, um ein Gerät zu löschen.
- Drucker können nicht gelöscht werden, bevor sie aus Universelles Drucken gelöscht werden.
- Windows Autopilot Geräte können nicht gelöscht werden, bevor sie aus Intune gelöscht werden.
- Das Löschen eines Geräts:
- Verhindert, dass über das Gerät auf Ihre Microsoft Entra-Ressourcen zugegriffen wird.
- Entfernt alle Details, die an das Gerät angefügt sind, z. B. BitLocker-Schlüssel für Windows Geräte.
- ist eine nicht wiederherstellbare Aktivität Wir empfehlen es nicht, es sei denn, es ist erforderlich.
Connect-Entra -Scopes 'Device.ReadWrite.All'
$Device = Get-EntraDevice -Filter "DisplayName eq 'Woodgrove Desktop'"
Remove-EntraDevice -ObjectId $Device.ObjectId
Geräte exportieren
Cloud Device-Administratoren und Intune-Administratoren können eine CSV-Datei mit einer Liste der Geräte exportieren. Sie können Filter anwenden, um die Liste der Geräte zu verfeinern. Wenn keine Filter angewendet werden, sind alle Geräte enthalten. Je nach Auswahl kann der Exportvorgang bis zu einer Stunde dauern. Wenn der Exportvorgang 1 Stunde überschreitet, schlägt er fehl, und es wird keine Datei ausgegeben.
Die exportierte Liste enthält die folgenden Geräteidentitätsattribute:
displayName,accountEnabled,operatingSystem,operatingSystemVersion,joinType (trustType),registeredOwners,userNames,mdmDisplayName,isCompliant,registrationTime,approximateLastSignInDateTime,deviceId,isManaged,objectId,profileType,systemLabels,model
Die folgenden Filter können für den Exportvorgang angewendet werden:
- Aktivierungszustand
- Konformitätszustand
- Join-Typ
- Aktivitätszeitstempel
- Betriebssystemtyp
- Gerätetyp
Alle Geräte exportieren
Verwenden Sie das folgende Cmdlet, um alle Geräte abzurufen und die Daten in einer CSV-Datei zu speichern:
Get-EntraDevice -All `
| Select-Object -Property AccountEnabled, DeviceId, OperatingSystem, OperatingSystemVersion, DisplayName, TrustType, ApproximateLastSignInDateTime `
| Export-Csv "$env:UserProfile\Downloads\deviceList.csv" -NoTypeInformation
Stellen Sie sicher, dass Sie $env:UserProfile durch den Pfad ersetzen, unter dem Sie die Datei entsprechend Ihrer Umgebung speichern möchten. In diesem Beispiel wird die CSV-Datei direkt im Ordner "Downloads" gespeichert.
Verwandte Inhalte
[Veraltete Geräte verwalten][stale-devices]