Partager via


Invoke-CMEndpointProtectionScan

Appelle une analyse pour détecter les programmes malveillants sur un ou plusieurs appareils de la hiérarchie Configuration Manager.

Syntaxe

Invoke-CMEndpointProtectionScan
      -DeviceCollection <IResultObject>
      [-ScanType <ScanType>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMEndpointProtectionScan
      -Device <IResultObject>
      [-ScanType <ScanType>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMEndpointProtectionScan
      -DeviceCollectionId <String>
      [-ScanType <ScanType>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMEndpointProtectionScan
      -DeviceCollectionName <String>
      [-ScanType <ScanType>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMEndpointProtectionScan
      -DeviceId <String>
      [-ScanType <ScanType>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMEndpointProtectionScan
      -DeviceName <String>
      [-ScanType <ScanType>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Invoke-CMEndpointProtectionScan appelle une analyse System Center 2016 Endpoint Protection en dehors des analyses planifiées. Vous pouvez spécifier l’appareil ou le regroupement à l’aide de son nom, de son ID ou en spécifiant un objet qui représente l’appareil ou le regroupement.

Pour plus d’informations sur la façon dont Configuration Manager prend en charge Endpoint Protection, consultez Endpoint Protection dans Configuration Manager.

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 : Appeler une analyse Endpoint Protection complète

PS XYZ:\>Invoke-CMEndpointProtectionScan -DeviceName "CMCEN-DIST02" -ScanType Full

Cette commande appelle une analyse Endpoint Protection complète de l’appareil nommée CMCEN-DIST02.

Paramètres

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

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

-Device

Spécifie l’appareil qui est analysé pour rechercher des programmes malveillants.

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

-DeviceCollection

Spécifie un objet qui représente un regroupement d’appareils dont les membres sont analysés pour rechercher des programmes malveillants.

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

-DeviceCollectionId

Spécifie l’ID d’un regroupement d’appareils dont les membres sont analysés pour rechercher des programmes malveillants.

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

-DeviceCollectionName

Spécifie le nom d’un regroupement d’appareils dont les membres sont analysés pour rechercher des programmes malveillants.

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

-DeviceId

Spécifie l’ID d’un appareil analysé pour rechercher des programmes malveillants.

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

-DeviceName

Spécifie le nom d’un appareil qui est analysé pour rechercher des programmes malveillants.

Type:String
Alias:Name
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

-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

-ScanType

Spécifie une analyse complète ou rapide. Une analyse complète examine chaque emplacement sur l’appareil. Une analyse rapide examine uniquement les emplacements où les programmes malveillants sont les plus susceptibles d’apparaître. Les valeurs acceptables pour ce paramètre sont : Complète et Rapide.

Type:ScanType
Valeurs acceptées:Full, Quick
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object