Get-CMDevice

Referencia

Módulo:: ConfigurationManager

Obtener un dispositivo Configuration Manager.

Sintaxis

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

Description

El cmdlet Get-CMDevice obtiene un dispositivo Configuration Manager. De forma predeterminada, consulta la clase SMS_CM_RES_COLL_SMS00001 . Puede usar los parámetros Resource o CollectionMember para cambiar la clase de consulta. En función del acceso basado en rol en el sitio, es posible que tenga que usar uno de estos otros parámetros. Por ejemplo, si no tiene acceso a SMS00001, este cmdlet devuelve de forma predeterminada cero resultados.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Obtención de dispositivos por identificador de recopilación

Este comando obtiene todos los objetos de dispositivo de la colección de dispositivos con el identificador XYZ0004B. Usa el cmdlet Select-Object para mostrar solo propiedades específicas.

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

Ejemplo 2: Obtención de recursos de dispositivo por identificador de recopilación

Este comando es similar al primer ejemplo, pero usa el parámetro -Resource . Cuando consulta una clase diferente, devuelve propiedades diferentes para datos similares.

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}

Ejemplo 3: Obtener propiedades para un dispositivo específico

Este comando obtiene un dispositivo específico y canaliza la salida a través del cmdlet Select-Object para mostrar solo propiedades específicas. Dado que usa el parámetro -Resource , las propiedades son específicas de esa clase.

Get-CMDevice -Name "DEVICE-LT2" -Resource | Select-Object Name, CPUType, DistinguishedName, HardwareID, IPAddresses

Ejemplo 4: Obtener dispositivos que no son clientes

Este comando usa el parámetro -Fast para obtener todos los dispositivos sin propiedades diferidas. Filtra la lista solo a los dispositivos que no son clientes. Solo muestra el nombre del dispositivo en la lista final.

Get-CMDevice -Fast | Where-Object { $_.IsClient -eq $false } | Select-Object Name

Ejemplo 5: Obtención de dispositivos para un nombre de amenaza específico

Este comando muestra todos los dispositivos en los que Microsoft Defender ha detectado una amenaza específica. Solo muestra el nombre del dispositivo.

Get-CMDevice -ThreatName "Trojan:Win32/Wacatac.B!ml" | Select-Object Name

Ejemplo 6: Obtención de todos los dispositivos con cualquier malware detectado

Este comando usa primero el cmdlet Get-CMDetectedMalware para obtener todas las amenazas. A continuación, analiza esa lista y muestra el nombre de los dispositivos con malware.

$allMalware = Get-CMDetectedMalware
foreach ( $malware in $allMalware ) { Get-CMDevice -InputObject $malware | Select-Object Name }

Parámetros

-Collection

Use este parámetro para obtener todos los dispositivos de un objeto de colección de dispositivos. Para obtener este objeto, use el cmdlet Get-CMDeviceCollection .

Tipo:	IResultObject
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CollectionId

Especifique un identificador para una colección de dispositivos. Por ejemplo, XYZ0004B.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CollectionMember

Agregue este parámetro para consultar las clases SMS_R_UnknownSystem y SMS_R_System para obtener información del dispositivo. Estas clases pueden estar restringidas por el acceso basado en roles. Estas clases contienen información de máquina más detallada.

Tipo:	SwitchParameter
Alias:	CollectionMemberInstance
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CollectionName

Especifique el nombre de una colección de dispositivos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Fast

Agregue este parámetro para no actualizar automáticamente las propiedades diferidas. Las propiedades diferidas contienen valores relativamente ineficaces para recuperar. La obtención de estas propiedades puede provocar tráfico de red adicional y reducir el rendimiento del cmdlet.

Si no usa este parámetro, el cmdlet muestra una advertencia. Para deshabilitar esta advertencia, establezca $CMPSSuppressFastNotUsedCheck = $true.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

Especifique un objeto de malware detectado. Para obtener este objeto, use el cmdlet Get-CMDetectedMalware .

Tipo:	IResultObject
Alias:	Threat
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Especifique el nombre de un dispositivo.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	True

-Resource

Agregue este parámetro para consultar la clase SMS_Resource para obtener información del dispositivo. Esta clase no debe estar restringida por el acceso basado en roles. La salida es la misma que con el cmdlet Get-CMResource . Esta salida tiene propiedades mínimas para el dispositivo. Para obtener propiedades más detalladas, no agregue este parámetro ni use el parámetro CollectionMember .

Tipo:	SwitchParameter
Alias:	ResourceInstance
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceId

Especifique el identificador de recurso de un dispositivo. Por ejemplo, 16780010.

Tipo:	Int32
Alias:	Id, DeviceId
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ThreatId

Use este parámetro para filtrar los dispositivos que devuelve a esos dispositivos con malware específico por identificador. Por ejemplo, 2147735505. Para obtener este identificador de amenaza, use el cmdlet Get-CMDetectedMalware .

Tipo:	String
Alias:	ThreatNameId
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ThreatName

Use este parámetro para filtrar los dispositivos que devuelve a esos dispositivos con malware específico por nombre. Por ejemplo, Trojan:Win32/Wacatac.B!ml. Para obtener este nombre de amenaza, use el cmdlet Get-CMDetectedMalware .

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

IResultObject[]

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_CombinedDeviceResources clase WMI de servidor.

Compartir a través de

Get-CMDevice

Sintaxis

Description

Ejemplos

Ejemplo 1: Obtención de dispositivos por identificador de recopilación

Ejemplo 2: Obtención de recursos de dispositivo por identificador de recopilación

Ejemplo 3: Obtener propiedades para un dispositivo específico

Ejemplo 4: Obtener dispositivos que no son clientes

Ejemplo 5: Obtención de dispositivos para un nombre de amenaza específico

Ejemplo 6: Obtención de todos los dispositivos con cualquier malware detectado

Parámetros

-Collection

-CollectionId

-CollectionMember

-CollectionName

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-InputObject

-Name

-Resource

-ResourceId

-ThreatId

-ThreatName

Entradas

Salidas

Notas

Comentarios

Recursos adicionales

Compartir a través de

Get-CMDevice

Sintaxis

Description

Ejemplos

Ejemplo 1: Obtención de dispositivos por identificador de recopilación

Ejemplo 2: Obtención de recursos de dispositivo por identificador de recopilación

Ejemplo 3: Obtener propiedades para un dispositivo específico

Ejemplo 4: Obtener dispositivos que no son clientes

Ejemplo 5: Obtención de dispositivos para un nombre de amenaza específico

Ejemplo 6: Obtención de todos los dispositivos con cualquier malware detectado

Parámetros

-Collection

-CollectionId

-CollectionMember

-CollectionName

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-InputObject

-Name

-Resource

-ResourceId

-ThreatId

-ThreatName

Entradas

Salidas

Notas

Vínculos relacionados

Comentarios

Recursos adicionales