QUERY PROFILE (Query a profile)
Use this command to display information about profiles and associated objects. Issue this command from a configuration manager or from a managed server. You can use this command to get profile information from any configuration manager defined to the server, even if the server does not subscribe to any profile.
If you query a locked profile from the configuration manager to which the profile belongs, complete profile information is displayed. If you query a locked profile from another server, the query displays only that the profile is locked.
Privilege class
Any administrator can issue this command.
Syntax
.-*------------. >>-Query PROFIle--+--------------+------------------------------> '-profile_name-' >--+----------------------------+-------------------------------> | (1) | '-SERVer--=--server_name-----' .-Format--=--Standard-----. .-USELocal--=--Yes-----. >--+-------------------------+--+----------------------+------->< '-Format--=--+-Standard-+-' '-USELocal--=--+-Yes-+-' '-Detailed-' '-No--'
- The server name you specify depends on the server from which you issue the command. See the description of the SERVER parameter.
Parameters
- profile_name
- Specifies the profile to display. To specify multiple names, use a wildcard character. This parameter is optional. The default is to display all profiles.
- SERVer
- Specifies the configuration manager whose profile information is displayed.
The requirements for the name depends on where the query is issued:
- From a configuration manager: This parameter is optional. The default is the configuration manager's name.
- From a managed server: This parameter is optional. The default is the name of the configuration manager for this managed server.
- From a server that is neither a configuration manager nor a managed server: You must specify a name.
- Format
- Specifies whether partial or detailed information is displayed. The default
is STANDARD. Possible values are:
- Standard
- Specifies that partial information is displayed.
- Detailed
- Specifies that detailed information is displayed.
- USELocal
- When you perform the query from a managed server, this parameter specifies
whether the profile information is obtained from the configuration manager
or the managed server. If the profile information does not exist on the managed
server, the information is obtained from the configuration manager, regardless
of the value of this parameter.
If you use this parameter on a server that is not managed by the configuration manager that owns the profile, the parameter is ignored. The default value is YES. Possible values are:
- Yes
- Specifies that the profile information, if available, is obtained from the managed server. The configuration manager is contacted if information is not available from the managed server.
- No
- Specifies that the profile information is obtained from the configuration manager even if the information is available from the managed server. This ensures that you receive current information about the profile.
Example: List profiles from a configuration manager
Display profile information from a configuration manager. See Field descriptions for field descriptions.query profile
Configuration Profile name Locked?
manager
--------------- --------------- ------
SERVER1 DEFAULT_PROFILE No
SERVER1 ADMIN_INFO No
SERVER1 EMPLOYEE No
SERVER1 PERSONNEL Yes
Example: Display detailed profile information for a managed server
From a managed server, display current detailed information for profile ADMIN_INFO. See Field descriptions for field descriptions.query profile admin_info
format=detailed uselocal=no
Configuration manager: SERVER1
Profile name: ADMIN_INFO
Locked: No
Description: Distributed administrative schedules
Server administrators: DENNIS EMILY ANDREA
Policy domains: ADMIN RECORDS
Administrative command schedules: ** all objects **
Server Command Scripts:
Client Option Sets:
Servers:
Server Groups:
Field descriptions
- Configuration manager
- The name of the configuration manager that owns the profile.
- Profile name
- The name of the profile.
- Locked?
- Whether the profile is locked.
- Description
- The description of the profile.
- Server administrators
- The administrators that are associated with the profile.
- Policy domains
- The policy domains that are associated with the profile.
- Administrative command schedules
- The administrative schedules that are associated with the profile.
- Server Command Scripts
- The server command scripts that are associated with the profile.
- Client Option Sets
- The client option sets that are associated with the profile.
- Servers
- The servers that are associated with the profile.
- Server Groups
- The names of server groups that are associated with the profile.
Related commands
Command | Description |
---|---|
COPY PROFILE | Creates a copy of a profile. |
DEFINE PROFASSOCIATION | Associates objects with a profile. |
DEFINE PROFILE | Defines a profile for distributing information to managed servers. |
DEFINE SUBSCRIPTION | Subscribes a managed server to a profile. |
DELETE PROFASSOCIATION | Deletes the association of an object with a profile. |
DELETE PROFILE | Deletes a profile from a configuration manager. |
LOCK PROFILE | Prevents distribution of a configuration profile. |
SET CONFIGMANAGER | Specifies whether a server is a configuration manager. |
UNLOCK PROFILE | Enables a locked profile to be distributed to managed servers. |
UPDATE PROFILE | Changes the description of a profile. |