Aracılığıyla paylaş

Get-MsolDevice

  • Başvuru
Modül:
MSOnline

Tek bir cihazı veya cihaz listesini alır.

Sözdizimi

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

Get-MsolDevice cmdlet'i tek bir cihazı veya cihaz listesini alır.

Örnekler

Örnek 1: Cihaz nesnesi alma

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

Bu komut, NIC0123 adlı bir cihaz nesnesi alır.

Örnek 2: Cihaz nesnelerinin listesini alma

PS C:\>Get-MsolDevice -All

Bu komut, cihaz nesnelerinin listesini alır. ReturnRegisteredOwners parametresi kullanılmadığından, cihaz nesnesi registeredOwners özelliğini içermez.

Örnek 3: registeredOwners özelliğini içeren cihaz nesnelerinin listesini alma

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

Bu komut, cihaz nesnelerinin listesini alır. ReturnRegisteredOwners parametresi kullanıldığından, cihaz nesnesi registeredOwners özelliğini içerir.

Örnek 4: Cihaz kimliğine göre cihaz alma

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

Bu komut, ilgili cihaz kimliğine sahip bir cihaz alır.

Örnek 5: Nesne kimliğine göre cihaz nesnesi alma

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

Bu komut, karşılık gelen nesne kimliğine sahip bir cihaz alır.

Örnek 6: UPN tarafından kaydedilen cihazları alma

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

Bu komut, adlı pattifuller@contoso.comUPN ile kullanıcı tarafından kaydedilen tüm cihazları alır.

Örnek 7: Cihazı etkinliğe (oturum açma) göre alma zaman damgası

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

Ths komutu 1 Ocak 2017'ye kadar ApproximateLastLogonTimestamp ile tüm cihazları alır

Örnek 8: Cihazları alma ve sistem tarafından yönetilen cihazları ekleme

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

Bu komut tüm cihazları alır ve Intune ile kullanılan otomatik pilot cihazları ve diğer cihazları içerir (örn. EAS)

Parametreler

-All

Bu cmdlet'in tüm sonuçları döndürdüğünü gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DeviceId

Bu cmdlet'in aldığı cihazın cihaz kimliğini belirtir.

Tür:Guid
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-IncludeSystemManagedDevices

Bu cmdlet'in otomatik pilot gibi sistem tarafından yönetilen cihazları içerdiğini gösterir.

Tür:SwitchParamater
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-LogonTimeBefore

Cihaz listesini filtrelemek için kullanılan tarih (UTC) belirtildi.

Tür:DateTime
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Name

Bu cmdlet'in aldığı cihazın görünen adını belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ObjectId

Bu cmdlet'in aldığı cihazın benzersiz nesne kimliğini belirtir.

Tür:Guid
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-RegisteredOwnerUpn

Cihazın kayıtlı sahibi olan kullanıcı nesnesini belirtir. Kullanıcı asıl adını (UPN) veya ObjectId değerini sağlamanız ya da kullanıcının UPN veya ObjectId değerini içeren bir Microsoft.Online.Administration.User nesnesinin örneğini geçirmeniz gerekir.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ReturnRegisteredOwners

Bu cmdlet'in cihazın registeredOwners özelliğini döndürdüğünü gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Çıkışlar

Microsoft.Online.Administration.Device

Bu cmdlet, aşağıdaki bilgileri içeren cihaz nesnelerini döndürür:

  • AccountEnabled: Cihazın durumu: etkin veya devre dışı.
  • ObjectId: Cihazın benzersiz kimliği.
  • DeviceId: Cihazın cihaz kimliği.
  • DisplayName: Cihazın görünen adı.
  • DeviceObjectVersion: Cihazın nesne sürüm numarası.
  • DeviceOSType: Cihaz işletim sistemi türü.
  • DeviceOSVersion: Cihaz işletim sistemi sürüm numarası.
  • DeviceTrustType: Cihaz güven türü. Değer aşağıdakilerden biri olabilir: Çalışma Alanına Katılmış, AzureAD'ye Katılmış, Etki Alanına Katılmış.
  • DeviceTrustLevel: Cihaz güven düzeyi. Değer aşağıdakilerden biri olabilir: Kimliği Doğrulanmış, Uyumlu, Yönetilen.
  • DevicePhysicalIds: Cihazın fiziksel kimlikleri.
  • ApproximateLastLogonTimestamp: Bu cihazı kullanan son oturum açma zaman damgası.
  • AlternativeSecurityIds: Cihaz alternatif güvenlik kimlikleri.
  • DirSyncEnabled: Cihazın DirSync ile etkinleştirilip etkinleştirilmediğini belirtir.
  • LastDirSyncTime: Cihazın DirSync tarafından eşitlenen son zaman damgası.
  • RegisteredOwners: Cihazın kayıtlı sahibi.
  • GraphDeviceObject: Graph API'sinden döndürülen cihaz nesnesi.