Udostępnij za pośrednictwem

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ń zawierających 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 za pomocą nazwy 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'

Polecenie Ths pobiera wszystkie urządzenia za pomocą parametru 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 obejmuje urządzenia z automatycznym pilotowaniem oraz inne urządzenia używane w usłudze Intune (np. EAS)

Parametry

-All

Wskazuje, że to polecenie cmdlet zwraca wszystkie wyniki.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DeviceId

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

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-IncludeSystemManagedDevices

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

Typ:SwitchParamater
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LogonTimeBefore

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

Typ:DateTime
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ObjectId

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

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RegisteredOwnerUpn

Określa obiekt użytkownika, który jest zarejestrowanym właścicielem urządzenia. Należy 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.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ReturnRegisteredOwners

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

Microsoft.Online.Administration.Device

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

  • AccountEnabled: stan urządzenia: włączony lub wyłączony.
  • 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. Wartość może być jedną 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.
  • Zarejestrowani właściciele: zarejestrowany właściciel urządzenia.
  • GraphDeviceObject: obiekt urządzenia zwrócony z interfejsu API grafu.