Get-VamtProduct
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 database. The results are saved to a file, or a Microsoft.Licensing.VolumeActivation.Product object is returned.
Parameters
-DbCommandTimeout<Int32>
Indicates how long 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, attempts to use the database that the user console used on the local computer. If does not find a database, it returns an error. You can find the connection string in the 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, retrieves all product information in the 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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Examples
Example 1
This command outputs the list of all products in the 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' }