Delen via

Get-MsolDevice

  • Referentie
Module:
MSOnline

Hiermee haalt u een afzonderlijk apparaat of een lijst met apparaten op.

Syntaxis

Get-MsolDevice
   -Name <String>
   [<CommonParameters>]
Get-MsolDevice
   [-All]
   [-ReturnRegisteredOwners]
   [<CommonParameters>]
Get-MsolDevice
   -DeviceId <Guid>
   [<CommonParameters>]
Get-MsolDevice
   -All
   -LogonTimeBefore <DateTime>
   [<CommonParameters>]
Get-MsolDevice
   -ObjectId <Guid>
   [<CommonParameters>]
Get-MsolDevice
   -RegisteredOwnerUpn <String>
   [<CommonParameters>]
Get-MsolDevice
   -All
   -IncludeSystemManagedDevices
   [<CommonParameters>]

Description

Met de cmdlet Get-MsolDevice haalt u een afzonderlijk apparaat of een lijst met apparaten op.

Voorbeelden

Voorbeeld 1: Een apparaatobject ophalen

PS C:\>Get-MsolDevice -Name "NIC0123"

Met deze opdracht wordt een apparaatobject opgehaald met de naam NIC0123.

Voorbeeld 2: Een lijst met apparaatobjecten ophalen

PS C:\>Get-MsolDevice -All

Met deze opdracht wordt een lijst met apparaatobjecten opgehaald. Omdat de parameter ReturnRegisteredOwners niet wordt gebruikt, bevat het apparaatobject niet de eigenschap registeredOwners .

Voorbeeld 3: Een lijst met apparaatobjecten ophalen die de eigenschap registeredOwners bevat

PS C:\>Get-MsolDevice -All -ReturnRegisteredOwners

Met deze opdracht wordt een lijst met apparaatobjecten opgehaald. Omdat de parameter ReturnRegisteredOwners wordt gebruikt, bevat het apparaatobject de eigenschap registeredOwners .

Voorbeeld 4: Een apparaat ophalen op apparaat-id

PS C:\>Get-MsolDevice -DeviceId "1aa200c4-bdfb-42b5-9a1e-5f1bafbe4274"

Met deze opdracht wordt een apparaat met de bijbehorende apparaat-id opgehaald.

Voorbeeld 5: Een apparaatobject ophalen op object-id

PS C:\>Get-MsolDevice -ObjectId "566F7EA7-7BF1-4F4A-AF23-A1B46DBD46D6"

Met deze opdracht wordt een apparaat met de bijbehorende object-id opgehaald.

Voorbeeld 6: Apparaten ophalen die zijn geregistreerd door UPN

PS C:\>Get-MsolDevice -RegisteredOwnerUpn "pattifuller@contoso.com"

Met deze opdracht worden alle apparaten opgehaald die door de gebruiker zijn geregistreerd met de UPN met de naam pattifuller@contoso.com.

Voorbeeld 7: Tijdstempel van apparaat ophalen op activiteit (aanmelding)

PS C:\>Get-MsolDevice -All -LogonTimeBefore 'January 1, 2017 12:00:00 AM'

Met de opdracht worden alle apparaten met de ApproximateLastLogonTimestamp vóór 1 januari 2017 opgeslagen

Voorbeeld 8: Apparaten ophalen en door het systeem beheerde apparaten opnemen

PS C:\>Get-MsolDevice -All -IncludeSystemManagedDevices

Met deze opdracht worden alle apparaten en automatisch testapparaten en andere apparaten die worden gebruikt met Intune (bijvoorbeeld EAS)

Parameters

-All

Geeft aan dat deze cmdlet alle resultaten retourneert.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DeviceId

Hiermee geeft u de apparaat-id op van het apparaat dat met deze cmdlet wordt opgehaald.

Type:Guid
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-IncludeSystemManagedDevices

Geeft aan dat deze cmdlet apparaten bevat die worden beheerd door het systeem, zoals auto-pilot.

Type:SwitchParamater
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LogonTimeBefore

De datum (UTC) opgegeven die wordt gebruikt om de lijst met apparaten te filteren.

Type:DateTime
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de weergavenaam op van het apparaat dat deze cmdlet ophaalt.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ObjectId

Hiermee geeft u de unieke object-id van het apparaat dat deze cmdlet ophaalt.

Type:Guid
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-RegisteredOwnerUpn

Hiermee geeft u het gebruikersobject op dat de geregistreerde eigenaar van het apparaat is. U moet de UPN (User Principal Name) of ObjectId opgeven of een exemplaar van een Microsoft.Online.Administration.User-object doorgeven dat de UPN of ObjectId van de gebruiker bevat.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ReturnRegisteredOwners

Geeft aan dat deze cmdlet de eigenschap registeredOwners van het apparaat retourneert.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

Microsoft.Online.Administration.Device

Deze cmdlet retourneert apparaatobjecten, waaronder de volgende informatie:

  • AccountEnabled: de status van het apparaat: ingeschakeld of uitgeschakeld.
  • ObjectId: de unieke id van het apparaat.
  • DeviceId: de apparaat-id van het apparaat.
  • DisplayName: de weergavenaam van het apparaat.
  • DeviceObjectVersion: het versienummer van het object van het apparaat.
  • DeviceOSType: het type besturingssysteem van het apparaat.
  • DeviceOSVersion: het versienummer van het besturingssysteem van het apparaat.
  • DeviceTrustType: het type apparaatvertrouwen. De waarde kan een van de volgende zijn: Workplace Joined, AzureAD Joined, Domain Joined.
  • DeviceTrustLevel: het vertrouwensniveau van het apparaat. De waarde kan een van de volgende zijn: Geverifieerd, Compatibel, Beheerd.
  • DevicePhysicalIds: de fysieke id's van het apparaat.
  • ApproximateLastLogonTimestamp: De tijdstempel van de laatste aanmelding met dit apparaat.
  • AlternativeSecurityIds: de alternatieve beveiligings-id's van het apparaat.
  • DirSyncEnabled: als het apparaat is ingeschakeld met DirSync.
  • LastDirSyncTime: de laatste tijdstempel dat het apparaat is gesynchroniseerd door DirSync.
  • RegisteredOwners: de geregistreerde eigenaar van het apparaat.
  • GraphDeviceObject: het apparaatobject dat is geretourneerd door graph API.