Get-CMDevice

構文

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>]

説明

Get-CMDevice コマンドレットは、Configuration Manager デバイスを取得します。 既定では、 SMS_CM_RES_COLL_SMS00001 クラスに対してクエリを実行します。 Resource パラメーターまたは CollectionMember パラメーターを使用して、クエリ クラスを変更できます。 サイトでのロールベースのアクセスに応じて、これらの他のパラメーターのいずれかを使用する必要がある場合があります。 たとえば、SMS00001にアクセスできない場合、既定では、このコマンドレットは 0 個の結果を返します。

例

例 1: コレクション ID でデバイスを取得する

このコマンドは、XYZ0004Bの ID を持つデバイス コレクション内のすべてのデバイス オブジェクトを取得します。 Select-Object コマンドレットを使用して、特定のプロパティのみを表示します。

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 コマンドレットを介して出力をパイプ処理して、特定のプロパティのみを表示します。 -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 コマンドレットを使用して、すべての脅威を取得します。 その後、そのリストを解析し、マルウェアを含むデバイスの名前を表示します。

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

パラメーター

-Collection

-CollectionId

-CollectionMember

-CollectionName

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-InputObject

-Name

-Resource

-ResourceId

-ThreatId

-ThreatName

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject[]

IResultObject

メモ

この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_CombinedDeviceResources」を参照してください。

関連リンク

• Get-CMResource
• Approve-CMDevice
• Block-CMDevice
• Get-CMDeviceCollection
• Remove-CMDevice
• Unblock-CMDevice