CLI Reference > Configuration Management Commands > si deleterevision
si deleterevision
permanently deletes a revision from a member
si deleterevision [--[no]confirm] [--[no]confirminuse] [-f] [--range=value] [(-R|--[no|confirm]recurse)] [--filter=filteroptions] [(-P project|--project=project)] [--[no]failOnAmbiguousProject] [(-S sandbox|--sandbox=sandbox)] [--devpath=path] [--projectRevision=rev] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] member...
si deleterevision deletes an archived revision of a project member. For example,
si deleterevision --range=1.2-1.5 --confirm --confirminuse c:/Documentation/Man_Pages/xml_man/si_add.1.xml
deletes revisions 1.2, 1.3, 1.4, and 1.5 from the archive xml_man without prompting to confirm to the user if the revisions are in use in other projects.
It is recommended that you never delete a revision. Since historical versions of projects may still point at the deleted revision, it may become impossible to recreate old projects.
This command takes the universal options available to all si commands, as well as some general options. See the options reference page for descriptions.
controls the display of confirmation messages.
controls whether Windchill RV&S warns you about deleting the revision if it is used in other projects. If the revision is used in other projects, Windchill RV&S warns you that deleting the selected revision will break the listed items. This option is valid only with the database repository.
forces the revision to be deleted, without any confirmation message.
specifies a range of revision numbers. The format of value for a single revision is simply the revision number itself. Separate multiple non sequential revisions with a comma, and use a dash to indicate a sequential range, for example, 1.2-1.5.
You may also prefix or append a dash to a single revision number, meaning you want to delete from 1.1 to the specified revision, or from the specified revision to the tip. For example, you would specify -1.6 to delete revisions 1.1 to 1.6. Or you could specify 1.2- to delete revisions 1.2 to the tip revision, whatever it may be.
The revisions are deleted in order from the highest revision to the lowest.
identifies a specific member; use spaces to specify more than one member.
See the diagnostics reference page for possible exit status values.
Using si setprefs or si viewprefs, you are able to set or view the preference keys for this command.
See Also
Commands: si diff, si merge, si revisioninfo, si rlog
Miscellaneous: ACL, diagnostics, options, preferences