L’applet de commande Get-CMDevice obtient un appareil Configuration Manager. Par défaut, il interroge la collection Tous les systèmes . Vous pouvez utiliser les paramètres Resource ou CollectionMember pour modifier la collection à interroger. Selon votre accès en fonction du rôle sur le site, vous devrez peut-être utiliser l’un de ces autres paramètres. Par exemple, si vous n’avez pas accès à SMS00001 (collection Tous les systèmes), cette applet de commande ne retourne aucun résultat par défaut.
Remarque
Exécutez Configuration Manager applets de commande à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.
Exemples
Exemple 1 : Obtenir des appareils par ID de regroupement
Cette commande obtient tous les objets d’appareil dans le regroupement d’appareils avec l’ID de XYZ0004B. Il utilise l’applet de commande Select-Object pour afficher uniquement des propriétés spécifiques.
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
Exemple 2 : Obtenir des ressources d’appareil par ID de regroupement
Cette commande est similaire au premier exemple, mais utilise le paramètre -Resource . Lorsqu’il interroge une classe différente, il retourne des propriétés différentes pour des données similaires.
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}
Exemple 3 : Obtenir les propriétés d’un appareil spécifique
Cette commande obtient un appareil spécifique et canalise la sortie via l’applet de commande Select-Object pour afficher uniquement des propriétés spécifiques. Étant donné qu’il utilise le paramètre -Resource , les propriétés sont spécifiques à cette classe.
Exemple 4 : Obtenir des appareils qui ne sont pas clients
Cette commande utilise le paramètre -Fast pour obtenir tous les appareils sans propriétés différées. Il filtre la liste uniquement sur les appareils qui ne sont pas clients. Il affiche uniquement le nom de l’appareil dans la liste finale.
Exemple 5 : Obtenir des appareils pour un nom de menace spécifique
Cette commande affiche tous les appareils sur lesquels Microsoft Defender a détecté une menace spécifique. Il affiche uniquement le nom de l’appareil.
Get-CMDevice -ThreatName "Trojan:Win32/Wacatac.B!ml" | Select-Object Name
Exemple 6 : Obtenir tous les appareils avec des programmes malveillants détectés
Cette commande utilise d’abord l’applet de commande Get-CMDetectedMalware pour obtenir toutes les menaces. Il analyse ensuite cette liste et affiche le nom des appareils avec des programmes malveillants.
$allMalware = Get-CMDetectedMalware
foreach ( $malware in $allMalware ) { Get-CMDevice -InputObject $malware | Select-Object Name }
Paramètres
-Collection
Utilisez ce paramètre pour obtenir tous les appareils à partir d’un objet de regroupement d’appareils. Pour obtenir cet objet, utilisez l’applet de commande Get-CMDeviceCollection .
Propriétés du paramètre
Type:
IResultObject
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Jeux de paramètres
SearchByValueMandatory
Position:
Named
Obligatoire:
True
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-CollectionId
Spécifiez un ID pour un regroupement d’appareils. Par exemple : XYZ0004B.
Propriétés du paramètre
Type:
String
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Jeux de paramètres
SearchByIdMandatory
Position:
Named
Obligatoire:
True
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-CollectionMember
Ajoutez ce paramètre pour interroger les classes SMS_R_UnknownSystem et SMS_R_System pour obtenir des informations sur l’appareil. Ces classes peuvent être limitées par l’accès en fonction du rôle. Ces classes contiennent des informations plus détaillées sur l’ordinateur.
Propriétés du paramètre
Type:
SwitchParameter
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Alias:
CollectionMemberInstance
Jeux de paramètres
(All)
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-CollectionName
Spécifiez le nom d’un regroupement d’appareils.
Propriétés du paramètre
Type:
String
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Jeux de paramètres
SearchByNameMandatory
Position:
Named
Obligatoire:
True
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
Propriétés du paramètre
Type:
SwitchParameter
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Jeux de paramètres
(All)
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-Fast
Ajoutez ce paramètre pour ne pas actualiser automatiquement les propriétés différées. Les propriétés différées contiennent des valeurs qui sont relativement inefficaces à récupérer. L’obtention de ces propriétés peut entraîner un trafic réseau supplémentaire et diminuer les performances des applets de commande.
Si vous n’utilisez pas ce paramètre, l’applet de commande affiche un avertissement. Pour désactiver cet avertissement, définissez $CMPSSuppressFastNotUsedCheck = $true.
Propriétés du paramètre
Type:
SwitchParameter
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Jeux de paramètres
(All)
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-ForceWildcardHandling
Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.
Propriétés du paramètre
Type:
SwitchParameter
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Jeux de paramètres
(All)
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-InputObject
Spécifiez un objet de programme malveillant détecté. Pour obtenir cet objet, utilisez l’applet de commande Get-CMDetectedMalware .
Propriétés du paramètre
Type:
IResultObject
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Alias:
Menaces
Jeux de paramètres
SearchByValueMandatoryForViewInfectedClients
Position:
Named
Obligatoire:
True
Valeur du pipeline:
True
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-Name
Spécifiez le nom d’un appareil.
Propriétés du paramètre
Type:
String
Valeur par défaut:
None
Prend en charge les caractères génériques:
True
DontShow:
False
Jeux de paramètres
ByName
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
SearchByValueMandatory
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
SearchByIdMandatory
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
SearchByNameMandatory
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-Resource
Ajoutez ce paramètre pour interroger la classe SMS_Resource pour obtenir des informations sur l’appareil. Cette classe ne doit pas être limitée par l’accès en fonction du rôle. La sortie est identique à celle de l’applet de commande Get-CMResource . Cette sortie a des propriétés minimales pour l’appareil. Pour obtenir des propriétés plus détaillées, n’ajoutez pas ce paramètre ou utilisez le paramètre CollectionMember .
Propriétés du paramètre
Type:
SwitchParameter
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Alias:
ResourceInstance
Jeux de paramètres
(All)
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-ResourceId
Spécifiez l’ID de ressource d’un appareil. Par exemple : 16780010.
Propriétés du paramètre
Type:
Int32
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Alias:
ID, DeviceId
Jeux de paramètres
ById
Position:
Named
Obligatoire:
True
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-ThreatId
Utilisez ce paramètre pour filtrer les appareils qu’il renvoie à ces appareils avec des programmes malveillants spécifiques par ID. Par exemple : 2147735505. Pour obtenir cet ID de menace, utilisez l’applet de commande Get-CMDetectedMalware .
Propriétés du paramètre
Type:
String
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Alias:
ThreatNameId
Jeux de paramètres
SearchByIdMandatoryForViewInfectedClients
Position:
Named
Obligatoire:
True
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-ThreatName
Utilisez ce paramètre pour filtrer les appareils qu’il renvoie à ces appareils avec des programmes malveillants spécifiques par nom. Par exemple : Trojan:Win32/Wacatac.B!ml. Pour obtenir ce nom de menace, utilisez l’applet de commande Get-CMDetectedMalware .
Propriétés du paramètre
Type:
String
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Jeux de paramètres
SearchByNameMandatoryForViewInfectedClients
Position:
Named
Obligatoire:
True
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.