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
    -ThreatId <String>
    [-CollectionId <String>]
    [-CollectionMember]
    [-Fast]
    [-Resource]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

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

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

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

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

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

このコマンドは、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

このコマンドは最初の例に似ていますが、 -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}

このコマンドは、特定のデバイスを取得し、 Select-Object コマンドレットを介して出力をパイプ処理して、特定のプロパティのみを表示します。 -Resource パラメーターを使用するため、プロパティはそのクラスに固有です。

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

このコマンドでは、 -Fast パラメーターを使用して、遅延プロパティを持たないすべてのデバイスを取得します。 クライアントではないデバイスのみにリストをフィルター処理します。 最終的な一覧にデバイス名のみが表示されます。

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

このコマンドは、Microsoft Defenderが特定の脅威を検出したすべてのデバイスを表示します。 デバイスの名前のみが表示されます。

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

このコマンドでは、まず Get-CMDetectedMalware コマンドレットを使用して、すべての脅威を取得します。 その後、そのリストを解析し、マルウェアを含むデバイスの名前を表示します。

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

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。

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