Get-MsolDevice

  • Referenz
Modul:
MSOnline

Ruft ein einzelnes Gerät oder eine Liste von Geräten ab.

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>]

Beschreibung

Das Cmdlet Get-MsolDevice ruft ein einzelnes Gerät oder eine Liste von Geräten ab.

Beispiele

Beispiel 1: Abrufen eines Geräteobjekts

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

Dieser Befehl ruft ein Geräteobjekt ab, das NIC0123 heißt.

Beispiel 2: Abrufen einer Liste von Geräteobjekten

PS C:\>Get-MsolDevice -All

Dieser Befehl ruft eine Liste der Geräteobjekte ab. Da der Parameter ReturnRegisteredOwners nicht verwendet wird, enthält das Geräteobjekt nicht die registeredOwners-Eigenschaft .

Beispiel 3: Abrufen einer Liste von Geräteobjekten, die die registeredOwners-Eigenschaft enthalten

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

Dieser Befehl ruft eine Liste der Geräteobjekte ab. Da der Parameter ReturnRegisteredOwners verwendet wird, enthält das Geräteobjekt die registeredOwners-Eigenschaft .

Beispiel 4: Abrufen eines Geräts nach Geräte-ID

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

Dieser Befehl ruft ein Gerät mit der entsprechenden Geräte-ID ab.

Beispiel 5: Abrufen eines Geräteobjekts nach Objekt-ID

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

Dieser Befehl ruft ein Gerät mit der entsprechenden Objekt-ID ab.

Beispiel 6: Abrufen von Geräten, die von UPN registriert wurden

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

Dieser Befehl ruft alle Geräte ab, die vom Benutzer mit dem UPN mit dem Namen " pattifuller@contoso.comUPN" registriert wurden.

Beispiel 7: Abrufen des Zeitstempels für Geräte nach Aktivität (Anmeldung)

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

Der Befehl "Ths" ruft alle Geräte mit dem ApproximateLastLogonTimestamp vor dem 1. Januar 2017 ab.

Beispiel 8: Abrufen von Geräten und Einschließen von vom System verwalteten Geräten

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

Dieser Befehl ruft alle Geräte ab und enthält Automatisch-Pilotgeräte und andere Geräte, die mit Intune (z. B. EAS) verwendet werden.

Parameter

-All

Gibt an, dass dieses Cmdlet alle Ergebnisse zurückgibt.

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

-DeviceId

Gibt die Geräte-ID des Geräts an, das dieses Cmdlet abruft.

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

-IncludeSystemManagedDevices

Gibt an, dass dieses Cmdlet Geräte enthält, die vom System verwaltet werden, z. B. autopilot.

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

-LogonTimeBefore

Gibt das Datum (UTC) an, das zum Filtern der Geräteliste verwendet wird.

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

-Name

Gibt den Anzeigenamen des Geräts an, das dieses Cmdlet abruft.

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

-ObjectId

Gibt die eindeutige Objekt-ID des Geräts an, das dieses Cmdlet abruft.

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

-RegisteredOwnerUpn

Gibt das Benutzerobjekt an, das der registrierte Besitzer des Geräts ist. Sie müssen den Benutzerprinzipalnamen (USER Principal Name, UPN) oder ObjectId angeben oder eine Instanz eines Microsoft.Online.Administration.User-Objekts übergeben, das den UPN oder ObjectId des Benutzers enthält.

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

-ReturnRegisteredOwners

Gibt an, dass dieses Cmdlet die registrierteOwners-Eigenschaft des Geräts zurückgibt.

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

Ausgaben

Microsoft.Online.Administration.Device

Dieses Cmdlet gibt Geräteobjekte zurück, die die folgenden Informationen enthalten:

  • AccountEnabled: Der Status des Geräts: aktiviert oder deaktiviert.
  • ObjectId: Die eindeutige ID des Geräts.
  • DeviceId: Die Geräte-ID des Geräts.
  • DisplayName: Der Anzeigename des Geräts.
  • DeviceObjectVersion: Die Objektversionsnummer des Geräts.
  • DeviceOSType: Der Gerätebetriebssystemtyp.
  • DeviceOSVersion: Die Versionsnummer des Gerätebetriebssystems.
  • DeviceTrustType: Der Gerätevertrauenswürdige Typ. Der Wert könnte eine der folgenden Sein: Workplace Join, AzureAD Join, Domain Join.
  • DeviceTrustLevel: Die Gerätevertrauenswürdigkeitsebene. Der Wert könnte eine der folgenden Sein: Authentifiziert, konform, verwaltet.
  • DevicePhysicalIds: Die physischen Geräte-IDs.
  • UngefährLastLogonTimestamp: Der letzte Anmeldezeitstempel mit diesem Gerät.
  • AlternativeSecurityIds: Die alternativen Sicherheits-IDs des Geräts.
  • DirSyncEnabled: Wenn das Gerät mit DirSync aktiviert ist.
  • LastDirSyncTime: Der letzte Zeitstempel des Geräts wurde von DirSync synchronisiert.
  • RegisteredOwners: Der registrierte Besitzer des Geräts.
  • GraphDeviceObject: Das von der Graph-API zurückgegebene Geräteobjekt.