Share via

Get-MsolDevice

  • Reference
Modul:
MSOnline

Získá jednotlivá zařízení nebo seznam zařízení.

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

Rutina Get-MsolDevice získá jednotlivá zařízení nebo seznam zařízení.

Příklady

Příklad 1: Získání objektu zařízení

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

Tento příkaz získá objekt zařízení s názvem NIC0123.

Příklad 2: Získání seznamu objektů zařízení

PS C:\>Get-MsolDevice -All

Tento příkaz získá seznam objektů zařízení. Vzhledem k tomu , ReturnRegisteredOwners parametr není použit, objekt zařízení neobsahuje registeredOwners vlastnost.

Příklad 3: Získání seznamu objektů zařízení obsahujících vlastnost registeredOwners

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

Tento příkaz získá seznam objektů zařízení. Protože se používá parametr ReturnRegisteredOwners , objekt zařízení obsahuje vlastnost registeredOwners .

Příklad 4: Získání zařízení podle ID zařízení

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

Tento příkaz získá zařízení s odpovídajícím ID zařízení.

Příklad 5: Získání objektu zařízení podle ID objektu

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

Tento příkaz získá zařízení s odpovídajícím ID objektu.

Příklad 6: Získání zařízení zaregistrovaných podle hlavního názvu uživatele (UPN)

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

Tento příkaz získá všechna zařízení zaregistrovaná uživatelem s názvem pattifuller@contoso.comUPN .

Příklad 7: Získání zařízení podle časového razítka aktivity (přihlášení)

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

Příkaz Ths získá všechna zařízení s přibližným razítkem ApproximateLastLogonTimestamp před 1. lednem 2017.

Příklad 8: Získání zařízení a zahrnutí zařízení spravovaných systémem

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

Tento příkaz získá všechna zařízení a zahrnuje zařízení automatického pilotního nasazení a další zařízení, která se používají s Intune (např. EAS).

Parametry

-All

Označuje, že tato rutina vrátí všechny výsledky.

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

-DeviceId

Určuje ID zařízení, které tato rutina získá.

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

-IncludeSystemManagedDevices

Označuje, že tato rutina zahrnuje zařízení spravovaná systémem, jako je automatické pilotní nasazení.

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

-LogonTimeBefore

Zadané datum (UTC) použité k filtrování seznamu zařízení podle.

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

-Name

Určuje zobrazovaný název zařízení, které tato rutina získá.

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

-ObjectId

Určuje jedinečné ID objektu zařízení, které tato rutina získá.

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

-RegisteredOwnerUpn

Určuje objekt uživatele, který je registrovaným vlastníkem zařízení. Musíte zadat hlavní název uživatele (UPN) nebo ObjectId nebo předat instanci objektu Microsoft.Online.Administration.User , která obsahuje hlavní název uživatele (UPN) nebo ObjectId.

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

-ReturnRegisteredOwners

Označuje, že tato rutina vrátí vlastnost registeredOwners zařízení.

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

Výstupy

Microsoft.Online.Administration.Device

Tato rutina vrací objekty zařízení, které obsahují následující informace:

  • AccountEnabled: Stav zařízení: povoleno nebo zakázáno.
  • ObjectId: Jedinečné ID zařízení.
  • DeviceId: ID zařízení.
  • DisplayName: Zobrazovaný název zařízení.
  • DeviceObjectVersion: Číslo verze objektu zařízení.
  • DeviceOSType: Typ operačního systému zařízení.
  • DeviceOSVersion: Číslo verze operačního systému zařízení.
  • DeviceTrustType: Typ důvěryhodnosti zařízení. Hodnota může být jedna z následujících možností: Připojení k pracovišti, připojení k AzureAD, připojení k doméně.
  • DeviceTrustLevel: Úroveň důvěryhodnosti zařízení. Hodnota může být jedna z následujících možností: Ověřeno, Vyhovující, Spravované.
  • DevicePhysicalIds: Fyzické ID zařízení.
  • Přibližné razítkoLastLogonTimestamp: Poslední časové razítko přihlášení pomocí tohoto zařízení.
  • AlternativeSecurityIds: Alternativní ID zabezpečení zařízení.
  • DirSyncEnabled: Pokud je zařízení povolené pomocí nástroje DirSync.
  • LastDirSyncTime: Poslední časové razítko, které zařízení synchronizovalo, DirSync.
  • Registrované vlastníky: Registrovaný vlastník zařízení.
  • GraphDeviceObject: Objekt zařízení vrácený z rozhraní Graph API