Administrator's Reference
Use this command on a configuration manager to delete the association of
one or more objects from a profile. If associations are deleted, the
objects are no longer distributed to subscribing managed servers. When
managed servers request updated configuration information, the configuration
manager notifies them of the object deletions.
Attention: A managed server deletes the objects that were
deleted from the profile, unless the objects are associated with another
profile to which that server subscribes.
Privilege Class
To issue this command, you must have system privilege.
Syntax
>>-DELete PROFASSOCiation--profile_name------------------------->
>-----+-------------------------------------+------------------->
'-ADMins--=----+-*-----------------+--'
| .-,------------. |
| V | |
'----admin_name---+-'
>-----+---------------------------------------+----------------->
'-DOmains--=----+-*------------------+--'
| .-,-------------. |
| V | |
'----domain_name---+-'
>-----+------------------------------------------+-------------->
'-ADSCHeds--=----+-*--------------------+--'
| .-,---------------. |
| V | |
'----schedule_name---+-'
>-----+---------------------------------------+----------------->
'-SCRipts--=----+-*------------------+--'
| .-,-------------. |
| V | |
'----script_name---+-'
>-----+---------------------------------------------+----------->
'-CLOptsets--=----+-*----------------------+--'
| .-,-----------------. |
| V | |
'----option_set_name---+-'
>-----+---------------------------------------+----------------->
'-SERVers--=----+-*------------------+--'
| .-,-------------. |
| V | |
'----server_name---+-'
>-----+-------------------------------------------+------------><
'-SERVERGroups--=----+-*-----------------+--'
| .-,------------. |
| V | |
'----group_name---+-'
Parameters
- profile_name (Required)
- Specifies the profile from which to delete associations.
- ADMins
- Specifies the administrators whose association with the profile is
deleted. You can specify more than one name by separating the names
with commas and no intervening spaces. Use the match-all character (*)
to delete all administrators from the profile. If you specify a list of
administrators and a match-all definition exists for the profile, the command
fails.
Administrator definitions are not changed on the configuration
manager. However, they are automatically deleted from all subscribing
managed servers at the next configuration refresh, with the following
exceptions:
- An administrator is not deleted if that administrator has an open session
on the server.
- An administrator is not deleted if, as a result, the managed server would
have no administrators with system privilege class.
- DOmains
- Specifies the domains whose association with the profile is
deleted. You can specify more than one name by separating the names
with commas and no intervening spaces. Use the match-all character (*)
to delete all domains from the profile. If you specify a list of
domains and a match-all domain definition exists for the profile, the command
fails.
The domain information is automatically deleted from all subscribing
managed servers. However, a policy domain that has client nodes
assigned will not be deleted. To delete the domain at the managed
server, assign those client nodes to another policy domain.
- ADSCHeds
- Specifies a list of administrative schedules whose association with the
profile is deleted. You can specify more than one name by separating
the names with commas and no intervening spaces. If you specify a list
of administrative schedules and a match-all administrative schedule definition
exists for the profile, the command fails. Use the match-all character
(*) to delete all administrative schedules from the profile.
The administrative schedules are automatically deleted from all subscribing
managed servers. However, an administrative schedule is not deleted if
the schedule is active on the managed server. To delete an active
schedule, make the schedule inactive.
- SCRipts
- Specifies the server command scripts whose association with the profile is
deleted. You can specify more than one name by separating the names
with commas and no intervening spaces. Use the match-all character (*)
to delete all scripts from the profile. If you specify a list of
scripts and a match-all script definition exists for the profile, the command
fails. The server command scripts are automatically deleted from all
subscribing managed servers.
- CLOptsets
- Specifies the client option sets whose association with the profile is
deleted. You can specify more than one name by separating the names
with commas and no intervening spaces. Use the match-all character (*)
to delete all client option sets from the profile. If you specify a
list of client option sets and a match-all client option set definition exists
for the profile, the command fails. The client option sets are
automatically deleted from all subscribing managed servers.
- SERVers
- Specifies the servers whose association with the profile is
deleted. You can specify more than one name by separating the names
with commas and no intervening spaces. You can use the match-all
character (*) to delete all servers from the profile. If you specify a
list of servers and a match-all server definition exists for the profile, the
command fails. The server definitions are automatically deleted from
all subscribing managed servers with the following exceptions:
- A server definition is not deleted if the managed server has an open
connection to another server.
- A server definition is not deleted if the managed server has a device
class of the device type SERVER that refers to the other server.
- A server definition is not deleted if the server is the event server for
the managed server.
- SERVERGroups
- Specifies the server groups whose association with the profile is
deleted. You can specify more than one name by separating the names
with commas and no intervening spaces. You can use the match-all
character (*) to delete all server groups from the profile. If you
specify a list of server groups and a match-all group definition exists for
the profile, the command fails. The server group definitions are
automatically deleted from all subscribing managed servers.
Examples
Task
Delete all domain associations from a profile named MIKE.
- Command:
- delete profassociation mike domains=*
Related Commands
Table 86. Commands Related to DELETE PROFASSOCIATION
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.
|
DELETE PROFILE
| Deletes a profile from a configuration manager.
|
LOCK PROFILE
| Prevents distribution of a configuration profile.
|
NOTIFY SUBSCRIBERS
| Notifies servers to refresh their configuration information.
|
QUERY PROFILE
| Displays information about configuration profiles.
|
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.
|
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]