Windows Assessment Services Cmdlets in Windows PowerShell

Published: March 30, 2012

Updated: September 15, 2012

Applies To: Windows 8, Windows Server 2012

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

PowerShell 3.0 is required. If you install Windows Assessment Services on Windows Server 2008 R2, only PowerShell 2.0 is available by default. You must upgrade to PowerShell 3.0 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.0\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.

If the module is not imported into the session, the following limitations apply:

  • You cannot use the commands from the module in the session.

  • Get-Command will not get commands in the module.

  • Show-Command will not show the commands in the module.

  • Update-Help and Save-Help cannot update or save help for the module.

Windows Assessment Services cmdlets


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.

See Also