The delete_component command deletes an existing component based on the information in the parameters.
dsc delete_component [parameters]
dsc delete_component -n system1 -t target_group -S
dsc delete_component -t target_group -r -n replication-tg-S3
dsc delete_component -t target_group -r -n replication-tg-S3 -d
- n|name Name
- The name of the BAR component. The name must be unique.
- t|type Type
The type of BAR component. Enter one of the following:
- Example: target_group
- Indicates the target group for deletion is a replication target group.
- Deletes the replication target group and all save set files associated with it. Be very careful if you choose to use this parameter.
- S|skip_prompt SkipPrompt
- [Optional] Skips displaying a confirmation message before performing the command action.
- u|user_authentication User
- Required when security management is enabled. Supplies the command with the Viewpoint user, and triggers a password prompt for authentication.
Permissions required: Administrator role
To use the delete_component command, you must specify the component name and type. You do not need to specify the component name for disk_file_system types.
You can delete a system, media server, NetBackup server, disk file system, DD Boost server, Amazon S3 storage account, Azure Blob storage account, Google Cloud Account or a target group, except under the following conditions:
- System marked for repository backup
- System in use by a job
- Media server in use by a target group
- NetBackup server in use by a target group
- Target group in use by a job
- Target group in use by a target group map
- Target group in use for repository backups, unless it is a repository_replication target group
- Policy used by a target group
Beginning with the DSA 16.10 release, nodes are autodiscovered and cannot be manually deleted.
XML File Example
This command does not support an XML file.