Export (0) Print
Expand All
Expand Minimize

Invoke-CMEndpointProtectionScan

Updated: February 7, 2014

Applies To: System Center 2012 R2 Configuration Manager

Invoke-CMEndpointProtectionScan

Invokes a scan to detect malware on one or more devices in the Configuration Manager hierarchy.

Syntax

Parameter Set: SearchByDeviceIdMandatory
Invoke-CMEndpointProtectionScan -DeviceId <String> [-ScanType <ScanType> {Full | Quick} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByDeviceNameMandatory
Invoke-CMEndpointProtectionScan -DeviceName <String> [-ScanType <ScanType> {Full | Quick} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByDeviceValueMandatory
Invoke-CMEndpointProtectionScan -Device <IResultObject> [-ScanType <ScanType> {Full | Quick} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByIdMandatory
Invoke-CMEndpointProtectionScan -DeviceCollectionId <String> [-ScanType <ScanType> {Full | Quick} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByNameMandatory
Invoke-CMEndpointProtectionScan -DeviceCollectionName <String> [-ScanType <ScanType> {Full | Quick} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Invoke-CMEndpointProtectionScan -DeviceCollection <IResultObject> [-ScanType <ScanType> {Full | Quick} ] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

The Invoke-CMEndpointProtectionScan cmdlet invokes a System Center 2012 Endpoint Protection scan that is outside of any scheduled scans. You can specify the device or collection by using its name, ID, or by specifying an object that represents the device or collection.

For more information about how Configuration Manager supports Endpoint Protection, see Endpoint Protection in Configuration Manager (http://go.microsoft.com/fwlink/?LinkId=268427) on TechNet.

Parameters

-Device<IResultObject>

Specifies the device that is scanned for malware.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DeviceCollection<IResultObject>

Specifies an object that represents a device collection whose members are scanned for malware.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DeviceCollectionId<String>

Specifies the ID of a device collection whose members are scanned for malware.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DeviceCollectionName<String>

Specifies the name of a device collection whose members are scanned for malware.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DeviceId<String>

Specifies the ID of a device that is scanned for malware.


Aliases

ResourceID

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DeviceName<String>

Specifies the name of a device that is scanned for malware.


Aliases

Name

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ScanType<ScanType>

Specifies a full or a quick scan. A full scan looks at every location on the device. A quick scan looks at only those locations where malware is most likely to appear.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Invoke a full Endpoint Protection scan

This command invokes a full Endpoint Protection scan of the device named CMCEN-DIST02.


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

Related topics

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft