pmrep 命令引用 > PurgeVersion
  

PurgeVersion

从存储库数据库中清除对象版本。可以清除已删除对象和活动对象的版本。如果对象的最新版本已签入且其版本状态为“已删除”,则此对象为已删除的对象。其他对象为活动对象。
清除已删除对象的版本时,将清除所有版本。必须签入已删除的对象。可以清除所有已删除对象的版本,也可以清除已在指定结束时间之间删除的对象的版本。可以将结束时间指定为日期和时间、仅日期或距当前日期之前的天数。
清除活动对象的版本时,可以指定清除条件。可以指定要保留的版本数量并清除以前的版本,还可以清除早于指定清除截止时间的版本。不能清除已签出版本或最新签入的版本。
如果清除复合对象的版本,则需要考虑清除相关对象的哪些版本。
PurgeVersion 命令使用以下语法:
purgeversion

{-d <all | time_date | num_day> | 

{-n <last_n_versions_to_keep> |

 -t <time_date | num_day>}}

[-f <folder_name>]

[-q <query_name>]

[-o <output_file_name>]

[-p (preview purged objects only)]

[-b (verbose)]

[-c (check deployment group reference)]

[-s dbd_separator]

[-k (log objects not purged)]
下表介绍了 pmrep PurgeVersion 选项和参数:
选项
参数
说明
-d
全部
time_date
num_day
未使用 -n 或 -t 时为必选项。清除已删除对象所有已签入的版本。可以指定 all 以删除所有对象,也可以指定一个结束时间,清除在结束时间之前删除的对象的所有版本。可以按 MM/DD/YYYY HH24:MI:SS 格式或 MM/DD/YYYY 格式指定结束时间,也可以将结束时间指定为距离当前日期之前的天数。如果指定天数,则该值必须是一个大于 0 的整数。
-n
last_n_versions_to_keep
未使用 -d 或 -t 时为必选项。要为活动对象保留的最新签入的对象版本数。该值必须是一个大于 0 的整数。例如,输入 6 时将清除最后签入的六个版本以外的其他所有版本。如果对象已签出,还将保留已签出的版本。
-t
purge_cutoff_time
未使用 -d 或 -n 时为必选项。清除活动对象的对象版本的截止时间。清除在截止时间之前已签入的版本。可以按 MM/DD/YYYY HH24:MI:SS 格式或 MM/DD/YYYY 格式指定清除截止时间,也可以将清除截止时间指定为距离当前日期之前的天数。如果指定天数,则该值必须是一个大于 0 的整数。使用 ‑t 选项时,将保留最新签入的版本,即使该版本是在清除截止时间之后签入的也是如此。
-f
folder_name
可选。从中清除对象版本的文件夹。如果未指定文件夹,将清除存储库的所有文件夹中的对象版本。
-q
query_name
可选。用于从特定查询结果集中清除对象版本的查询。
-o
outputfile_name
可选。用于保存已清除对象版本相关信息的输出文件。
-p
-
可选。预览 PurgeVersion 命令。pmrep 将显示清除结果,而不是实际清除对象版本。
-b
-
可选。以详细模式显示或保存清除信息。详细模式可提供有关对象版本的详细信息,包括存储库名称、文件夹名称、版本号和状态。可以结合使用 -b 选项与 -o 和 -p。
-c
-
可选。检查存储库中的部署组是否有对清除预览中返回的对象版本的引用。如果清除预览中包含部署组中的对象版本,pmrep 将显示警告。如果使用 -c 选项,还必须使用 -p 选项。
-s
dbd_separator
可选。如果 ODBC 源名称中包含句点 (.),请在定义源对象时定义其他分隔符字符。例如,不使用 database_name.source_name,而是将源对象定义为 database_name\source_name,将 dbd_separator 定义为反斜杠 (\)。
-k
-
可选。列出所有未被清除但符合清除条件的对象名称和版本。-k 选项还会列出不清除对象版本的原因。例如,如果您没有足够的特权清除对象,则不会清除对象版本。

示例

以下示例将清除存储库中所有已删除对象的所有版本:
pmrep purgeversion -d all
以下示例将清除 folder1 文件夹中对象除最新签入的版本外的所有版本:
pmrep purgeversion -n 1 -f folder1
以下示例将预览在 2005 年 1 月 5 日中午之前签入的所有对象版本的清除效果,并将结果输出到名为 purge_output.txt 的文件中:
pmrep purgeversion -t '01/05/2005 12:00:00' -o purge_output.txt -p