Previous Topic: delete—Delete Target ComputerNext Topic: Example


list—List Target Computers

This action displays a list of targets known to the system.

An additional filter can be specified to restrict the list to only those targets that fulfill the filter criteria. If no filters are given, the complete list of targets is shown.The filter is limited to 100 bytes.

Note: The filter usage of This action differs from that of other commands.

This action has the following format:

targetcomputer action=list 
[{filter=filter|filterfile=file_name}]
[{DisHwOnly | usrProfOnly | UnMgdPcOnly}]
filter

Specifies the expression to confine the amount of information listed

The following attributes are valid to build atomic filter expressions:

Attribute

Type

Compare ops

Computer name

string

=, !=, <, <=, >, >=

Computer type

{ computer |
user profile |
staging server |
docking device}

=, !=

Host name

string

=, !=, <, <=, >, >=

Primary network address

string

=, !=, <, <=, >, >=

IP address

string

=, !=, <, <=, >, >=

Operating system type

any valid os type of the os parameter of the create action

=, !=

Calendar name

string

=, !=, <, <=, >, >=

Owner

string

=, !=, <, <=, >, >=

Phone

string

=, !=, <, <=, >, >=

Location

string

=, !=, <, <=, >, >=

Comment

string

=, !=, <, <=, >, >=

staging server name

string

=, !=, <, <=, >, >=

Software managed system

{ yes | no }

=, !=

RAC policy

{ automatic |
common |
deferred |
disabled | offline}

=, !=

Creation date

YYYY-MM-DD hh:mm:ss

=, !=, <, <=, >, >=

Change date

YYYY-MM-DD hh:mm:ss

=, !=, <, <=, >, >=

When building a filter, the attribute names in the atomic expressions are case insensitive.

YYYY-MM-DD hh:mm:ss means a date and time notation in ISO format.

The values for attributes of type string may contain wildcards,

“*” or “?”, where “*” represents an arbitrary even empty string of characters, while “?” represents a single but arbitrary character. If a “*” or “?” should not be interpreted as a wildcard then it should be preceded by an apostrophe (‘). In order to avoid ambiguity, apostrophes as part of the attribute value should be duplicated.

filterfile

Specifies the name of the file that contains the filter commands.

The commands in the file are specified in the same way as in the filter parameter, but the size of the file is limited by the capacity of the system that runs this command..

{DisHwOnly | UsrProfOnly | UnMgdPcOnly}

These options are used to restrict the search on information the user is interested in. If not coded a list of computer, user profiles, scalability servers, docking devices, and OSIM un-managed computers is provided and all related database tables are searched.

DisHwOnly

The list is restricted to registered hardware like computers, scalability servers and docking devices.

UsrProfOnly

The list is restricted to user profiles only

UnMgdPcOnly

The list is restricted to OSIM un-managed computers only.