Description
Use the
tacmd deleteWorkspace command
to delete a global or user-customized Tivoli Enterprise Portal workspace
from the Tivoli Enterprise Portal Server.
Note: If you want to use
the current tacmd tepsLogin values for username, password,
and server hostname, do not enter any of these options for the deleteWorkspace command.
If you specify values for some, but not all of these options, you
are prompted to specify the username and password if they are missing.
CLI syntax
tacmd deleteWorkspace
{-w|--workspace} WORKSPACE | {-i|--objectid} OBJECT_ID }
[ {-r|--workspaceUser} USERID ]
[ {-t|--type} TYPE ]
[ {-o|--deletereadonly} ]
[ {-f|--force} ]
[ {-u|--username} TEPS_USER ]
[ {-p|--password} TEPS_PASSWORD ]
[ {-s|--server} TEPS_HOSTNAME[:PORT] ]
where:
- -w|--workspace
- Specifies the name of the workspace to delete.
- -i|--objectid
- Specifies the object identifier of the workspace to delete. This
option cannot be used with the -w|--workspace option. You can retrieve
the workspace object identifier by running the listworkspaces command
with the -i|--objectid option.
- r|--workspaceUser
- Specifies the Tivoli Enterprise Portal User ID for the workspace
that is to be deleted. If this option is not provided, the global
workspace will be deleted. If you find that you cannot delete a workspace
due to issues with your user credentials, use the -r option.
- -t|--type
- An IBM Tivoli Monitoring application type. If a 2-character type
is entered, the letter 'k' will be prepended automatically to form
a 3-character product code.
- -o|--deletereadonly
- Deletes the workspace even if the workspace was created or saved
with the 'Do not allow modifications' option.
- -u|--username
- Specifies the identifier of the user to authenticate on the Tivoli
Enterprise Portal Server. The user must have both 'Workspace Administration
Mode' and 'Workspace Author Mode' Workspace Administrator permissions
enabled on the server to run the deleteWorkspace command.
The 'Workspace Administration Mode' permission is disabled by default
for most users. The software prompts you for the username if you do
not specify one.
- -p|--password
- Specifies the password of the user to authenticate on the Tivoli
Enterprise Portal Server. The software prompts you for the password
if you do not specify one.
- -s|--server
- Specifies which Tivoli Enterprise Portal Server to use.
- {-f|--force}
- Deletes the workspace without confirmation.
CLI example
The following example deletes
the workspace with the object identifier of klz.System_Information_621:
tacmd deleteworkspace -i klz.System_Information_621
Related commands
Return to Table 1.