Get-CMDevice
SYNOPSIS
Obtenha um dispositivo De Gestor de Configuração.
SYNTAX
ByName (Padrão)
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 [-CollectionId <String>] [-CollectionMember] [-Fast] [-Resource] -ThreatId <String>
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
SearchByNameMandatoryForViewInfectedClients
Get-CMDevice [-CollectionId <String>] [-CollectionMember] [-Fast] [-Resource] -ThreatName <String>
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
SearchByValueMandatoryForViewInfectedClients
Get-CMDevice [-CollectionId <String>] [-CollectionMember] [-Fast] -InputObject <IResultObject> [-Resource]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
PesquisaByNameMandatory
Get-CMDevice [-CollectionMember] -CollectionName <String> [-Fast] [-Name <String>] [-Resource]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
ById
Get-CMDevice [-CollectionMember] [-Fast] [-Resource] -ResourceId <Int32> [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
DESCRIPTION
O cmdlet Get-CMDevice obtém um dispositivo Gestor de Configuração. Por defeito, consulta a classe SMS_CM_RES_COLL_SMS00001. Pode utilizar os parâmetros -Recursos ou -Recolhamembro para alterar a classe de consulta. Dependendo do seu acesso baseado em funções no site, poderá ter de utilizar um destes outros parâmetros.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\>
. Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Obter dispositivos por ID de coleção
Este comando obtém todos os objetos do dispositivo na recolha do dispositivo com o ID de XYZ0004B. Utiliza o cmdlet Select-Object apenas para exibir 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: Obtenha recursos do dispositivo através do ID de recolha
Este comando é semelhante ao primeiro exemplo, mas utiliza o parâmetro -Recursos. Quando consulta uma classe diferente, devolve diferentes propriedades 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 canaliza a saída através do cmdlet Select-Object para mostrar apenas propriedades específicas. Uma vez que utiliza o parâmetro -Recursos, 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 preguiçosas. 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. Só apresenta o nome do dispositivo.
Get-CMDevice -ThreatName "Trojan:Win32/Wacatac.B!ml" | Select-Object Name
Exemplo 6: Obtenha todos os dispositivos com qualquer malware detetado
Este comando utiliza primeiro o cmdlet Get-CMDetectedMalware para obter todas as ameaças. Em seguida, analisa através dessa lista, e exibe o nome de dispositivos com malware.
$allMalware = Get-CMDetectedMalware
foreach ( $malware in $allMalware ) { Get-CMDevice -InputObject $malware | Select-Object Name }
PARAMETERS
-Coleção
Utilize este parâmetro para obter todos os dispositivos de um objeto de recolha do dispositivo. Para obter este objeto, utilize o cmdlet Get-CMDeviceCollection.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Especifique um ID para uma recolha do dispositivo. Por exemplo, XYZ0004B
.
Type: String
Parameter Sets: SearchByIdMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: String
Parameter Sets: SearchByIdMandatoryForViewInfectedClients, SearchByNameMandatoryForViewInfectedClients, SearchByValueMandatoryForViewInfectedClients
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ColeçãoMember
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 aulas contêm informações mais detalhadas sobre a máquina.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: CollectionMemberInstance
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome de coleção
Especifique o nome de uma coleção de dispositivos.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- Rápido
Adicione este parâmetro para não atualizar automaticamente as propriedades preguiçosas. As propriedades preguiçosas contêm valores que são relativamente ineficientes de recuperação. Obter estas propriedades pode causar tráfego adicional de rede e diminuir o desempenho do cmdlet.
Se não utilizar este parâmetro, o cmdlet apresenta um aviso. Para desativar este aviso, desative $CMPSSuppressFastNotUsedCheck = $true
.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Especifique um objeto malware detetado. Para obter este objeto, utilize o cmdlet Get-CMDetectedMalware.
Type: IResultObject
Parameter Sets: SearchByValueMandatoryForViewInfectedClients
Aliases: Threat
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Especifique o nome de um dispositivo.
Type: String
Parameter Sets: ByName, SearchByValueMandatory, SearchByIdMandatory, SearchByNameMandatory
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Recurso
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 papéis. A saída é a mesma que com o cmdlet Get-CMResource. Esta saída tem propriedades mínimas para o dispositivo. Para propriedades mais detalhadas, não adicione este parâmetro, nem use o parâmetro -CollectionMember.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: ResourceInstance
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ResourceId
Especifique o ID de recurso de um dispositivo. Por exemplo, 16780010
.
Type: Int32
Parameter Sets: ById
Aliases: Id, DeviceId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ThreatId
Utilize este parâmetro para filtrar os dispositivos que retorna a esses dispositivos com malware específico por ID. Por exemplo, 2147735505
. Para obter este ID de ameaça, use o cmdlet Get-CMDetectedMalware.
Type: String
Parameter Sets: SearchByIdMandatoryForViewInfectedClients
Aliases: ThreatNameId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome da ameaça
Utilize este parâmetro para filtrar os dispositivos que retorna aos dispositivos com malware específico pelo nome. Por exemplo, Trojan:Win32/Wacatac.B!ml
. Para obter este nome de ameaça, use o cmdlet Get-CMDetectedMalware.
Type: String
Parameter Sets: SearchByNameMandatoryForViewInfectedClients
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.