Export (0) Print
Expand All

Find-VamtManagedMachine

Windows Server 2012 R2 and Windows 8.1

Updated: October 17, 2013

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Find-VamtManagedMachine

Performs VAMT discovery operations.

Syntax

Parameter Set: Default
Find-VamtManagedMachine [-QueryType] <DiscoveryType> [-QueryValue] <String> [[-MachineFilter] <String> ] [[-Username] <String> ] [[-Password] <String> ] [-DbCommandTimeout <Int32> ] [-DbConnectionString <String> ] [ <CommonParameters>]




Detailed Description

The Find-VamtManagedMachine cmdlet discovers products either on an individual computer or in a specified domain or workgroup, and then adds them to the VAMT database. You can use this cmdlet in a script to periodically run product discovery on a domain or workgroup. You can use this process to determine whether any new computers are present in the domain or workgroup.

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 discovered products are added to. 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 (ByPropertyName)

Accept Wildcard Characters?

false

-MachineFilter<String>

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.


Aliases

none

Required?

false

Position?

3

Default Value

none

Accept Pipeline Input?

true (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-Password<String>

Provides a password if the environment to be checked for products is password-protected.


Aliases

none

Required?

false

Position?

6

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-QueryType<DiscoveryType>

Defines what kind of query to use to find the computers. The following values apply to the QueryType parameter:

     -- Manual: When you use this value, you can manually enter a computer IP address or name.

     -- ActiveDirectory: When you used this value, VAMT searches the Active Directory domain.

     -- Workgroup: When you use this value, 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 within a certain time frame.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-QueryValue<String>

The QueryValue parameter is required when the QueryType parameter is declared. The QueryValue parameter supplies the following values for the specified QueryType:

     -- 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 within a certain time frame.


Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-Username<String>

Provides a user name if the environment to be checked for products is password-protected.


Aliases

none

Required?

false

Position?

5

Default Value

none

Accept Pipeline Input?

true (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 finds a computer by looking for the specified computer name.


PS C:\> find-vamtmanagedmachine -querytype manual -queryvalue machinename

Example 2

This command searches the specified Active Directory domain. The search results are restricted to the computers with LabComp in their name.


PS C:\> find-vamtmanagedmachine -querytype activedirectory -queryvalue domainname -machinefilter labcomp*

Example 3

This command searches the specified workgroup. The search results are restricted to the computers with LabComp in their name.


PS C:\> find-vamtmanagedmachine -querytype workgroup -queryvalue workgroupname -machinefilter labcomp*

Example 4

This command searches for computers by using an LDAP query. The search results are restricted to the computers with LabComp in their name.


PS C:\> find-vamtmanagedmachine -querytype ldap -queryvalue "ldap://domainname/??sub?(&(objectclass=computer)(name=labcomp*))"

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft