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