Get-CMDevice

Referência

Módulo:: ConfigurationManager

Obtenha um dispositivo Configuration Manager.

Syntax

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

O cmdlet Get-CMDevice obtém um dispositivo Configuration Manager. Por padrão, ele consulta a classe SMS_CM_RES_COLL_SMS00001 . Você pode usar os parâmetros Resource ou CollectionMember para alterar a classe de consulta. Dependendo do acesso baseado em função no site, talvez seja necessário usar um desses outros parâmetros. Por exemplo, se você não tiver acesso a SMS00001, por padrão esse cmdlet retornará zero resultados.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: Obter dispositivos por ID da coleção

Esse comando obtém todos os objetos do dispositivo na coleção de dispositivos com a ID de XYZ0004B. Ele usa o cmdlet Select-Object para exibir apenas propriedades 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

Exemplo 2: Obter recursos do dispositivo por ID de coleção

Esse comando é semelhante ao primeiro exemplo, mas usa o parâmetro -Resource . Quando consulta uma classe diferente, ela retorna propriedades diferentes para dados semelhantes.

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}

Exemplo 3: obter propriedades para um dispositivo específico

Esse comando obtém um dispositivo específico e canaliza a saída por meio do cmdlet Select-Object para mostrar apenas propriedades específicas. Como ele usa o parâmetro -Resource , as propriedades são específicas para essa classe.

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

Exemplo 4: obter dispositivos que não são clientes

Esse comando usa o parâmetro -Fast para obter todos os dispositivos sem propriedades preguiçosas. Ele filtra a lista apenas para dispositivos que não são clientes. Ele exibe apenas o nome do dispositivo na lista final.

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

Exemplo 5: obter dispositivos para um nome de ameaça específico

Este comando mostra todos os dispositivos nos quais Microsoft Defender detectou uma ameaça específica. Ele exibe apenas o nome do dispositivo.

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

Exemplo 6: Obter todos os dispositivos com qualquer malware detectado

Esse comando usa primeiro o cmdlet Get-CMDetectedMalware para obter todas as ameaças. Em seguida, ele analisa essa lista e exibe o nome dos dispositivos com malware.

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

Parâmetros

-Collection

Use esse parâmetro para obter todos os dispositivos de um objeto de coleção de dispositivos. Para obter esse objeto, use o cmdlet Get-CMDeviceCollection .

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

-CollectionId

Especifique uma ID para uma coleção de dispositivos. Por exemplo, XYZ0004B.

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

-CollectionMember

Adicione esse parâmetro para consultar as classes SMS_R_UnknownSystem e SMS_R_System para obter informações do dispositivo. Essas classes podem ser restritas pelo acesso baseado em função. Essas classes contêm informações mais detalhadas do computador.

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

-CollectionName

Especifique o nome de uma coleção de dispositivos.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-Fast

Adicione esse parâmetro para não atualizar automaticamente propriedades preguiçosas. Propriedades preguiçosas contêm valores relativamente ineficientes para recuperar. Obter essas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.

Se você não usar esse parâmetro, o cmdlet exibirá um aviso. Para desabilitar esse aviso, defina $CMPSSuppressFastNotUsedCheck = $true.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-InputObject

Especifique um objeto malware detectado. Para obter esse objeto, use o cmdlet Get-CMDetectedMalware .

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

-Name

Especifique o nome de um dispositivo.

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

-Resource

Adicione esse parâmetro para consultar a classe SMS_Resource para obter informações do dispositivo. Essa classe não deve ser restrita pelo acesso baseado em função. A saída é a mesma que com o cmdlet Get-CMResource . Essa saída tem propriedades mínimas para o dispositivo. Para propriedades mais detalhadas, não adicione esse parâmetro ou use o parâmetro CollectionMember .

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

-ResourceId

Especifique a ID do recurso de um dispositivo. Por exemplo, 16780010.

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

-ThreatId

Use esse parâmetro para filtrar os dispositivos que ele retorna a esses dispositivos com malware específico por ID. Por exemplo, 2147735505. Para obter essa ID de ameaça, use o cmdlet Get-CMDetectedMalware .

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

-ThreatName

Use esse parâmetro para filtrar os dispositivos que ele retorna a esses dispositivos com malware específico pelo nome. Por exemplo, Trojan:Win32/Wacatac.B!ml. Para obter esse nome de ameaça, use o cmdlet Get-CMDetectedMalware .

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_CombinedDeviceResources classe WMI do servidor.

Share via

Get-CMDevice

Syntax

Description

Exemplos

Exemplo 1: Obter dispositivos por ID da coleção

Exemplo 2: Obter recursos do dispositivo por ID de coleção

Exemplo 3: obter propriedades para um dispositivo específico

Exemplo 4: obter dispositivos que não são clientes

Exemplo 5: obter dispositivos para um nome de ameaça específico

Exemplo 6: Obter todos os dispositivos com qualquer malware detectado

Parâmetros

-Collection

-CollectionId

-CollectionMember

-CollectionName

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-InputObject

-Name

-Resource

-ResourceId

-ThreatId

-ThreatName

Entradas

Saídas

Observações

Comentários

Recursos adicionais

Share via

Get-CMDevice

Syntax

Description

Exemplos

Exemplo 1: Obter dispositivos por ID da coleção

Exemplo 2: Obter recursos do dispositivo por ID de coleção

Exemplo 3: obter propriedades para um dispositivo específico

Exemplo 4: obter dispositivos que não são clientes

Exemplo 5: obter dispositivos para um nome de ameaça específico

Exemplo 6: Obter todos os dispositivos com qualquer malware detectado

Parâmetros

-Collection

-CollectionId

-CollectionMember

-CollectionName

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-InputObject

-Name

-Resource

-ResourceId

-ThreatId

-ThreatName

Entradas

Saídas

Observações

Links Relacionados

Comentários

Recursos adicionais