Get-EntraUserRegisteredDevice
Obtenir les appareils inscrits par un utilisateur.
Syntaxe
Default (Par défaut)
Get-EntraUserRegisteredDevice
-UserId <String>
[-All]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
Description
L’applet Get-EntraUserRegisteredDevice de commande obtient les appareils inscrits par un utilisateur dans Microsoft Entra ID.
Exemples
Exemple 1 : Obtenir des appareils inscrits
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
Cette commande obtient les appareils inscrits auprès de l’utilisateur spécifié.
Exemple 2 : Obtenir tous les appareils inscrits
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
Cette commande obtient tous les appareils inscrits auprès de l’utilisateur spécifié.
Exemple 3 : Obtenir un appareil inscrit
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
Cette commande obtient le premier appareil inscrit à l’utilisateur spécifié. Vous pouvez utiliser -Limit comme alias pour -Top.
Paramètres
-All
Répertorier toutes les pages.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Property
Spécifie les propriétés à retourner
Propriétés du paramètre
| Type: | System.String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Sélectionnez |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Top
Spécifie le nombre maximal d’enregistrements à retourner.
Propriétés du paramètre
| Type: | System.Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Limite |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-UserId
Spécifie l’ID d’un utilisateur (en tant que nom d’utilisateur principal ou UserId) dans Microsoft Entra ID.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Identifiant d'objet (ObjectId), UPN, Identité, Nom Principal de l'Utilisateur |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.