Get-WASComputer
Applies To: Windows 8, Windows Server 2012
Get-WASComputer
Gets a list of available test computers.
Syntax
Parameter Set: ComputerId
Get-WASComputer [-ComputerID] <Guid[]> [ <CommonParameters>]
Parameter Set: ComputerName
Get-WASComputer [[-ComputerName] <String[]> ] [ <CommonParameters>]
Detailed Description
The Get-WASComputer cmdlet gets a list of all the test computers that are in the Windows Assessment Services inventory. The list includes all the computer metadata.
Parameters
-ComputerID<Guid[]>
Specifies the Windows Assessment Services computer ID for the computer you want to get. If this parameter is not specified, all computers in the inventory are listed. You must use the computer ID that is recorded in the Windows Assessment Services inventory, not the computer GUID.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ComputerName<String[]>
Specifies the name of the computer that you want to get. This is the computer name recorded in the Windows Assessment Services inventory. This parameter is optional. You can also specify the computer name without the parameter. The full name of the computer isn't required. Wildcards are accepted.
Aliases |
none |
Required? |
false |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.
Examples
Example 1: Get all computers
This command gets all the computers included in the Windows Assessment Services inventory.
PS C:\> Get-WASComputer
Example 2: Get all computers and output the data to a table
This command gets all the computers and formats the output as a table.
PS C:\> Get-WASComputer | Format-Table -Property ComputerName,ComputerId,Location,StatusMessage
Example 3: Get all computers that match a specific search string
This command gets all the computers with a name that matches the search string "toast", and outputs the data to a table.
PS C:\> Get-WASComputer *toast | Format-Table -Property ComputerName,ComputerId,Location,StatusMessage
Example 4: Get all computers with a specific ID
This command gets a computer with a specific ID.
PS C:\> Get-WASComputer -ComputerId d52a668a-a138-48a6-8cdb-000000000000
Example 5: Get all computers containing a specific device
This command gets all computers that contain a specific device, and formats the output as a table.
PS C:\> $Computers = foreach ($comp in Get-WasComputer) { foreach ($device in $comp.Devices) { if ($device.Name -eq "Broadcom 802.11g Network Adapter") { $comp } } }
PS C:\> Format-Table -Property ComputerName,ComputerId,Location,StatusMessage -InputObject $computers
Example 6: Get all computers running an action
This command gets all computers that are currently running an action, and formats the output as a table.
PS C:\> Get-WASComputer | where {$_.CurrentAction -ne $null} | Format-Table -Property ComputerName,ComputerId,Location