Compartilhar via

Get-CMDevice

  • Referência
Módulo:
ConfigurationManager

Obter um dispositivo do Configuration Manager.

Sintaxe

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 do Configuration Manager. Por predefinição, consulta a classe SMS_CM_RES_COLL_SMS00001 . Pode utilizar os parâmetros Resource ou CollectionMember para alterar a classe de consulta. Consoante o seu acesso baseado em funções no site, poderá ter de utilizar um destes outros parâmetros. Por exemplo, se não tiver acesso a SMS00001, por predefinição, este cmdlet devolve zero resultados.

Observação

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

Exemplos

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

Este comando obtém todos os objetos do dispositivo na coleção de dispositivos com o ID de XYZ0004B. Utiliza o cmdlet Select-Object para apresentar 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

Este comando é semelhante ao primeiro exemplo, mas utiliza o parâmetro -Resource . Quando consulta uma classe diferente, devolve 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

Este comando obtém um dispositivo específico e encaminha a saída através do cmdlet Select-Object para mostrar apenas propriedades específicas. Uma vez que utiliza o parâmetro -Resource , as propriedades são específicas dessa classe.

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

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

Este comando utiliza o parâmetro -Fast para obter todos os dispositivos sem propriedades lentas. Filtra a lista apenas para dispositivos que não são clientes. Só apresenta 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 o Microsoft Defender detetou uma ameaça específica. Apenas apresenta o nome do dispositivo.

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

Exemplo 6: Obter todos os dispositivos com software maligno detetado

Este comando utiliza primeiro o cmdlet Get-CMDetectedMalware para obter todas as ameaças. Em seguida, analisa essa lista e apresenta o nome dos dispositivos com software maligno.

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

Parâmetros

-Collection

Utilize este parâmetro para obter todos os dispositivos de um objeto de coleção de dispositivos. Para obter este objeto, utilize o cmdlet Get-CMDeviceCollection .

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionMember

Adicione este parâmetro para consultar as classes SMS_R_UnknownSystem e SMS_R_System para obter informações sobre o dispositivo. Estas classes podem ser restringidas pelo acesso baseado em funções. Estas classes contêm informações mais detalhadas sobre o computador.

Tipo:SwitchParameter
Aliases:CollectionMemberInstance
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Fast

Adicione este parâmetro para não atualizar automaticamente as propriedades em diferido. As propriedades em diferido contêm valores relativamente ineficientes a obter. Obter estas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.

Se não utilizar este parâmetro, o cmdlet apresenta um aviso. Para desativar este aviso, defina $CMPSSuppressFastNotUsedCheck = $true.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique um objeto de software maligno detetado. Para obter este objeto, utilize o cmdlet Get-CMDetectedMalware .

Tipo:IResultObject
Aliases:Threat
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifique o nome de um dispositivo.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-Resource

Adicione este parâmetro para consultar a classe SMS_Resource para obter informações sobre o dispositivo. Esta classe não deve ser restringida pelo acesso baseado em funções. O resultado é o mesmo que com o cmdlet Get-CMResource . Este resultado tem propriedades mínimas para o dispositivo. Para obter propriedades mais detalhadas, não adicione este parâmetro nem utilize o parâmetro CollectionMember .

Tipo:SwitchParameter
Aliases:ResourceInstance
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceId

Especifique o ID de recurso de um dispositivo. Por exemplo, 16780010.

Tipo:Int32
Aliases:Id, DeviceId
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ThreatId

Utilize este parâmetro para filtrar os dispositivos que devolve a esses dispositivos com software maligno específico por ID. Por exemplo, 2147735505. Para obter este ID de ameaça, utilize o cmdlet Get-CMDetectedMalware .

Tipo:String
Aliases:ThreatNameId
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ThreatName

Utilize este parâmetro para filtrar os dispositivos que devolve a esses dispositivos com software maligno específico por nome. Por exemplo, Trojan:Win32/Wacatac.B!ml. Para obter este nome de ameaça, utilize o cmdlet Get-CMDetectedMalware .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_CombinedDeviceResources classe WMI de servidor.