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 に戻します。

注意

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

例

例 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 コマンドレットを使用 します。

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionId

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionMember

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

Type:	SwitchParameter
Aliases:	CollectionMemberInstance
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Fast

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	IResultObject
Aliases:	Threat
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

-Resource

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

Type:	SwitchParameter
Aliases:	ResourceInstance
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

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

Type:	Int32
Aliases:	Id, DeviceId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ThreatId

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

Type:	String
Aliases:	ThreatNameId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ThreatName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject[]

IResultObject

メモ

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

関連リンク

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