Delete

The delete command is used to delete an item or entity or remove a config section or sub-section. The command requires a unique value to identify the record. This is used for the entity's label field.

Similar to the add command, delete makes the change in a temporary state and affects configuration only when applied.

You can use the delete command on:

  • Existing configuration

  • Unapplied changes

When used on unapplied changes, this behaves in the same way as the discard command.

Parameters
entity The entity from which to delete the item.
Item-label The label that identifies the item to delete.
Syntax
delete <entity> <optional-entity> <item-label>
Example

delete user aconsoleuser
config:

Removing an element

From the users context:

delete "username"

Single line command

delete user "username"
apply

Either of the above examples result in exiting the context of an item being deleted.

Refer to the apply command for how this behaves.