Edit

Invoke-WASJob

  • Reference
Module:
WasPSExt

Creates and runs a job instance.

Syntax

Invoke-WASJob
      [-Job] <WASJob[]>
      [[-Runtag] <String>]
      [[-Testpass] <String>]
      [<CommonParameters>]

Description

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

Examples

Example 1: Run a job

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

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

Example 2: Run a job specifying runtag and testpass

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

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.

Parameters

-Job

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

Type:WASJob[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Runtag

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

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Testpass

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

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False