Get-MsolDevice

  • Referens
Modul:
MSOnline

Hämtar en enskild enhet eller en lista över enheter.

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

Cmdleten Get-MsolDevice hämtar en enskild enhet eller en lista över enheter.

Exempel

Exempel 1: Hämta ett enhetsobjekt

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

Det här kommandot hämtar ett enhetsobjekt med namnet NIC0123.

Exempel 2: Hämta en lista över enhetsobjekt

PS C:\>Get-MsolDevice -All

Det här kommandot hämtar en lista över enhetsobjekt. Eftersom parametern ReturnRegisteredOwners inte används innehåller enhetsobjektet inte egenskapen registeredOwners .

Exempel 3: Hämta en lista över enhetsobjekt som innehåller egenskapen registeredOwners

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

Det här kommandot hämtar en lista över enhetsobjekt. Eftersom parametern ReturnRegisteredOwners används innehåller enhetsobjektet egenskapen registeredOwners .

Exempel 4: Hämta en enhet efter enhets-ID

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

Det här kommandot hämtar en enhet med motsvarande enhets-ID.

Exempel 5: Hämta ett enhetsobjekt efter objekt-ID

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

Det här kommandot hämtar en enhet med motsvarande objekt-ID.

Exempel 6: Hämta enheter som registrerats av UPN

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

Det här kommandot hämtar alla enheter som registrerats av användaren med UPN:et med namnet pattifuller@contoso.com.

Exempel 7: Hämta tidsstämpel för enhet efter aktivitet (inloggning)

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

Kommandot hämtar alla enheter med ApproximateLastLogonTimestamp före den 1 januari 2017

Exempel 8: Hämta enheter och inkludera systemhanterade enheter

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

Det här kommandot hämtar alla enheter och inkluderar automatiska pilotenheter och andra enheter som används med Intune (t.ex. EAS)

Parametrar

-All

Anger att denna cmdlet returnerar alla resultat.

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

-DeviceId

Anger enhetens enhets-ID som den här cmdleten hämtar.

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

-IncludeSystemManagedDevices

Anger att denna cmdlet innehåller enheter som hanteras av systemet, till exempel autopilot.

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

-LogonTimeBefore

Angav det datum (UTC) som används för att filtrera enhetslistan efter.

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

-Name

Anger visningsnamnet för den enhet som denna cmdlet hämtar.

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

-ObjectId

Anger det unika objekt-ID:t för enheten som den här cmdleten hämtar.

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

-RegisteredOwnerUpn

Anger det användarobjekt som är enhetens registrerade ägare. Du måste ange användarens huvudnamn (UPN) eller ObjectId, eller skicka en instans av ett Microsoft.Online.Administration.User-objekt som innehåller användarens UPN eller ObjectId.

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

-ReturnRegisteredOwners

Anger att denna cmdlet returnerar enhetens egenskap registeredOwners .

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

Utdata

Microsoft.Online.Administration.Device

Den här cmdleten returnerar enhetsobjekt som innehåller följande information:

  • AccountEnabled: Enhetens status: aktiverad eller inaktiverad.
  • ObjectId: Enhetens unika ID.
  • DeviceId: Enhetens enhets-ID.
  • DisplayName: Enhetens visningsnamn.
  • DeviceObjectVersion: Enhetens objektversionsnummer.
  • DeviceOSType: Enhetens operativsystemtyp.
  • DeviceOSVersion: Enhetens versionsnummer för operativsystemet.
  • DeviceTrustType: Enhetens förtroendetyp. Värdet kan vara något av följande: Arbetsplatsansluten, AzureAD-ansluten, Domänansluten.
  • DeviceTrustLevel: Enhetens förtroendenivå. Värdet kan vara något av följande: Autentiserad, Kompatibel, Hanterad.
  • DevicePhysicalIds: Enhetens fysiska ID:n.
  • ApproximateLastLogonTimestamp: Den senaste tidsstämpeln för inloggning med den här enheten.
  • AlternativeSecurityIds: Enhetens alternativa säkerhets-ID:n.
  • DirSyncEnabled: Om enheten är aktiverad med DirSync.
  • LastDirSyncTime: Den senaste tidsstämpeln som enheten synkroniserades av DirSync.
  • RegisteredOwners: Enhetens registrerade ägare.
  • GraphDeviceObject: Enhetsobjektet som returneras från Graph API.