다음을 통해 공유

Get-MsolDevice

  • 참조
모듈:
MSOnline

개별 디바이스 또는 디바이스 목록을 가져옵니다.

구문

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은 개별 디바이스 또는 디바이스 목록을 가져옵니다.

예제

예제 1: 디바이스 개체 가져오기

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

이 명령은 이름이 NIC0123 디바이스 개체를 가져옵니다.

예제 2: 디바이스 개체 목록 가져오기

PS C:\>Get-MsolDevice -All

이 명령은 디바이스 개체 목록을 가져옵니다. ReturnRegisteredOwners 매개 변수는 사용되지 않으므로 디바이스 개체에 registeredOwners 속성이 포함되어 있지 않습니다.

예제 3: registeredOwners 속성이 포함된 디바이스 개체 목록 가져오기

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

이 명령은 디바이스 개체 목록을 가져옵니다. ReturnRegisteredOwners 매개 변수가 사용되므로 디바이스 개체에는 registeredOwners 속성이 포함됩니다.

예제 4: 디바이스 ID로 디바이스 가져오기

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

이 명령은 해당 디바이스 ID가 있는 디바이스를 가져옵니다.

예제 5: 개체 ID로 디바이스 개체 가져오기

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

이 명령은 해당 개체 ID가 있는 디바이스를 가져옵니다.

예제 6: UPN에서 등록된 디바이스 가져오기

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

이 명령은 라는 pattifuller@contoso.comUPN을 사용하여 사용자가 등록한 모든 디바이스를 가져옵니다.

예제 7: 활동별 디바이스 가져오기(로그온) 타임스탬프

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

Ths 명령은 2017년 1월 1일 이전에 ApproximateLastLogonTimestamp를 사용하여 모든 디바이스를 가져옵니다.

예제 8: 디바이스 가져오기 및 시스템 관리 디바이스 포함

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

이 명령은 모든 디바이스를 가져오고 자동 파일럿 디바이스 및 Intune에서 사용되는 기타 디바이스(예: EAS)를 포함합니다.

매개 변수

-All

이 cmdlet이 모든 결과를 반환한다는 것을 나타냅니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DeviceId

이 cmdlet이 가져오는 디바이스의 디바이스 ID를 지정합니다.

형식:Guid
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-IncludeSystemManagedDevices

이 cmdlet에는 자동 파일럿과 같이 시스템에서 관리하는 디바이스가 포함되어 있음을 나타냅니다.

형식:SwitchParamater
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-LogonTimeBefore

디바이스 목록을 필터링하는 데 사용되는 날짜(UTC)를 지정했습니다.

형식:DateTime
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

이 cmdlet이 가져오는 디바이스의 표시 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ObjectId

이 cmdlet이 가져오는 디바이스의 고유 개체 ID를 지정합니다.

형식:Guid
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-RegisteredOwnerUpn

디바이스의 등록된 소유자인 사용자 개체를 지정합니다. UPN(사용자 계정 이름) 또는 ObjectId를 제공하거나 사용자의 UPN 또는 ObjectId가 포함된 Microsoft.Online.Administration.User 개체의 인스턴스를 전달해야 합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ReturnRegisteredOwners

이 cmdlet이 디바이스의 registeredOwners 속성을 반환한다는 것을 나타냅니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

출력

Microsoft.Online.Administration.Device

이 cmdlet은 다음 정보를 포함하는 디바이스 개체를 반환합니다.

  • AccountEnabled: 디바이스의 상태: 사용 또는 사용 안 함.
  • ObjectId: 디바이스의 고유 ID입니다.
  • DeviceId: 디바이스의 디바이스 ID입니다.
  • DisplayName: 디바이스의 표시 이름입니다.
  • DeviceObjectVersion: 디바이스의 개체 버전 번호입니다.
  • DeviceOSType: 디바이스 운영 체제 유형입니다.
  • DeviceOSVersion: 디바이스 운영 체제 버전 번호입니다.
  • DeviceTrustType: 디바이스 신뢰 유형입니다. 값은 Workplace Joined, AzureAD Joined, Domain Joined 중 하나일 수 있습니다.
  • DeviceTrustLevel: 디바이스 신뢰 수준입니다. 값은 인증됨, 규격, 관리 중 하나일 수 있습니다.
  • DevicePhysicalIds: 디바이스 물리적 ID입니다.
  • ApproximateLastLogonTimestamp: 이 디바이스를 사용하는 마지막 로그온 타임스탬프입니다.
  • AlternativeSecurityIds: 디바이스 대체 보안 ID입니다.
  • DirSyncEnabled: DirSync를 사용하여 디바이스를 사용하도록 설정한 경우
  • LastDirSyncTime: DirSync에서 디바이스를 동기화한 마지막 타임스탬프입니다.
  • RegisteredOwners: 디바이스의 등록된 소유자입니다.
  • GraphDeviceObject: 그래프 API에서 반환된 디바이스 개체입니다.