Export (0) Print
Expand All

Windows Assessment Services (WAS) Cmdlets

Windows Server 2012 R2 and Windows 8.1

Updated: October 17, 2013

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Windows PowerShell® is a task-based command-line shell and scripting language designed especially for system administration. This reference topic for the information technology (IT) professional provides assistance in utilizing the Windows PowerShell cmdlets to script and automate tasks.

Windows Assessment Services (WAS)

Windows® Assessment Services is a test framework used to automate running assessments. These assessments measure performance, reliability, and functionality on multiple computers in a lab environment. A subset of the Windows Assessment Services functionality is available in PowerShell cmdlets. These cmdlets can be used to initiate jobs, change evaluation assets, monitor test computers, and customize failure or completion actions. To create and modify job settings, use the Windows® Assessment Services - Client (Windows ASC).

ImportantImportant
At least PowerShell 3.0 is required to use the Windows Assessment Services PowerShell cmdlets.

The Windows® Assessment Services PowerShell module is not imported into Windows PowerShell automatically. You need to import the module manually before you can use the cmdlets it exports.

To import the module, on the server where Windows Assessment Services is installed, open the Windows PowerShell prompt and type:

Import-Module "${env:ProgramFiles(x86)}\Windows Kits\8.1\Assessment and Deployment Kit\Windows Assessment Toolkit\Windows Assessment Services\waspsext.psd1"

You must import the module into each session in which you want to use it. To import the module into every Windows PowerShell session, add the command to import the module to your AllUsers-AllHosts profile ($Profile.AllUsersAllHosts). For more information about this procedure, see about_Profiles.

 

Cmdlet Description

Get-WASAssessment

Gets a list of available assessments.

Get-WASComputer

Gets a list of available test computers.

Get-WASImage

Gets a list of Windows images.

Get-WASJob

Gets a list of the available jobs.

Get-WASJobInstance

Gets a list of job instances.

Get-WASJobInstanceStatus

Gets the current status of a job instance.

Invoke-WASJob

Creates and runs a job instance.

Register-WASImage

Imports a Windows image into inventory.

Reset-WASComputer

Drops a computer from all running job instances.

Resume-WASComputer

Releases a hold on a test computer, and continues with the next action.

Skip-WASJobInstance

Drops a computer from the running job instance.

Stop-WASJobInstance

Cancels the specified job instance.

Update-WASJob

Adds assets and assessments to a specified job.

noteNote
To list all the cmdlets that are available, use the Get-Command –Module WasPSExt cmdlet.

For more information about, or for the syntax of, any of the cmdlets, use the Get-Help <cmdlet name> cmdlet, where <cmdlet name> is the name of the cmdlet that you want to research. For more detailed information, you can run any of the following cmdlets:

Get-Help <cmdlet name> -Detailed
Get-Help <cmdlet name> -Examples
Get-Help <cmdlet name> -Full

See Also

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft