Get-MsolDevice

  • Odwołanie
Moduł:
MSOnline

Pobiera pojedyncze urządzenie lub listę urządzeń.

Składnia

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>]

Opis

Polecenie cmdlet Get-MsolDevice pobiera pojedyncze urządzenie lub listę urządzeń.

Przykłady

Przykład 1. Pobieranie obiektu urządzenia

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

To polecenie pobiera obiekt urządzenia o nazwie NIC0123.

Przykład 2. Pobieranie listy obiektów urządzeń

PS C:\>Get-MsolDevice -All

To polecenie pobiera listę obiektów urządzeń. Ponieważ parametr ReturnRegisteredOwners nie jest używany, obiekt urządzenia nie zawiera właściwości registeredOwners .

Przykład 3. Pobieranie listy obiektów urządzeń, które zawierają właściwość registeredOwners

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

To polecenie pobiera listę obiektów urządzeń. Ponieważ jest używany parametr ReturnRegisteredOwners , obiekt urządzenia zawiera właściwość registeredOwners .

Przykład 4. Pobieranie urządzenia według identyfikatora urządzenia

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

To polecenie pobiera urządzenie z odpowiednim identyfikatorem urządzenia.

Przykład 5. Pobieranie obiektu urządzenia według identyfikatora obiektu

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

To polecenie pobiera urządzenie z odpowiednim identyfikatorem obiektu.

Przykład 6: Pobieranie urządzeń zarejestrowanych przez nazwę UPN

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

To polecenie pobiera wszystkie urządzenia zarejestrowane przez użytkownika z nazwą UPN o nazwie pattifuller@contoso.com.

Przykład 7: sygnatura czasowa pobierania urządzenia według działania (logowania)

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

To polecenie pobiera wszystkie urządzenia z elementem ApproximateLastLogonTimestamp przed 1 stycznia 2017 r.

Przykład 8. Pobieranie urządzeń i dołączanie urządzeń zarządzanych przez system

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

To polecenie pobiera wszystkie urządzenia i zawiera urządzenia z automatycznym pilotażem oraz inne urządzenia, które są używane z Intune (np. EAS)

Parametry

-All

Wskazuje, że to polecenie cmdlet zwraca wszystkie wyniki.

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

-DeviceId

Określa identyfikator urządzenia, które otrzymuje to polecenie cmdlet.

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

-IncludeSystemManagedDevices

Wskazuje, że to polecenie cmdlet obejmuje urządzenia zarządzane przez system, takie jak automatyczne pilotaż.

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

-LogonTimeBefore

Określono datę (UTC) używaną do filtrowania listy urządzeń według.

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

-Name

Określa nazwę wyświetlaną urządzenia, które otrzymuje to polecenie cmdlet.

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

-ObjectId

Określa unikatowy identyfikator obiektu urządzenia, które otrzymuje to polecenie cmdlet.

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

-RegisteredOwnerUpn

Określa obiekt użytkownika, który jest zarejestrowanym właścicielem urządzenia. Musisz podać główną nazwę użytkownika (UPN) lub ObjectId albo przekazać wystąpienie obiektu Microsoft.Online.Administration.User zawierającego nazwę UPN użytkownika lub identyfikator ObjectId.

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

-ReturnRegisteredOwners

Wskazuje, że to polecenie cmdlet zwraca właściwość registeredOwners urządzenia.

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

Dane wyjściowe

Microsoft.Online.Administration.Device

To polecenie cmdlet zwraca obiekty urządzeń, które zawierają następujące informacje:

  • AccountEnabled: stan urządzenia: włączone lub wyłączone.
  • ObjectId: unikatowy identyfikator urządzenia.
  • DeviceId: identyfikator urządzenia.
  • DisplayName: nazwa wyświetlana urządzenia.
  • DeviceObjectVersion: numer wersji obiektu urządzenia.
  • DeviceOSType: typ systemu operacyjnego urządzenia.
  • DeviceOSVersion: numer wersji systemu operacyjnego urządzenia.
  • DeviceTrustType: typ zaufania urządzenia. Może to być jedna z następujących wartości: Przyłączone do miejsca pracy, Przyłączone do usługi AzureAD, Przyłączone do domeny.
  • DeviceTrustLevel: poziom zaufania urządzenia. Wartość może być jedną z następujących wartości: Uwierzytelnione, Zgodne, Zarządzane.
  • DevicePhysicalIds: identyfikatory fizyczne urządzenia.
  • ApproximateLastLogonTimestamp: znacznik czasu ostatniego logowania przy użyciu tego urządzenia.
  • AlternativeSecurityIds: alternatywne identyfikatory zabezpieczeń urządzenia.
  • DirSyncEnabled: jeśli urządzenie jest włączone za pomocą narzędzia DirSync.
  • LastDirSyncTime: ostatnia sygnatura czasowa urządzenia została zsynchronizowana przez narzędzie DirSync.
  • Zarejestrowane właściciele: zarejestrowany właściciel urządzenia.
  • GraphDeviceObject: obiekt urządzenia zwrócony z interfejsu API programu Graph.