Freigeben über


Invoke-CMEndpointProtectionScan

Ruft eine Überprüfung auf, um Schadsoftware auf einem oder mehreren Geräten in der Configuration Manager-Hierarchie zu erkennen.

Syntax

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

Beschreibung

Das Cmdlet Invoke-CMEndpointProtectionScan ruft eine System Center 2016 Endpoint Protection-Überprüfung auf, die außerhalb geplanter Überprüfungen liegt. Sie können das Gerät oder die Sammlung angeben, indem Sie seinen Namen, seine ID oder ein Objekt angeben, das das Gerät oder die Sammlung darstellt.

Weitere Informationen zur Unterstützung von Endpoint Protection von Configuration Manager finden Sie unter Endpoint Protection in Configuration Manager.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Aufrufen einer vollständigen Endpoint Protection-Überprüfung

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

Dieser Befehl ruft eine vollständige Endpoint Protection-Überprüfung des Geräts mit dem Namen CMCEN-DIST02 auf.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Device

Gibt das Gerät an, das auf Schadsoftware überprüft wird.

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DeviceCollection

Gibt ein -Objekt an, das eine Gerätesammlung darstellt, deren Member auf Schadsoftware überprüft werden.

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceCollectionId

Gibt die ID einer Gerätesammlung an, deren Mitglieder auf Schadsoftware überprüft werden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceCollectionName

Gibt den Namen einer Gerätesammlung an, deren Mitglieder auf Schadsoftware überprüft werden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceId

Gibt die ID eines Geräts an, das auf Schadsoftware überprüft wird.

Typ:String
Aliase:ResourceID
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceName

Gibt den Namen eines Geräts an, das auf Schadsoftware überprüft wird.

Typ:String
Aliase:Name
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScanType

Gibt einen vollständigen oder einen Schnellscan an. Bei einer vollständigen Überprüfung wird jeder Standort auf dem Gerät überprüft. Bei einer Schnellüberprüfung werden nur die Orte untersucht, an denen Schadsoftware am wahrscheinlichsten angezeigt wird. Die zulässigen Werte für diesen Parameter sind: Vollständig und Schnell.

Typ:ScanType
Zulässige Werte:Full, Quick
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object