Tzmove: operação do Stsadm (Office SharePoint Server)
Atualizado em: 2007-12-06
Nome da operação: Tzmove
Descrição
Permite que um administrador atualize os dados afetados por uma alteração no início e/ou término do horário de verão.
Dica
A operação Tzmove foi introduzida pela primeira vez no Microsoft Office SharePoint Server 2007 Service Pack 1.
Sintaxe
stsadm -o tzmove
** -name <nome da marca de histórico>**
** -update {all | before}**
** [-date] <AAAAMMDD>**
** -clear**
Parâmetros
Nome do parâmetro |
Valor |
Obrigatório? |
Descrição |
nome |
Um nome válido, como "dst2007" |
Sim |
O nome da marca de histórico que identifica a alteração do horário de verão no arquivo Timezone.xml. |
update |
Um dos valores a seguir:
|
Sim .gif "Observação") Observação:
O parâmetro update ou clear precisa ser especificado, mas não ambos.
|
All: Atualiza todos os valores de dados que ocorrem no futuro e que são afetados pela alteração no horário de verão. Before: Atualiza os valores de dados que ocorrem no futuro e que são afetados pela alteração no horário de verão ocorrida antes da data especificada usando o parâmetro date. Isso é útil quando há uma atualização no arquivo Timezone.xml, mas a operação tzmove não é executada imediatamente. |
date |
Uma data válida no formato "AAAAMMDD" |
Não |
Quando o parâmetro update tem o valor Before, o parâmetro date é necessário. Quando o parâmetro update não está especificado ou tem o valor All, esse parâmetro não deve ser incluído. |
clear |
<nenhum> |
Sim Observação:
O parâmetro update ou clear precisa ser especificado, mas não ambos.
|
Por padrão, a operação tzmove não atualizará os dados mais de uma vez. O parâmetro clear permite que a operação tzmove seja executada novamente com segurança se uma chamada anterior da operação foi interrompida. Entretanto, se for necessário atualizar os dados mais de uma vez (por exemplo, quando uma definição de fuso horário é alterada todos os anos), o parâmetro clear preparará os dados para ser atualizados novamente. |
Comentários
Para exemplificar, digamos que 3 de novembro de 2007 foi definido como horário oficial no arquivo Timezone.xml. Entretanto, ficou decidido que o horário oficial ocorrerá uma semana antes em seu país, o que muda a data do horário oficial para 27 de outubro de 2007. Após a atualização do Timezone.xml para refletir essa alteração, os valores de data que ocorrerem nesse intervalo de tempo (neste exemplo, entre o último domingo de outubro e o primeiro domingo de novembro) estarão uma hora incorretos. A operação Tzmove atualizaria esses dados para que ficassem corretos.
O arquivo Timezone.xml está localizado na pasta "%COMMONPROGRAMFILES%\microsoft shared\web server extensions\12\config".
Para obter mais informações sobre Tzmove, consulte a Base de Dados de Conhecimento Microsoft, artigo 939809 (https://go.microsoft.com/fwlink/?linkid=105804\&clcid=0x416).
Exemplos
Para os exemplos a seguir, aplique estas definições:
Dados do futuro: estes dados consistem em itens que contêm valores de data e de hora que ocorrem no novo período de horário de verão no ano em que esse período entra em vigor pela primeira vez e posteriormente.
Dados do passado: estes dados consistem em itens que contêm valores de data e de hora que ocorrem no novo período de horário de verão nos anos anteriores a quando esse período entra em vigor pela primeira vez.
Se você anteriormente instalou uma atualização que modificou o período de horário de verão de uma definição de fuso horário, precisará executar o seguinte comando para atualizar os itens de dados do futuro:
stsadm –o tzmove –name <nome> –update before –date AAAAMMDD
Dica
Neste comando, AAAAMMDD é a data em que você instalou a atualização que modificou a definição de fuso horário.
Se você não instalou uma atualização e se modificou o arquivo Timezone.xml, precisará executar o seguinte comando para atualizar os itens de dados do futuro:
stsadm –o tzmove –name <nome> –update before –date AAAAMMDD
Dica
Neste comando, AAAAMMDD é a data em que o arquivo Timezone.xml foi modificado.
Se você não instalou uma atualização que modificou o período de horário de verão de uma definição de fuso horário, precisará executar o seguinte comando para atualizar os itens de dados do futuro:
stsadm -o tzmove -name <nome> -update all
Dica
Neste comando, todos os dados do futuro são atualizados.
Se o período de horário de verão para uma definição de fuso horário for modificado novamente depois que você executar o comando, os dados anteriores não serão restaurados quando você executá-lo novamente. Nesse caso, será necessário executar o seguinte comando antes de executar o comando novamente:
stsadm –o tzmove –name <nome> -clear
Dica
Este procedimento limpa os sinalizadores internos definidos pelo comando e permite que os dados sejam modificados outra vez.