Get-MsolDevice

  • Referentie
Module:
MSOnline

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

Syntax

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

De Cmdlet Get-MsolDevice haalt 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 met de naam NIC0123 opgehaald.

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 de eigenschap RegisteredOwners niet.

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 ophaalt.

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 registreren 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: Apparaat ophalen op activiteit (aanmeldingstijdstempel)

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

De opdracht Ths haalt alle apparaten op met de ApproximateLastLogonTimestamp vóór 1 januari 2017

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

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

Met deze opdracht worden alle apparaten opgestuurd en worden apparaten met automatische testfase en andere apparaten die worden gebruikt met Intune (bijvoorbeeld EAS)

Parameters

-All

Geeft aan dat met deze cmdlet alle resultaten worden geretourneerd.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DeviceId

Hiermee geeft u de apparaat-id op van het apparaat dat door deze cmdlet wordt ophaalt.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-IncludeSystemManagedDevices

Geeft aan dat deze cmdlet apparaten bevat die worden beheerd door het systeem, zoals automatisch testen.

Type:SwitchParamater
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LogonTimeBefore

De datum (UTC) opgegeven waarop de lijst met apparaten wordt gefilterd.

Type:DateTime
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReturnRegisteredOwners

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 objectversienummer van het apparaat.
  • DeviceOSType: het type besturingssysteem van het apparaat.
  • DeviceOSVersion: het versienummer van het besturingssysteem van het apparaat.
  • DeviceTrustType: het type apparaatvertrouwensrelatie. 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 laatste tijdstempel voor 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 van het apparaat is gesynchroniseerd door DirSync.
  • RegisteredOwners: de geregistreerde eigenaar van het apparaat.
  • GraphDeviceObject: Het apparaatobject dat is geretourneerd vanuit graph API.