Windows Assessment Services Cmdlets in Windows PowerShell

  • Article

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 .

Important

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

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.

Note

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)