Freigeben über

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"

Mit diesem Befehl wird ein Geräteobjekt mit dem Namen NIC0123 abgerufen.

Beispiel 2: Abrufen einer Liste von Geräteobjekten

PS C:\>Get-MsolDevice -All

Mit diesem Befehl wird eine Liste der Geräteobjekte abgerufen. Da der ReturnRegisteredOwners-Parameter nicht verwendet wird, enthält das Geräteobjekt nicht die registeredOwners-Eigenschaft .

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

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

Mit diesem Befehl wird eine Liste der Geräteobjekte abgerufen. Da der ReturnRegisteredOwners-Parameter 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"

Mit diesem Befehl wird ein Gerät mit der entsprechenden Geräte-ID abgerufen.

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

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

Mit diesem Befehl wird ein Gerät mit der entsprechenden Objekt-ID abgerufen.

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

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

Mit diesem Befehl werden alle Geräte abgerufen, die vom Benutzer mit dem UPN namens pattifuller@contoso.comregistriert 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 systemseitig verwalteten Geräten

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

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

Parameter

-All

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceId

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

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-IncludeSystemManagedDevices

Gibt an, dass dieses Cmdlet Geräte umfasst, die vom System verwaltet werden, z. B. Autopilot.

Typ:SwitchParamater
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LogonTimeBefore

Gibt das Datum (UTC) an, nach dem die Geräteliste gefiltert wird.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ObjectId

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

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ReturnRegisteredOwners

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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ätevertrauenstyp. Der Wert kann einer der folgenden sein: Workplace Join, AzureAD Join, Domain Join.
  • DeviceTrustLevel: Die Gerätevertrauensstufe. Der Wert kann einer der folgenden Sein: Authentifiziert, Konform, Verwaltet.
  • DevicePhysicalIds: Die physischen Geräte-IDs.
  • ApproximateLastLogonTimestamp: Der letzte Anmeldezeitstempel mit diesem Gerät.
  • AlternativeSecurityIds: Die alternativen Gerätesicherheits-IDs.
  • DirSyncEnabled: Wenn das Gerät mit DirSync aktiviert ist.
  • LastDirSyncTime: Der letzte Zeitstempel, den das Gerät mit DirSync synchronisiert hat.
  • RegisteredOwners: Der registrierte Besitzer des Geräts.
  • GraphDeviceObject: Das von der Graph-API zurückgegebene Geräteobjekt.