Get-VamtProduct

Applies To: Windows 8, Windows Server 2012

Get-VamtProduct

Retrieves the record of a product or list of products from a VAMT database.

Syntax

Parameter Set: Default
Get-VamtProduct [[-ProductName] <String> ] [-DbCommandTimeout <Int32> ] [-DbConnectionString <String> ] [ <CommonParameters>]

Detailed Description

The Get-VamtProduct cmdlet retrieves the record of a product or list of products from a VAMT database. The results are saved to a file, or a Microsoft.Licensing.VolumeActivation.Product object is returned.

Parameters

-DbCommandTimeout<Int32>

Indicates how long VAMT waits for a response from the database before timing out. The default value is 30 seconds. You can use the DbCommandTimeout parameter to change the timeout value.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-DbConnectionString<String>

Specifies the database that the product or list of products are retrieved from. If no database connection string is provided, VAMT attempts to use the database that the VAMT user console used on the local computer. If VAMT does not find a database, it returns an error. You can find the connection string in the VAMT UI in the Preferences dialog box. On the menu bar, click View, and then click Preferences to open the Volume Activation Management Tool Preferences dialog box. The connection string is in the Database Settings section under Current connection string.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-ProductName<String>

Specifies the product information to retrieve. If the ProductName parameter is not included, VAMT retrieves all product information in the VAMT database.

Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue, ByPropertyName)

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

This command outputs the list of all products in the VAMT database to the specified file.

PS C:\> get-vamtproduct > c:\users\me\windowslist.txt

Example 2

This command returns all “Windows” products whose license status does not equal “licensed”.

PS C:\> $products = get-vamtproduct -productname windows | where { $_.licensestatus -ne 'Licensed' }

Update-VamtProduct

VAMT Cmdlets