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 .

Тип:	IResultObject
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CollectionId

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CollectionMember

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

Тип:	SwitchParameter
Aliases:	CollectionMemberInstance
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CollectionName

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisableWildcardHandling

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Fast

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

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ForceWildcardHandling

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

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

Тип:	IResultObject
Aliases:	Threat
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Name

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	True

-Resource

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

Тип:	SwitchParameter
Aliases:	ResourceInstance
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ResourceId

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

Тип:	Int32
Aliases:	Id, DeviceId
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ThreatId

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

Тип:	String
Aliases:	ThreatNameId
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ThreatName

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	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

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

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

Примечания

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

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

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