Tzmove:Stsadm 操作 (Office SharePoint Server)

操作名称:Tzmove

说明

使管理员能够更新受夏令时 (DST) 开始和/或结束日期变更影响的数据。

备注

Tzmove 操作是在 Microsoft Office SharePoint Server 2007 Service Pack 1 中首次引入的。

语法

stsadm -o tzmove

   -name <name of the history tag>

   -update {all | before}

    [-date] <YYYYMMDD>

   -clear

参数

参数名

是否必需

说明

name

一个有效的名称,例如“dst2007”

Timezone.xml 文件中用于标识夏令时变化的历史记录标记的名称。

update

以下任一值:

  • All

  • Before

Note注意:
必须指定 update 参数或 clear 参数,但不能同时指定二者。

All:更新将来的和受夏令时变化影响的所有日期值。

Before:更新将来出现的日期值和受夏令时变更(变更发生在 date 参数指定的日期之前)影响的日期值。当 Timezone.xml 文件有更新但 tzmove 操作并未立即运行时,这非常有用。

date

一个有效日期,格式为“YYYYMMDD”

当 update 参数的值为 Before 时,必须指定 date 参数。当 update 参数未指定或值为 All 时,不应使用此参数。

clear

<无>

Note注意:
必须指定 update 参数或 clear 参数,但不能同时指定二者。

默认情况下,tzmove 操作不会多次更新数据。如果对 tzmove 操作的上一次调用已中断,则 clear 参数允许再次安全运行此操作。不过,如果需要多次更新数据(例如,当时区定义每年都发生变化时),则 clear 参数会做好再次更新数据的准备。

备注

例如,假定已在 Timezone.xml 文件中将 2007 年 11 月 3 日定义为标准时间。但是,您所在国家/地区的标准时间将比定义的标准时间早一周,这样就会将标准时间的日期更改为 2007 年 10 月 27 日。在更新 Timezone.xml 文件以反映此变更之后,在此时间段(本示例中为 10 月的最后一个周日到 11 月的第一个周日之间的时间)内出现的日期值将会存在一个小时的偏差。Tzmove 操作将更新此数据以使其正确。

Timezone.xml 文件位于以下位置:“%COMMONPROGRAMFILES%\microsoft shared\web server extensions\12\config”文件夹。

有关 Tzmove 的详细信息,请参阅 Microsoft 知识库文章 939809(https://go.microsoft.com/fwlink/?linkid=105804&clcid=0x804)。

示例

对于下列示例,以下定义适用:

  • 将来数据:此数据由包含日期值和时间值的项目组成,这些日期和时间发生在新 DST 时段首次生效的当年和之后年份的 DST 时段中。

  • 过去数据:此数据由包含日期值和时间值的项目组成,这些日期和时间发生在新 DST 时段首次生效之前的年份的 DST 时段中。

  1. 如果先前安装的更新修改了时区定义的 DST 时段,则必须运行以下命令以更新将来数据项:

    stsadm –o tzmove –name <name> –update before –date YYYYMMDD

    备注

    在此命令中,YYYYMMDD 为修改了时区定义的更新的安装日期。

  2. 如果未安装更新且已修改 Timezone.xml 文件,则必须运行以下命令以更新将来数据项:

    stsadm –o tzmove –name <name> –update before -date YYYYMMDD

    备注

    在此命令中,YYYYMMDD 为修改 Timezone.xml 文件的日期。

  3. 如果未安装修改时区定义的 DST 时段的更新,则必须运行以下命令以更新将来数据项:

    stsadm -o tzmove -name <name> -update all

    备注

    在此命令中,将更新所有将来数据。

  4. 如果在运行此命令之后再次修改时区定义的 DST 时段,则在重新运行此命令时将不会还原以前的数据。在此情况下,必须先运行以下命令,然后重新运行该命令:

    stsadm –o tzmove –name <name> -clear

    备注

    此过程将清除该命令设置的内部标记,并允许再次修改数据。