dmsweep--DSM Deployment Command Line Interface › dmsweep Subcommands › dmsweep scan

dmsweep scan

The dmsweep scan command scans the specified target addresses, determines which addresses are active and available for deployment, and determines if the target computers have the requested package installed.

The subcommand has the following format:

scan [/manager <manager_machine>] 

[/musername <manager_username> /mpassword <manager_password>] 
[/mfilename <manager_filename>]  
{/ip <address_wild> [/toip <stop_address>] 
 | /ipfilename <ip_filename> 
 | /domain <domain_name> (WinNT only) 
 | /uri <uniform resource identifier> 
 | /targetcred <target_credentials_file> 
 | /query <query_name>}
{/packagenum <package_number> 
 |  /product <product_name> /package <package_name> 
 [/version <version>] 
 [/platform <platform>] 
 [/language <language>]}

/manager

Specifies the name of the manager from which to retrieve the package list. If you omit /manager, the current machine is assumed.

/musername

Specifies the username for the manager computer.

If <manager_username> is omitted the user will be prompted for it.

/mpassword

Specifies the password for the manager computer.

If <manager_password> is not supplied, dmsweep will prompt the value.

/mfilename

Lets you read the name of the manager and details of its username and password from a file.

/ip

Start address or addresses from which to scan.

You can specify an address as a machine name, if it can be successfully resolved (for example, by DNS), or as an IP address (for example 10.0.0.1). The <address_wild> argument enables you to use asterisks (for example, 10.0.0.* covers the range 10.0.0.1 to 10.0.0.254 and 10.0.*.* covers the range 10.0.0.1 to 10.0.255.254.

You can specify a single address for <address_wild> or a comma-separated list of addresses.

Note: This parameter is the start address only when the /toip option is also used.

/toip

End address for the range to scan.

This option can only be used in conjunction with /ip. When used the scan starts with the address specified by <address_wild> and stops after scanning <stop_address>.

/ipfilename

If you specify /ipfilename, the command reads the list of target machines is from the file <ip_filename>. Each line of the file contains a single target address or multiple addresses separated by commas, for example:

machine1

machine2, machine3, 10.0.0.1

machine5

/domain

If a deployment manager is on a Windows-based computer, you can use /domain to scan the computers in the specified domain.

/uri

If you specify /uri you can use a uniform resource identifier to specify target computers to read from an external directory.

/targetcred

If you specify /targetcred, the command reads the list of target machines and connection credentials from the file <target_credentials_file>.

/query

If /query is specified, the list of targets will be generated when the unmanaged asset query identified by <query_name> is run.

/packagenum

Package number of the package to be scanned for. The output from the 'dmsweep packages' command describes the valid values.

/product

Property of the package to be scanned for. The output from the dmsweep packages command describes the valid values.

/package

Property of the package to be scanned for. The output from the dmsweep packages command describes the valid values.

/version

Version of the package to be scanned for. The output from the dmsweep packages command describes the valid values. Optional but if you do not supply enough information to uniquely identify the package, an error is displayed.

/platform

Platform property of the package to be scanned for. The output from the dmsweep packages command describes the valid values. Optional but if you do not supply enough information to uniquely identify the package, an error is displayed.

/language

Language property of the package to be scanned for. The output from the dmsweep packages command describes the valid values. Optional but if you do not supply enough information to uniquely identify the package, an error is displayed.

Example:

The following example shows how you can use the dmsweep command line utility. Replace values such as the package number, target computers and manager machines with suitable values.

To scan a target computer to find out if a package is already installed, enter the following command:

dmsweep scan /ip <target machine> /pn 2