Get-EntraUserRegisteredDevice

Moduł:
Microsoft.Entra.Users Module v1.3

Pobieranie urządzeń zarejestrowanych przez użytkownika.

Składnia

Default (domyślnie) 

Get-EntraUserRegisteredDevice

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

Opis

Polecenie Get-EntraUserRegisteredDevice cmdlet pobiera urządzenia zarejestrowane przez użytkownika w Microsoft Entra ID.

Przykłady

Przykład 1. Pobieranie zarejestrowanych urządzeń

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

To polecenie pobiera urządzenia zarejestrowane dla określonego użytkownika.

Przykład 2. Pobieranie wszystkich zarejestrowanych urządzeń

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

To polecenie pobiera wszystkie urządzenia zarejestrowane dla określonego użytkownika.

Przykład 3. Pobieranie jednego zarejestrowanego urządzenia

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

To polecenie pobiera pierwsze urządzenie zarejestrowane dla określonego użytkownika. Możesz użyć -Limit jako aliasu dla -Top.

Parametry

-All

Wyświetl listę wszystkich stron.

Właściwości parametru

Typ:System.Management.Automation.SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Property

Określa właściwości, które mają być zwracane

Właściwości parametru

Typ:

System.String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Select

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Top

Określa maksymalną liczbę rekordów do zwrócenia.

Właściwości parametru

Typ:System.Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Ograniczenie

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-UserId

Określa identyfikator użytkownika (jako główną nazwę użytkownika lub identyfikator użytkownika) w Microsoft Entra ID.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator Obiektu, nazwa UPN, Identity, NazwaGłównaUżytkownika

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.