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.
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 (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"