Get-CMDevice

Модуль:
ConfigurationManager Module

Получение устройства Configuration Manager.

Синтаксис

ByName (По умолчанию) 

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

SearchByValueMandatory 

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

SearchByIdMandatory 

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

SearchByIdMandatoryForViewInfectedClients 

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

SearchByNameMandatoryForViewInfectedClients 

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

SearchByValueMandatoryForViewInfectedClients 

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

SearchByNameMandatory 

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

ById 

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

Описание

Командлет Get-CMDevice получает Configuration Manager устройство. По умолчанию он запрашивает коллекцию All Systems . Параметры Resource или CollectionMember можно использовать, чтобы изменить коллекцию для запроса. В зависимости от доступа на основе ролей на сайте может потребоваться использовать один из этих других параметров. Например, если у вас нет доступа к SMS00001 (коллекция All Systems), то по умолчанию этот командлет возвращает ноль результатов.

Примечание.

Выполните командлеты 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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SearchByValueMandatory
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CollectionId

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SearchByIdMandatory
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CollectionMember

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

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:CollectionMemberInstance

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CollectionName

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SearchByNameMandatory
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DisableWildcardHandling

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

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Fast

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

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

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ForceWildcardHandling

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

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-InputObject

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

Свойства параметров

Тип:IResultObject
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Угрозы

Наборы параметров

SearchByValueMandatoryForViewInfectedClients
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:True
DontShow:False

Наборы параметров

ByName
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
SearchByValueMandatory
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
SearchByIdMandatory
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
SearchByNameMandatory
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Resource

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

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ResourceInstance

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ResourceId

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

Свойства параметров

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Id, DeviceId

Наборы параметров

ById
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ThreatId

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ThreatNameId

Наборы параметров

SearchByIdMandatoryForViewInfectedClients
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ThreatName

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SearchByNameMandatoryForViewInfectedClients
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

IResultObject

IResultObject

Примечания

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