Web Services Reference › Methods › Units and Groups › Units › FindComputer

More information:

ComputerProperties

ComputerPropertiesRequired

FindComputer

The FindComputer method finds a computer unit given its name.

Parameters

xsd:string sessionId (^m)

The session identifier.

xsd:string computerName (^m)

The computer name to search for. This may contain wildcard characters (*).

Xsd:long noOfComputers

The number of computers that should be returned from the search if more than one match is found.

ComputerPropertiesRequired computerPropertiesRequired

This parameter specifies which computer properties to retrieve. Mandatory if noOfComputers is greater than 0.

Return Values

ArrayOfComputerProperties FindComputerReturn

An array of computer properties structures, one for each computer matched by the search. This array will either be of the size of the number of computers matched by the search, or of the number of computers requested by the method call - whichever size is the lowest.

xsd:long totalNoOfComputersFound

The total number of computers that were matched by the search. You can use this to indicate that there were more matches found than the requested number of computers.

Remarks

The method supports wildcard pattern matching for the computer name. The name is case insensitive.