Get-CMDevice

참조

모듈:: ConfigurationManager

Configuration Manager 디바이스를 가져옵니다.

구문

Get-CMDevice
   [-CollectionMember]
   [-Fast]
   [-Name <String>]
   [-Resource]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMDevice
   -Collection <IResultObject>
   [-CollectionMember]
   [-Fast]
   [-Name <String>]
   [-Resource]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMDevice
   -CollectionId <String>
   [-CollectionMember]
   [-Fast]
   [-Name <String>]
   [-Resource]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMDevice
   [-CollectionId <String>]
   [-CollectionMember]
   [-Fast]
   [-Resource]
   -ThreatId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMDevice
   [-CollectionId <String>]
   [-CollectionMember]
   [-Fast]
   [-Resource]
   -ThreatName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMDevice
   [-CollectionId <String>]
   [-CollectionMember]
   [-Fast]
   -InputObject <IResultObject>
   [-Resource]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMDevice
   [-CollectionMember]
   -CollectionName <String>
   [-Fast]
   [-Name <String>]
   [-Resource]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMDevice
   [-CollectionMember]
   [-Fast]
   [-Resource]
   -ResourceId <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Get-CMDevice cmdlet은 Configuration Manager 디바이스를 가져옵니다. 기본적으로 SMS_CM_RES_COLL_SMS00001 클래스를 쿼리합니다. Resource 또는 CollectionMember 매개 변수를 사용하여 쿼리 클래스를 변경할 수 있습니다. 사이트의 역할 기반 액세스에 따라 이러한 다른 매개 변수 중 하나를 사용해야 할 수 있습니다. 예를 들어 SMS00001 대한 액세스 권한이 없는 경우 기본적으로 이 cmdlet은 0개 결과를 반환합니다.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 컬렉션 ID로 디바이스 가져오기

이 명령은 XYZ0004B ID를 사용하여 디바이스 컬렉션의 모든 디바이스 개체를 가져옵니다. Select-Object cmdlet을 사용하여 특정 속성만 표시합니다.

Get-CMDevice -CollectionID "XYZ0004B" | Select-Object Name, ClientVersion, DeviceOS, IsActive, LastActiveTime, LastClientCheckTime, LastDDR, LastHardwareScan, LastPolicyRequest

Name                : DEVICE-LT3
ClientVersion       : 5.00.9012.1020
DeviceOS            : Microsoft Windows NT Workstation 10.0 (Tablet Edition)
IsActive            : True
LastActiveTime      : 10/1/2020 23:29:34
LastClientCheckTime : 9/8/2020 18:38:10
LastDDR             : 9/30/2020 20:29:33
LastHardwareScan    : 9/30/2020 22:24:22
LastPolicyRequest   : 10/1/2020 23:29:34

Name                : DEVICE-LT2
ClientVersion       : 5.00.9030.1011
DeviceOS            : Microsoft Windows NT Workstation 10.0 (Tablet Edition)
IsActive            : True
LastActiveTime      : 10/2/2020 00:31:54
LastClientCheckTime : 9/30/2020 23:06:10
LastDDR             : 9/30/2020 19:44:46
LastHardwareScan    : 9/30/2020 01:15:52
LastPolicyRequest   : 10/2/2020 00:31:54

예제 2: 컬렉션 ID로 디바이스 리소스 가져오기

이 명령은 첫 번째 예제와 비슷하지만 -Resource 매개 변수를 사용합니다. 다른 클래스를 쿼리할 때 유사한 데이터에 대해 서로 다른 속성을 반환합니다.

Get-CMDevice -CollectionID "XYZ0004B" -Resource | Select-Object Name, ClientVersion, OperatingSystemNameandVersion, Active, AgentName, AgentTime

Name                          : DEVICE-LT3
ClientVersion                 : 5.00.9012.1020
OperatingSystemNameandVersion : Microsoft Windows NT Workstation 10.0 (Tablet Edition)
Active                        : 1
AgentName                     : {SMS_AD_SYSTEM_DISCOVERY_AGENT, SMS_AD_SECURITY_GROUP_DISCOVERY_AGENT,
                                MP_ClientRegistration, Heartbeat Discovery}
AgentTime                     : {2/28/2020 09:45:01, 10/2/2020 01:00:01, 9/21/2020 15:53:47, 9/30/2020 13:29:33}

Name                          : DEVICE-LT2
ClientVersion                 : 5.00.9030.1011
OperatingSystemNameandVersion : Microsoft Windows NT Workstation 10.0 (Tablet Edition)
Active                        : 1
AgentName                     : {SMS_AD_SYSTEM_DISCOVERY_AGENT, SMS_AD_SECURITY_GROUP_DISCOVERY_AGENT,
                                MP_ClientRegistration, Heartbeat Discovery}
AgentTime                     : {2/28/2020 09:45:01, 10/2/2020 01:00:01, 10/1/2020 14:03:56, 9/30/2020 12:44:46}

예제 3: 특정 디바이스에 대한 속성 가져오기

이 명령은 특정 디바이스를 가져오고 Select-Object cmdlet을 통해 출력을 파이프하여 특정 속성만 표시합니다. -Resource 매개 변수를 사용하므로 속성은 해당 클래스와 관련이 있습니다.

Get-CMDevice -Name "DEVICE-LT2" -Resource | Select-Object Name, CPUType, DistinguishedName, HardwareID, IPAddresses

예제 4: 클라이언트가 아닌 디바이스 가져오기

이 명령은 -Fast 매개 변수를 사용하여 지연 속성이 없는 모든 디바이스를 가져옵니다. 목록을 클라이언트가 아닌 디바이스로만 필터링합니다. 최종 목록에 디바이스 이름만 표시됩니다.

Get-CMDevice -Fast | Where-Object { $_.IsClient -eq $false } | Select-Object Name

예제 5: 특정 위협 이름에 대한 디바이스 가져오기

이 명령은 Microsoft Defender가 특정 위협을 감지한 모든 디바이스를 보여줍니다. 디바이스 이름만 표시합니다.

Get-CMDevice -ThreatName "Trojan:Win32/Wacatac.B!ml" | Select-Object Name

예제 6: 검색된 맬웨어가 있는 모든 디바이스 가져오기

이 명령은 먼저 Get-CMDetectedMalware cmdlet을 사용하여 모든 위협을 가져옵니다. 그런 다음, 해당 목록을 구문 분석하고 맬웨어가 있는 디바이스의 이름을 표시합니다.

$allMalware = Get-CMDetectedMalware
foreach ( $malware in $allMalware ) { Get-CMDevice -InputObject $malware | Select-Object Name }

매개 변수

-Collection

이 매개 변수를 사용하여 디바이스 컬렉션 개체에서 모든 디바이스를 가져옵니다. 이 개체를 얻으려면 Get-CMDeviceCollection cmdlet을 사용합니다.

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

-CollectionId

디바이스 컬렉션의 ID를 지정합니다. 예를 들면 XYZ0004B와 같습니다.

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

-CollectionMember

이 매개 변수를 추가하여 디바이스 정보에 대한 SMS_R_UnknownSystem 및 SMS_R_System 클래스를 쿼리합니다. 이러한 클래스는 역할 기반 액세스에 의해 제한될 수 있습니다. 이러한 클래스에는 더 자세한 컴퓨터 정보가 포함됩니다.

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

-CollectionName

디바이스 컬렉션의 이름을 지정합니다.

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

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

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

-Fast

지연 속성을 자동으로 새로 고치지 않도록 이 매개 변수를 추가합니다. 지연 속성에는 검색에 상대적으로 비효율적인 값이 포함됩니다. 이러한 속성을 가져오면 추가 네트워크 트래픽이 발생하고 cmdlet 성능이 저하될 수 있습니다.

이 매개 변수를 사용하지 않으면 cmdlet에 경고가 표시됩니다. 이 경고를 사용하지 않도록 설정하려면 를 설정합니다 $CMPSSuppressFastNotUsedCheck = $true.

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

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

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

-InputObject

검색된 맬웨어 개체를 지정합니다. 이 개체를 얻으려면 Get-CMDetectedMalware cmdlet을 사용합니다.

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

-Name

디바이스의 이름을 지정합니다.

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

-Resource

이 매개 변수를 추가하여 디바이스 정보에 대한 SMS_Resource 클래스를 쿼리합니다. 이 클래스는 역할 기반 액세스에 의해 제한되어서는 안 됩니다. 출력은 Get-CMResource cmdlet과 동일합니다. 이 출력에는 디바이스에 대한 최소 속성이 있습니다. 자세한 속성의 경우 이 매개 변수를 추가하거나 CollectionMember 매개 변수를 사용하지 마세요.

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

-ResourceId

디바이스의 리소스 ID를 지정합니다. 예를 들면 16780010와 같습니다.

형식:	Int32
별칭:	Id, DeviceId
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ThreatId

이 매개 변수를 사용하여 ID별로 특정 맬웨어가 있는 해당 디바이스로 반환되는 디바이스를 필터링합니다. 예를 들면 2147735505와 같습니다. 이 위협 ID를 가져오려면 Get-CMDetectedMalware cmdlet을 사용합니다.

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

-ThreatName

이 매개 변수를 사용하여 이름별로 특정 맬웨어가 있는 해당 디바이스로 반환되는 디바이스를 필터링합니다. 예를 들면 Trojan:Win32/Wacatac.B!ml와 같습니다. 이 위협 이름을 얻으려면 Get-CMDetectedMalware cmdlet을 사용합니다.

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

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

IResultObject[]

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_CombinedDeviceResources 서버 WMI 클래스를 참조하세요.

다음을 통해 공유

Get-CMDevice

구문

Description

예제

예제 1: 컬렉션 ID로 디바이스 가져오기

예제 2: 컬렉션 ID로 디바이스 리소스 가져오기

예제 3: 특정 디바이스에 대한 속성 가져오기

예제 4: 클라이언트가 아닌 디바이스 가져오기

예제 5: 특정 위협 이름에 대한 디바이스 가져오기

예제 6: 검색된 맬웨어가 있는 모든 디바이스 가져오기

매개 변수

-Collection

-CollectionId

-CollectionMember

-CollectionName

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-InputObject

-Name

-Resource

-ResourceId

-ThreatId

-ThreatName

입력

출력

참고

피드백

추가 리소스

다음을 통해 공유

Get-CMDevice

구문

Description

예제

예제 1: 컬렉션 ID로 디바이스 가져오기

예제 2: 컬렉션 ID로 디바이스 리소스 가져오기

예제 3: 특정 디바이스에 대한 속성 가져오기

예제 4: 클라이언트가 아닌 디바이스 가져오기

예제 5: 특정 위협 이름에 대한 디바이스 가져오기

예제 6: 검색된 맬웨어가 있는 모든 디바이스 가져오기

매개 변수

-Collection

-CollectionId

-CollectionMember

-CollectionName

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-InputObject

-Name

-Resource

-ResourceId

-ThreatId

-ThreatName

입력

출력

참고

관련 링크

피드백

추가 리소스