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

説明

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

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例

例 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

デバイス コレクション オブジェクトからすべてのデバイスを取得するには、このパラメーターを使用します。 このオブジェクトを取得するには、 Get-CMDeviceCollection コマンドレットを 使用します。

型:	IResultObject
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CollectionId

デバイス コレクションの ID を指定します。 たとえば、「 XYZ0004B 」のように入力します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CollectionMember

このパラメーターを追加して、 SMS_R_UnknownSystem クラスと SMS_R_System クラスに対してデバイス情報のクエリを実行します。 これらのクラスは、ロールベースのアクセスによって制限される場合があります。 これらのクラスには、より詳細なマシン情報が含まれています。

型:	SwitchParameter
Aliases:	CollectionMemberInstance
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CollectionName

デバイス コレクションの名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Fast

このパラメーターを追加して、遅延プロパティを自動的に更新しないようにします。 遅延プロパティには、取得するのが比較的非効率的な値が含まれています。 これらのプロパティを取得すると、追加のネットワーク トラフィックが発生し、コマンドレットのパフォーマンスが低下する可能性があります。

このパラメーターを使用しない場合、コマンドレットに警告が表示されます。 この警告を無効にするには、 $CMPSSuppressFastNotUsedCheck = $trueを設定します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

検出されたマルウェア オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMDetectedMalware コマンドレットを 使用します。

型:	IResultObject
Aliases:	Threat
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Name

デバイスの名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	True

-Resource

デバイス情報を SMS_Resource クラスに照会するには、このパラメーターを追加します。 このクラスは、ロールベースのアクセスによって制限されるべきではありません。 出力は、 Get-CMResource コマンドレットと同じです。 この出力には、デバイスの最小プロパティがあります。 詳細なプロパティについては、このパラメーターを追加しないか、 CollectionMember パラメーターを使用します。

型:	SwitchParameter
Aliases:	ResourceInstance
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ResourceId

デバイスのリソース ID を指定します。 たとえば、「 16780010 」のように入力します。

型:	Int32
Aliases:	Id, DeviceId
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ThreatId

このパラメーターを使用して、特定のマルウェアを持つデバイスに返されるデバイスを ID でフィルター処理します。 たとえば、「 2147735505 」のように入力します。 この脅威 ID を取得するには、 Get-CMDetectedMalware コマンドレットを 使用します。

型:	String
Aliases:	ThreatNameId
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ThreatName

このパラメーターを使用して、特定のマルウェアを含むデバイスに返されるデバイスを名前でフィルター処理します。 たとえば、「 Trojan:Win32/Wacatac.B!ml 」のように入力します。 この脅威名を取得するには、 Get-CMDetectedMalware コマンドレットを 使用します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject[]

IResultObject

メモ

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

関連リンク

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