Windows Assessment Services Cmdlets in Windows PowerShell

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)

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


At least PowerShell 3.0 is required to use the PowerShell cmdlets.

The 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 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


Gets a list of available assessments.


Gets a list of available test computers.


Gets a list of Windows images.


Gets a list of the available jobs.


Gets a list of job instances.


Gets the current status of a job instance.


Creates and runs a job instance.


Imports a Windows image into inventory.


Drops a computer from all running job instances.


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


Drops a computer from the running job instance.


Cancels the specified job instance.


Adds assets and assessments to a specified job.


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

Other Resources

Windows Assessment Services Technical Reference
Windows Assessment and Deployment Kit (Windows ADK)