Get-AzureADDevice
Active Directory에서 장치를 가져옵니다.
구문
GetQuery (기본값)
Get-AzureADDevice
[-All <Boolean>]
[-Top <Int32>]
[-Filter <String>]
[<CommonParameters>]
GetVague
Get-AzureADDevice
[-SearchString <String>]
[-All <Boolean>]
[<CommonParameters>]
GetById
Get-AzureADDevice
-ObjectId <String>
[-All <Boolean>]
[<CommonParameters>]
Description
Get-AzureADDevice cmdlet은 Azure AD(Active Directory)에서 디바이스를 가져옵니다.
예제
예제 1: ID로 기기 가져오기
PS C:\>Get-AzureADDevice -ObjectId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
ObjectId DeviceId DisplayName
-------- -------- -----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 48445467-033c-42ca-8e38-8d181db1d49c bastias_WindowsPhone_5/1/2016_12:53 PM
이 명령은 지정된 디바이스를 가져옵니다.
예제 2: 모든 장치 가져오기
PS C:\>Get-AzureADDevice
ObjectId DeviceId DisplayName
-------- -------- -----------
3cb87a8f-0a41-4ca8-8910-e56cc00114a3 48445467-033c-42ca-8e38-8d181db1d49c bastias_WindowsPhone_5/1/2016_12:53 PM
62aae804-8b1a-4ab7-8fda-5068aed1a1f7 3cb87a8f-0a41-4ca8-8910-e56cc00114a3 New Device
d4fe7726-5966-431c-b3b8-cddc8fdb717d 293872f6-c006-4e6a-8629-07847c5ab078 New Device
이 명령은 사용 가능한 모든 장치를 가져옵니다.
예제 3: 필터 기준을 사용하여 디바이스 가져오기
PS C:\>Get-AzureADDevice -Filter "startswith(DeviceOSType,'Windows')"
ObjectId DeviceId DisplayName
-------- -------- -----------
3cb87a8f-0a41-4ca8-8910-e56cc00114a3 48445467-033c-42ca-8e38-8d181db1d49c DESKTOP-ABC123YN
62aae804-8b1a-4ab7-8fda-5068aed1a1f7 3cb87a8f-0a41-4ca8-8910-e56cc00114a3 DESKTOP-DJF4463Y
d4fe7726-5966-431c-b3b8-cddc8fdb717d 293872f6-c006-4e6a-8629-07847c5ab078 DESKTOP-HXB4327H
예제 4: 이름으로 특정 장치 가져오기
PS C:\>Get-AzureADDevice -SearchString "DESKTOP-DJF4463Y"
ObjectId DeviceId DisplayName
-------- -------- -----------
62aae804-8b1a-4ab7-8fda-5068aed1a1f7 3cb87a8f-0a41-4ca8-8910-e56cc00114a3 DESKTOP-DJF4463Y
매개 변수
-All
true인 경우 모든 장치를 반환합니다. false인 경우 Top 매개 변수로 지정된 개체 수를 반환합니다
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Filter
oData v3.0 필터 문을 지정합니다. 이 매개변수는 반환되는 개체를 제어합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetQuery
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-ObjectId
Azure AD에서 디바이스의 ID를 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetById
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-SearchString
검색 문자열을 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetVague
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Top
반환할 최대 레코드 수를 지정합니다.
매개 변수 속성
| 형식: | Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetQuery
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
참고
Microsoft Graph PowerShell로의 Get-AzureADDevice에 대한 마이그레이션 가이드 를 참조하세요.