Get-CMDevice

Référence

Module:: ConfigurationManager

Obtenir un appareil Configuration Manager.

Syntaxe

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

L’applet de commande Get-CMDevice obtient un appareil Configuration Manager. Par défaut, il interroge la classe SMS_CM_RES_COLL_SMS00001 . Vous pouvez utiliser les paramètres Resource ou CollectionMember pour modifier la classe de requête. 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, cette applet de commande ne retourne aucun résultat par défaut.

Remarque

Exécutez des applets de commande Configuration Manager à 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.

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

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.

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}

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.

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

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.

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

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 .

Type:	IResultObject
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-CollectionId

Spécifiez un ID pour un regroupement d’appareils. Par exemple : XYZ0004B.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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.

Type:	SwitchParameter
Alias:	CollectionMemberInstance
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-CollectionName

Spécifiez le nom d’un regroupement d’appareils.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-InputObject

Spécifiez un objet de programme malveillant détecté. Pour obtenir cet objet, utilisez l’applet de commande Get-CMDetectedMalware .

Type:	IResultObject
Alias:	Threat
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Name

Spécifiez le nom d’un appareil.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	True

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

Type:	SwitchParameter
Alias:	ResourceInstance
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResourceId

Spécifiez l’ID de ressource d’un appareil. Par exemple : 16780010.

Type:	Int32
Alias:	Id, DeviceId
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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 .

Type:	String
Alias:	ThreatNameId
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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 .

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject[]

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_CombinedDeviceResources classe WMI du serveur.

Partager via

Get-CMDevice

Syntaxe

Description

Exemples

Exemple 1 : Obtenir des appareils par ID de regroupement

Exemple 2 : Obtenir des ressources d’appareil par ID de regroupement

Exemple 3 : Obtenir les propriétés d’un appareil spécifique

Exemple 4 : Obtenir des appareils qui ne sont pas clients

Exemple 5 : Obtenir des appareils pour un nom de menace spécifique

Exemple 6 : Obtenir tous les appareils avec des programmes malveillants détectés

Paramètres

-Collection

-CollectionId

-CollectionMember

-CollectionName

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-InputObject

-Name

-Resource

-ResourceId

-ThreatId

-ThreatName

Entrées

Sorties

Notes

Commentaires

Ressources supplémentaires

Partager via

Get-CMDevice

Syntaxe

Description

Exemples

Exemple 1 : Obtenir des appareils par ID de regroupement

Exemple 2 : Obtenir des ressources d’appareil par ID de regroupement

Exemple 3 : Obtenir les propriétés d’un appareil spécifique

Exemple 4 : Obtenir des appareils qui ne sont pas clients

Exemple 5 : Obtenir des appareils pour un nom de menace spécifique

Exemple 6 : Obtenir tous les appareils avec des programmes malveillants détectés

Paramètres

-Collection

-CollectionId

-CollectionMember

-CollectionName

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-InputObject

-Name

-Resource

-ResourceId

-ThreatId

-ThreatName

Entrées

Sorties

Notes

Liens associés

Commentaires

Ressources supplémentaires