Get-EntraUserRegisteredDevice
Ruft Geräte ab, die von einem Benutzer registriert wurden.
Syntax
Default (Standard)
Get-EntraUserRegisteredDevice
-UserId <String>
[-All]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
Beschreibung
Das Get-EntraUserRegisteredDevice Cmdlet ruft Geräte ab, die von einem Benutzer in Microsoft Entra ID registriert wurden.
Beispiele
Beispiel 1: Abrufen registrierter Geräte
Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserRegisteredDevice -UserId 'SawyerM@contoso.com' | Select-Object Id -ExpandProperty AdditionalProperties
@odata.type : #microsoft.graph.device
accountEnabled : True
approximateLastSignInDateTime : 1/6/2025 9:01:45 AM
createdDateTime : 11/13/2024 5:11:46 AM
deviceCategory : Digital IT Owned Device
deviceId : 00aa00aa-bb11-cc22-dd33-44ee44ee44ee
deviceOwnership : Company
deviceVersion : 2
displayName : Digital-IT-DevBox
enrollmentType : AzureDomainJoined
isCompliant : False
isManaged : True
isRooted : False
managementType : MDM
manufacturer : Microsoft Corporation
mdmAppId : XXXXX-0000-0000-c000-000000000000
model : Surface Pro X
operatingSystem : Windows
operatingSystemVersion : 10.0.22631.4460
physicalIds : {[USER-GID]:xxxxxxxx}
profileType : RegisteredDevice
registrationDateTime : 11/13/2024 5:11:44 AM
systemLabels : {}
trustType : AzureAd
extensionAttributes :
alternativeSecurityIds : {@{type=2; key=WAA1}}
Id : 11bb11bb-cc22-dd33-ee44-55ff55ff55ff
Dieser Befehl ruft die Geräte ab, die für den angegebenen Benutzer registriert sind.
Beispiel 2: Abrufen aller registrierten Geräte
Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserRegisteredDevice -UserId 'SawyerM@contoso.com' -All | Select-Object Id -ExpandProperty AdditionalProperties
@odata.type : #microsoft.graph.device
accountEnabled : True
approximateLastSignInDateTime : 1/6/2025 9:01:45 AM
createdDateTime : 11/13/2024 5:11:46 AM
deviceCategory : Digital IT Owned Device
deviceId : 00aa00aa-bb11-cc22-dd33-44ee44ee44ee
deviceOwnership : Company
deviceVersion : 2
displayName : Digital-IT-DevBox
enrollmentType : AzureDomainJoined
isCompliant : False
isManaged : True
isRooted : False
managementType : MDM
manufacturer : Microsoft Corporation
mdmAppId : XXXXX-0000-0000-c000-000000000000
model : Surface Pro X
operatingSystem : Windows
operatingSystemVersion : 10.0.22631.4460
physicalIds : {[USER-GID]:xxxxxxxx}
profileType : RegisteredDevice
registrationDateTime : 11/13/2024 5:11:44 AM
systemLabels : {}
trustType : AzureAd
extensionAttributes :
alternativeSecurityIds : {@{type=2; key=WAA1}}
Id : 11bb11bb-cc22-dd33-ee44-55ff55ff55ff
Dieser Befehl ruft alle Geräte ab, die für den angegebenen Benutzer registriert sind.
Beispiel 3: Abrufen eines registrierten Geräts
Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserRegisteredDevice -UserId 'SawyerM@contoso.com' -Top 1 | Select-Object Id -ExpandProperty AdditionalProperties
@odata.type : #microsoft.graph.device
accountEnabled : True
approximateLastSignInDateTime : 1/6/2025 9:01:45 AM
createdDateTime : 11/13/2024 5:11:46 AM
deviceCategory : Digital IT Owned Device
deviceId : 00aa00aa-bb11-cc22-dd33-44ee44ee44ee
deviceOwnership : Company
deviceVersion : 2
displayName : Digital-IT-DevBox
enrollmentType : AzureDomainJoined
isCompliant : False
isManaged : True
isRooted : False
managementType : MDM
manufacturer : Microsoft Corporation
mdmAppId : XXXXX-0000-0000-c000-000000000000
model : Surface Pro X
operatingSystem : Windows
operatingSystemVersion : 10.0.22631.4460
physicalIds : {[USER-GID]:xxxxxxxx}
profileType : RegisteredDevice
registrationDateTime : 11/13/2024 5:11:44 AM
systemLabels : {}
trustType : AzureAd
extensionAttributes :
alternativeSecurityIds : {@{type=2; key=WAA1}}
Id : 11bb11bb-cc22-dd33-ee44-55ff55ff55ff
Dieser Befehl ruft das oberste Gerät ab, das für den angegebenen Benutzer registriert ist. Sie können -Limit als Alias für -Top verwenden.
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 |
-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 |
-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
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-UserId
Gibt die ID eines Benutzers (als Benutzerprinzipalname oder Benutzer-ID) in Microsoft Entra ID an.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Objekt-ID, UPN (Benutzerprinzipalname), Identity, Benutzerhauptname |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | True |
| 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.