Invoke-WASJob
Applies To: Windows 8, Windows Server 2012
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.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Runtag<String>
Specifies the run tag you want to add to the job. If not specified, the default run tag is used.
Aliases |
none |
Required? |
false |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Testpass<String>
Specifies the test pass you want to label the job with. If not specified, the default test pass is used.
Aliases |
none |
Required? |
false |
Position? |
3 |
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.
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"