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, по умолчанию этот командлет возвращает ноль результатов.

Примечание.

Выполните командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Получение устройств по идентификатору коллекции

Эта команда получает все объекты устройства в коллекции устройств с идентификатором XYZ0004B. Командлет 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. Получение ресурсов устройства по идентификатору коллекции

Эта команда аналогична первому примеру, но использует параметр -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
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionId

Укажите идентификатор для коллекции устройств. Например, XYZ0004B.

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

-CollectionMember

Добавьте этот параметр для запроса классов SMS_R_UnknownSystem и SMS_R_System для получения сведений об устройстве. Эти классы могут быть ограничены доступом на основе ролей. Эти классы содержат более подробные сведения о компьютере.

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

-CollectionName

Укажите имя коллекции устройств.

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

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

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

-Fast

Добавьте этот параметр, чтобы не обновлять отложенные свойства автоматически. Отложенные свойства содержат значения, которые относительно неэффективны для извлечения. Получение этих свойств может привести к дополнительному сетевому трафику и снижению производительности командлетов.

Если этот параметр не используется, командлет выводит предупреждение. Чтобы отключить это предупреждение, задайте .$CMPSSuppressFastNotUsedCheck = $true

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

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

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

-InputObject

Укажите обнаруженный объект вредоносных программ. Чтобы получить этот объект, используйте командлет Get-CMDetectedMalware .

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

-Name

Укажите имя устройства.

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

-Resource

Добавьте этот параметр для запроса к классу SMS_Resource для получения сведений об устройстве. Этот класс не должен быть ограничен доступом на основе ролей. Выходные данные совпадают с командлетом Get-CMResource . Эти выходные данные имеют минимальные свойства для устройства. Для более подробных свойств не добавляйте этот параметр и не используйте параметр CollectionMember .

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

-ResourceId

Укажите идентификатор ресурса устройства. Например, 16780010.

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

-ThreatId

Используйте этот параметр для фильтрации устройств, возвращаемых устройствами с определенными вредоносными программами по идентификатору. Например, 2147735505. Чтобы получить этот идентификатор угрозы, используйте командлет Get-CMDetectedMalware .

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

-ThreatName

Используйте этот параметр для фильтрации устройств, которые он возвращает этим устройствам с определенными вредоносными программами по имени. Например, Trojan:Win32/Wacatac.B!ml. Чтобы получить это имя угрозы, используйте командлет Get-CMDetectedMalware .

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

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

IResultObject[]

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_CombinedDeviceResources класс WMI сервера.

Get-CMDevice

Синтаксис

Описание

Примеры

Пример 1. Получение устройств по идентификатору коллекции

Пример 2. Получение ресурсов устройства по идентификатору коллекции

Пример 3. Получение свойств для определенного устройства

Пример 4. Получение устройств, которые не являются клиентами

Пример 5. Получение устройств для определенного имени угрозы

Пример 6. Получение всех устройств с обнаруженными вредоносными программами

Параметры

-Collection

-CollectionId

-CollectionMember

-CollectionName

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-InputObject

-Name

-Resource

-ResourceId

-ThreatId

-ThreatName

Входные данные

Выходные данные

Примечания

Обратная связь

Дополнительные ресурсы

Get-CMDevice

Синтаксис

Описание

Примеры

Пример 1. Получение устройств по идентификатору коллекции

Пример 2. Получение ресурсов устройства по идентификатору коллекции

Пример 3. Получение свойств для определенного устройства

Пример 4. Получение устройств, которые не являются клиентами

Пример 5. Получение устройств для определенного имени угрозы

Пример 6. Получение всех устройств с обнаруженными вредоносными программами

Параметры

-Collection

-CollectionId

-CollectionMember

-CollectionName

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-InputObject

-Name

-Resource

-ResourceId

-ThreatId

-ThreatName

Входные данные

Выходные данные

Примечания

Связанные ссылки

Обратная связь

Дополнительные ресурсы