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

Get-MsolDevice

  • Referencia
Modul:
MSOnline

Lekér egy eszközt vagy egy eszközlistá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ér egy eszközt a megfelelő eszközazonosítóval.

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ér egy eszközt a megfelelő objektumazonosítóval.

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 az összes olyan eszközt, amelyet a felhasználó regisztrált az egyszerű felhasználónévvel 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 lekéri az összes eszközt a ApproximateLastLogonTimestamp paranccsal 2017. január 1. előtt

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 automatikus próbaeszközöket és a Intune használt egyéb eszközöket (pl. EAS)

Paraméterek

-All

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

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

-DeviceId

Megadja a parancsmag által lekért eszközazonosítót.

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

-IncludeSystemManagedDevices

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

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

-LogonTimeBefore

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

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

-Name

Megadja a parancsmag által lekért eszköz megjelenítendő nevét.

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

-ObjectId

Megadja a parancsmag által lekért eszköz egyedi objektumazonosítóját.

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

-RegisteredOwnerUpn

Megadja azt a felhasználói objektumot, amely az eszköz regisztrált tulajdonosa. 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.

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

-ReturnRegisteredOwners

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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özmegbízhatóság típusa. Az érték a következők egyike lehet: Munkahelyhez csatlakoztatott, AzureAD-hez csatlakoztatott, tartományhoz csatlakoztatott.
  • DeviceTrustLevel: Az eszközmegbízhatósági szint. Az érték a következők egyike lehet: Hitelesített, Megfelelő, Felügyelt.
  • DevicePhysicalIds: Az eszköz fizikai azonosítója.
  • ApproximateLastLogonTimestamp: Az eszközt használó utolsó bejelentkezési időbélyeg.
  • 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 legutóbbi időbélyegzőjét a DirSync szinkronizálta.
  • RegisteredOwners: Az eszköz regisztrált tulajdonosa.
  • GraphDeviceObject: A Graph API által visszaadott eszközobjektum.