Invoke-WASJob

Invoke-WASJob

Creates and runs a job instance.

Syntax

Parameter Set: Default
Invoke-WASJob [-Job] <WASJob[]> [[-Runtag] <String> ] [[-Testpass] <String> ] [ <CommonParameters>]

Detailed Description

The Invoke-WASJob cmdlet creates a new job instance in Windows Assessment Services. It also initiates a run of the job instance. The Job parameter is required.

Parameters

-Job<WASJob[]>

Specifies the job to invoke. This is a required parameter.

-Runtag<String>

Specifies the run tag you want to add to the job. If not specified, the default run tag is used.

-Testpass<String>

Specifies the test pass you want to label the job with. If not specified, the default test pass is used.

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

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: Run a job

This command gets all the jobs with "automated" in the job name, saves it as a variable, and runs the jobs.

PS C:\> $job = Get-WASJob -JobName *automated*
PS C:\> Invoke-WASJob -Job $job

Example 2: Run a job specifying runtag and testpass

This command gets all the jobs with "automated" in the job name, saves it as a variable, and runs the jobs adding run tag and test pass metadata to the job.

PS C:\> $job = Get-WASJob -JobName *automated*
PS C:> Invoke-WASJob -Job $job -RunTag "Test iteration 5" -TestPass "Spring 2012"

Related topics

Get-WASJob

Update-WASJob

Windows Assessment Services Technical Reference