Compartilhar via

Set-Date

Módulo:
Microsoft.PowerShell.Utility Module

Altera a hora do sistema no computador para um horário que você especificar.

Sintaxe

Date (Default) 

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

Adjust 

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

Description

O cmdlet Set-Date 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 Ajustar.

Exemplos

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

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

O cmdlet Get-Date retorna a data atual como um objeto DateTime. O método 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 Ajustar permite especificar um intervalo de alteração (menos dez minutos) no formato de tempo 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 retorna.

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

Exemplo 3: Definir a data e a hora para 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 DateTime em $T para o cmdlet Set-Date.

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

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

Esses comandos avançam o tempo do sistema no computador local em 90 minutos.

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

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

$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 Ajustar para passar um objeto TimeSpan de para .

Propriedades do parâmetro

Tipo:TimeSpan
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Adjust
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Date

Altera a data e a hora para os valores especificados. Você pode digitar uma nova data no formato de data curta 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 apenas uma hora, ela não alterará a data.

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Date
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DisplayHint

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

  • Data. exibe apenas a data.
  • Hora. exibe apenas a hora.
  • Data/hora. exibe a data e a hora.

Esse parâmetro afeta apenas a exibição. Ele não afeta o objeto DateTime que recupera.

Propriedades do parâmetro

Tipo:DisplayHintType
Valor padrão:None
Valores aceitos:Date, Time, DateTime
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

DateTime

Você pode canalizar uma data para Set-Date.

Saídas

DateTime

Set-Date retorna um objeto que representa a data que ele definiu.

Observações

  • Use esse cmdlet com cuidado ao alterar a data e a hora no computador. A alteração pode impedir que o computador receba eventos e atualizações em todo o sistema disparados 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, AddMonthse FromFileTime. Para obter mais informações, consulte métodos DateTime e

    métodos TimeSpan na biblioteca MSDN.