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
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
- network_fabric
- 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, AWS S3 storage account, Azure Blob storage 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
- 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.