DELETE PROFASSOCIATION (Delete a profile association)

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=*

Related commands

Table 1. 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.