Windows Assessment Services Cmdlets in Windows PowerShell

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

Important

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

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.

See Also

Other Resources

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