Get-EntraUserRegisteredDevice

Ottenere i dispositivi registrati da un utente.

Sintassi

Default (Impostazione predefinita)

Get-EntraUserRegisteredDevice

    -UserId <String>
    [-All]
    [-Top <Int32>]
    [-Property <String[]>]
    [<CommonParameters>]

Descrizione

Il Get-EntraUserRegisteredDevice cmdlet ottiene i dispositivi registrati da un utente in Microsoft Entra ID.

Esempio

Esempio 1: Ottenere i dispositivi registrati

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

Questo comando ottiene i dispositivi registrati all'utente specificato.

Esempio 2: Ottenere tutti i dispositivi registrati

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

Questo comando ottiene tutti i dispositivi registrati all'utente specificato.

Esempio 3: Ottenere un dispositivo registrato

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

Questo comando ottiene il primo dispositivo registrato all'utente specificato. È possibile usare -Limit come alias per -Top.

Parametri

-All

Elencare tutte le pagine.

Proprietà dei parametri

Tipo:System.Management.Automation.SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Property

Specifica le proprietà da restituire

Proprietà dei parametri

Tipo:

System.String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Select

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Top

Specifica il numero massimo di record da restituire.

Proprietà dei parametri

Tipo:System.Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Limit

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-UserId

Specifica l'ID di un utente (come nome dell'entità utente o UserId) in Microsoft Entra ID.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ObjectId, UPN, Identità, NomePrincipaleUtente

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.