Get-WASJob
Get-WASJob
Gets a list of the available jobs.
Syntax
Parameter Set: JobId
Get-WASJob [-JobID] <Guid[]> [ <CommonParameters>]
Parameter Set: JobName
Get-WASJob [[-JobName] <String[]> ] [-ProjectName <String[]> ] [ <CommonParameters>]
Detailed Description
The Get-WASJob cmdlet returns a list of the jobs that are available on the Windows Assessment Services server. It also displays metadata, such as assessments, the project name, and assets associated with each job. You can use the object returned to initiate a run of the job instance using the Invoke-WASJob command.
Parameters
-JobID<Guid[]>
Specifies the ID of the job that you want to get. If this parameter is not specified, all jobs are listed.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-JobName<String[]>
Specifies the name of the job that you want to get. The full name of the job isn't required. Wildcards are accepted. If this parameter isn't specified, all jobs are listed.
Aliases |
none |
Required? |
false |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ProjectName<String[]>
Specifies the project name associated with the job that you want to get. The full name of the project isn't required. Wildcards are accepted. If this parameter isn't specified, all jobs are listed.
Aliases |
none |
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 (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: Get all jobs that match a specific search string
This command returns all the jobs with a job name that starts with "driver".
PS C:\> Get-WASJob -JobName Driver*
Example 2: Get all jobs and display first job in list
This command gets all jobs, saves it to a variable, and then displays the first job in the list.
PS C:\> $jobs = Get-WASJob
PS C:\> $jobs[0]
This command lists all the assets associated with the first job in the list returned by the previous command.
PS C:\> $jobs[0].Assets