Purpose
The delete_component command deletes an existing component based on the information in the parameters.
Syntax
dsc delete_component [parameters]
Example
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
Parameters
- 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:
- system
- media_server
- nbu_server
- dd_boost
- disk_file_system
- target_group
- aws_app
- azure_app
- gcp_app
- network_fabric
- r|repository_replication
- Indicates the target group for deletion is a replication target group.
- d|delete_all_data
- 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
Usage Notes
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.