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.
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.
Example: Delete the domain associations for a specific profile
Delete
all domain associations from a profile named MIKE.
delete profassociation mike domains=*