Get-EntraUserRegisteredDevice
Obtiene los dispositivos registrados por un usuario.
Sintaxis
Default (valor predeterminado)
Get-EntraUserRegisteredDevice
-UserId <String>
[-All]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
Description
El Get-EntraUserRegisteredDevice cmdlet obtiene los dispositivos registrados por un usuario en Microsoft Entra ID.
Ejemplos
Ejemplo 1: Obtener dispositivos registrados
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
Este comando obtiene los dispositivos registrados en el usuario especificado.
Ejemplo 2: Obtener todos los dispositivos registrados
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
Este comando obtiene todos los dispositivos registrados en el usuario especificado.
Ejemplo 3: Obtener un dispositivo registrado
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
Este comando obtiene el dispositivo superior que se registra en el usuario especificado. Puede usar -Limit como alias para -Top.
Parámetros
-All
Enumera todas las páginas.
Propiedades de parámetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Property
Especifica las propiedades que se van a devolver.
Propiedades de parámetro
| Tipo: | System.String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Select |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Top
Especifica el número máximo de registros que se van a devolver.
Propiedades de parámetro
| Tipo: | System.Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Limit |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-UserId
Especifica el identificador de un usuario (como nombre principal de usuario o UserId) en Microsoft Entra ID.
Propiedades de parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | ObjectId (identificador de objeto), UPN, Identity, NombrePrincipalDelUsuario |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.