Megosztás a következőn keresztül:

Get-MsolDevice

  • Referencia
Modul:
MSOnline

Lekéri az egyes eszközöket vagy az eszközök listáját.

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

A Get-MsolDevice parancsmag lekéri az egyes eszközöket vagy az eszközök listáját.

Példák

1. példa: Eszközobjektum lekérése

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

Ez a parancs lekéri a NIC0123 nevű eszközobjektumot.

2. példa: Eszközobjektumok listájának lekérése

PS C:\>Get-MsolDevice -All

Ez a parancs lekéri az eszközobjektumok listáját. Mivel a ReturnRegisteredOwners paraméter nincs használatban, az eszközobjektum nem tartalmazza a regisztráltOwners tulajdonságot.

3. példa: A regisztráltOwners tulajdonságot tartalmazó eszközobjektumok listájának lekérése

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

Ez a parancs lekéri az eszközobjektumok listáját. Mivel a ReturnRegisteredOwners paramétert használja, az eszközobjektum tartalmazza a regisztráltOwners tulajdonságot.

4. példa: Eszköz lekérése eszközazonosító alapján

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

Ez a parancs lekéri a megfelelő eszközazonosítóval rendelkező eszközt.

5. példa: Eszközobjektum lekérése objektumazonosító alapján

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

Ez a parancs lekéri a megfelelő objektumazonosítóval rendelkező eszközt.

6. példa: Az UPN által regisztrált eszközök lekérése

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

Ez a parancs lekéri a felhasználó által regisztrált összes eszközt a nevű UPN-nel pattifuller@contoso.com.

7. példa: Eszköz lekérése tevékenység (bejelentkezési) időbélyeg alapján

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

A Ths parancs 2017. január 1.előtt lekéri az összes eszközt a ApproximateLastLogonTimestamp paranccsal

8. példa: Eszközök lekérése és a rendszer által felügyelt eszközök belefoglalása

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

Ez a parancs lekéri az összes eszközt, és magában foglalja az Intune-nal használt automatikus próbaeszközöket és egyéb eszközöket (pl. EAS)

Paraméterek

-All

Azt jelzi, hogy ez a parancsmag az összes eredményt visszaadja.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DeviceId

Megadja annak az eszköznek az eszközazonosítóját, amelyet a parancsmag lekéri.

Típus:Guid
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-IncludeSystemManagedDevices

Azt jelzi, hogy ez a parancsmag olyan eszközöket tartalmaz, amelyeket a rendszer felügyel, például az automatikus próbaüzemet.

Típus:SwitchParamater
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-LogonTimeBefore

Megadva az eszközlista szűréséhez használt dátumot (UTC).

Típus:DateTime
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Name

Megadja annak az eszköznek a megjelenítendő nevét, amelyet a parancsmag lekéri.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ObjectId

Megadja annak az eszköznek az egyedi objektumazonosítóját, amelyet a parancsmag lekéri.

Típus:Guid
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-RegisteredOwnerUpn

Az eszköz regisztrált tulajdonosaként megadott felhasználói objektumot adja meg. Meg kell adnia az egyszerű felhasználónevet (UPN) vagy az ObjectId azonosítót, vagy át kell adnia egy Microsoft.Online.Administration.User objektum egy példányát, amely a felhasználó UPN-jét vagy ObjectId azonosítóját tartalmazza.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ReturnRegisteredOwners

Azt jelzi, hogy ez a parancsmag az eszköz regisztráltOwners tulajdonságát adja vissza.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Kimenetek

Microsoft.Online.Administration.Device

Ez a parancsmag eszközobjektumokat ad vissza, amelyek a következő információkat tartalmazzák:

  • AccountEnabled: Az eszköz állapota: engedélyezve vagy letiltva.
  • ObjectId: Az eszköz egyedi azonosítója.
  • DeviceId: Az eszköz eszközazonosítója.
  • DisplayName: Az eszköz megjelenítendő neve.
  • DeviceObjectVersion: Az eszköz objektumverziószáma.
  • DeviceOSType: Az eszköz operációs rendszerének típusa.
  • DeviceOSVersion: Az eszköz operációs rendszerének verziószáma.
  • DeviceTrustType: Az eszköz megbízhatósági típusa. Az érték a következők egyike lehet: Munkahelyhez csatlakoztatott, AzureAD-hez csatlakoztatott, tartományhoz csatlakoztatott.
  • DeviceTrustLevel: Az eszköz megbízhatósági szintje. Az érték a következők egyike lehet: Hitelesített, megfelelő, felügyelt.
  • DevicePhysicalIds: Az eszköz fizikai azonosítói.
  • ApproximateLastLogonTimestamp: Az eszköz utolsó bejelentkezési időbélyege.
  • AlternativeSecurityIds: Az eszköz alternatív biztonsági azonosítói.
  • DirSyncEnabled: Ha az eszköz engedélyezve van a DirSync használatával.
  • LastDirSyncTime: Az eszköz utolsó időbélyegét a DirSync szinkronizálta.
  • RegisteredOwners: Az eszköz regisztrált tulajdonosa.
  • GraphDeviceObject: A graph API-ból visszaadott eszközobjektum.