Set-Date

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Altera a hora do sistema no computador para uma hora que você especificar.

Syntax

Set-Date
   [-Date] <DateTime>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Date
   [-Adjust] <TimeSpan>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O Set-Date cmdlet altera a data e a hora do sistema no computador para uma data e hora especificadas.

Você pode especificar uma nova data e/ou hora digitando uma cadeia de caracteres ou passando um objeto DateTime ou TimeSpan para Set-Date. Para especificar uma nova data ou hora, use o parâmetro Date . Para especificar um intervalo de alteração, use o parâmetro Adjust .

Exemplos

Exemplo 1: Adicionar três dias à data do sistema

Este comando adiciona três dias à data do sistema atual. Ele não afeta a hora. O comando usa o parâmetro Date para especificar a data.

O Get-Date cmdlet retorna a data atual como um objeto DateTime . O método AddDays do objeto DateTime adiciona um número especificado de dias (3) ao objeto DateTime atual.

Set-Date -Date (Get-Date).AddDays(3)

Exemplo 2: definir o relógio do sistema de volta 10 minutos

Este exemplo define o tempo atual do sistema em 10 minutos.

O parâmetro Adjust permite que você especifique um intervalo de alteração (menos dez minutos) no formato de hora padrão para a localidade.

O parâmetro DisplayHint informa ao PowerShell para exibir apenas a hora, mas não afeta o objeto DateTime que Set-Date retorna.

Set-Date -Adjust -0:10:0 -DisplayHint Time

Exemplo 3: definir a data e a hora como um valor variável

Esses comandos alteram a data e a hora do sistema no computador local para a data e a hora salvas na variável $T. O primeiro comando obtém a data e a armazena em $T.

O segundo comando usa o parâmetro Date para passar o objeto $TDateTime para o Set-Date cmdlet .

$T = Get-Date
Set-Date -Date $T

Exemplo 4: adicionar 90 minutos ao relógio do sistema

Estes comandos adiantam a hora do sistema no computador local por 90 minutos.

O primeiro comando usa o New-TimeSpan cmdlet para criar um objeto TimeSpan com um intervalo de 90 minutos e o salva na $90mins variável .

O segundo comando usa o parâmetro Adjust de Set-Date para ajustar a data pelo valor do objeto TimeSpan na $90mins variável .

$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins

Parâmetros

-Adjust

Especifica o valor para o qual esse cmdlet adiciona ou subtrai da data e hora atuais. pode digitar um ajuste no formato de data e hora padrão para sua localidade ou usar o parâmetro Adjust para passar um objeto TimeSpan de New-TimeSpan para Set-Date.

Type:TimeSpan
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Date

Altera a data e hora com os valores especificados. Você pode digitar uma nova data no formato de data abreviada e uma hora no formato de hora padrão para sua localidade. Ou você pode passar um objeto DateTime de Get-Date.

Se você especificar uma data, mas não uma hora, Set-Date alterará a hora para meia-noite na data especificada. Se você especificar somente a hora, ele não altera a data.

Type:DateTime
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-DisplayHint

Especifica quais elementos da data e hora são exibidos. Os valores aceitáveis para esse parâmetro são:

  • Date – exibe apenas a data.
  • Time – exibe apenas a hora.
  • DateTime – exibe a data e a hora.

Este parâmetro afeta somente a exibição. Ele não afeta o objeto DateTime que Get-Date recupera.

Type:DisplayHintType
Accepted values:Date, Time, DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

DateTime

Você pode redirecionar uma data para este cmdlet.

Saídas

DateTime

Esse cmdlet retorna um objeto que representa a data que ele definiu.

Observações

  • Use esse cmdlet com cautela ao alterar a data e a hora no computador. A alteração pode impedir que o computador receba eventos de todo o sistema e atualizações que são disparadas por uma data ou hora. Use os parâmetros WhatIf e Confirm para evitar erros.
  • Você pode usar métodos .NET padrão com os objetos DateTime e TimeSpan usados com Set-Date, como AddDays, AddMonths e FromFileTime. Para obter mais informações, consulte Métodos DateTime e Métodos TimeSpan no SDK do .NET.