Microsoft VAMT reference: Performs VAMT discovery operations. The syntax and selected example below are adapted from the pinned Windows Server 2025 reference. Module availability, target configuration and delegated permissions determine whether it can run in your environment. Documentation and parameter text: Microsoft, CC BY 4.0; formatting adapted by Cmdlet World. No execution testing is claimed.
Use an account with the target resource permissions documented for Find-VamtManagedMachine. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.
Supported environments
Windows / VAMT · Windows Server 2025 documentation; feature/module prerequisites apply
Parameters
-DbCommandTimeout
Indicates how long dep_nextref_vamt waits for a response from the database before timing out. The default value is 30 seconds.
-DbConnectionString
Specifies the database that the discovered products are added to. If no database connection string is provided, dep_nextref_vamt attempts to use the database that the dep_nextref_vamt user console used on the local computer. If dep_nextref_vamt does not find a database, it returns an error. You can find the connection string in the dep_nextref_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.
-MachineFilter
Restricts the search results when used with the *QueryType* parameter, when the ActiveDirectory value or the WorkGroup value is specified. Do not use the *MachineFilter* parameter when you specify the Manual value for the *QueryType* parameter.
-Password
Provides a password if the environment to be checked for products is password-protected.
-QueryType (required)
Defines what kind of query to use to find the computers. The acceptable values for this parameter are: - Manual. When you use this value, you can manually enter a computer IP address or name. - ActiveDirectory. When you used this value, dep_nextref_vamt searches the Active Directory domain. - Workgroup. When you use this value, dep_nextref_vamt searches the specified workgroup. - LDAP. When you use this value, you can supply a Lightweight Directory Access Protocol (LDAP) query to search for computers that the meet specified conditions. For example, you can use this value in a script to search for new computers that were added to the network in a certain time frame.
-QueryValue (required)
Specifies a query value. The *QueryValue* parameter is required if the *QueryType* parameter is declared. The acceptable values for this parameter are: - If *QueryType* is Manual, *QueryValue* is the IP address or name of the computer. - If *QueryType* is ActiveDirectory, *QueryValue* is the name of Active Directory domain. - If *QueryType* is Workgroup, *QueryValue* is the name of the workgroup. - If *QueryType* is LDAP, *QueryValue* is an LDAP query to search for computers that meet the specified conditions. For example, you can use this value in a script to search for new computers that were added to the network in a certain time frame.
-Username
Provides a user name if the environment to be checked for products is password-protected.
Prerequisites
Windows with the VAMT module and the Windows feature or management tools that provide it. Confirm target connectivity and version compatibility using the linked Microsoft reference.
Security considerations
This is a read-oriented cmdlet; protect any sensitive results and check the documented effects of your selected parameters.
This command finds a computer by looking for the specified computer name. Source: Microsoft, CC BY 4.0; transcript prompt/output removed. This example was not executed.