Sdílet prostřednictvím

Get-MsolDevice

  • Reference
Modul:
MSOnline

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

Syntaxe

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 vlastnost registeredOwners .

Příklad 3: Získání seznamu objektů zařízení, který obsahuje vlastnost registeredOwners

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

Tento příkaz získá seznam objektů zařízení. Vzhledem k tomu, že se používá parametr ReturnRegisteredOwners , obsahuje objekt zařízení 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 načte 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 načte všechna zařízení zaregistrovaná uživatelem s hlavním názvem uživatele (UPN) s názvem pattifuller@contoso.com.

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

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

Příkaz načte všechna zařízení s datem 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 načte 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 vrací všechny výsledky.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DeviceId

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

Typ:Guid
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-IncludeSystemManagedDevices

Označuje, že tato rutina zahrnuje zařízení spravovaná systémem, jako je například automatický pilot.

Typ:SwitchParamater
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LogonTimeBefore

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

Typ:DateTime
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

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

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ObjectId

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

Typ:Guid
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ReturnRegisteredOwners

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Výstupy

Microsoft.Online.Administration.Device

Tato rutina vrátí 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: Workplace Join (Připojeno k pracovišti), AzureAD Join (Připojené k doméně), Domain Join (Připojené k doméně).
  • DeviceTrustLevel: Úroveň důvěryhodnosti zařízení. Hodnota může být jedna z následujících: Authenticated (Ověřeno), Compliant (Vyhovující předpisům), Managed (Spravované).
  • DevicePhysicalIds: Fyzická ID zařízení.
  • ApproximateLastLogonTimestamp: Časové razítko posledního přihlášení pomocí tohoto zařízení.
  • AlternativeSecurityIds: Alternativní ID zabezpečení zařízení.
  • DirSyncEnabled: Pokud je v zařízení povolený nástroj DirSync.
  • LastDirSyncTime: Časové razítko poslední synchronizace zařízení nástrojem DirSync.
  • RegisteredOwners: Registrovaný vlastník zařízení.
  • GraphDeviceObject: Objekt zařízení vrácený z rozhraní Graph API.