Get-CMDataCollectionTasks

Applies To: System Center 2012 Configuration Manager Support Center

Get-CMDataCollectionTasks

Gets the data collection tasks that apply to a Configuration Manager client computer.

Syntax

Parameter Set: Default
Get-CMDataCollectionTasks [-MatchName <String[]> ] [-PipelineVariable <String> ] [ <CommonParameters>]

Detailed Description

The Get-CMDataCollectionTasks cmdlet gets the data collection tasks that apply to a System Center 2012 Configuration Manager client computer.

Parameters

-MatchName<String[]>

Specifies an array of strings to match. The cmdlet gets data collection tasks that have names that include one or more strings in the array. For example, if you specify the string "client" for this parameter, the cmdlet gets each data collection task that contains the string "client" in its task name.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PipelineVariable<String>

Specifies a variable to use with the pipeline operator.

Aliases

pv

Required?

false

Position?

named

Default Value

none

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 (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Examples

Example 1: Get data collection tasks

This example establishes a remote connection to a Configuration Manager client, gets data collection tasks, and starts data collection.

The first command uses the ConvertTo-SecureString cmdlet to create a secure string based on the specified password, and then stores that string in the $Password variable. For more information, type Get-Help ConvertTo-SecureString.

The second command uses the New-CMMachineConnection cmdlet to create a connection to a remote computer by using the specified user name and the password stored in the $Password variable. The command verifies that it creates the connection.

The third command uses the current cmdlet to get data collection tasks, and stores them in the $Tasks variable.

The final command uses the Invoke-CMDataCollection cmdlet to start data collection of the tasks stored in $Tasks. The command specifies an output file.

PS C:\> $Password = ConvertTo-SecureString -AsPlainText -String "Password123" -Force
PS C:\> $Connection = New-CMMachineConnection -MachineName "Client01.corp.contoso.com" -UserName "CONTOSO\PattiFuller" -Password $Password -Verify
PS C:\> $Tasks = Get-CMDataCollectionTasks
PS C:\> Invoke-CMDataCollection -MachineConnection $Connection -CollectionTasks $Tasks -OutputFile "C:\DataCollection\Client01Data"

Invoke-CMDataCollection

New-CMMachineConnection