Set-Date
Altera a hora do sistema no computador para uma hora que você especificar.
Sintaxe
Date (Predefinição)
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 por você.
Você pode especificar uma nova data e/ou hora digitando uma cadeia de caracteres ou passando um DateTime ou objeto 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.
Você deve ter direitos administrativos para alterar a data e a hora do sistema. No Windows, inicie o PowerShell com a opção Executar como administrador opção.
Exemplos
Exemplo 1: Adicionar três dias à data do sistema
Este 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 3) ao objeto atual DateTime.
Set-Date -Date (Get-Date).AddDays(3)
Exemplo 2: Acertar o relógio do sistema 10 minutos
Este exemplo define o tempo atual do sistema de volta em 10 minutos.
O parâmetro Adjust permite especificar 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 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 adiantam o tempo do sistema no computador local em 90 minutos.
O primeiro comando usa o cmdlet
O segundo comando usa o parâmetro
$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins
5: Alterar para uma data e hora específicas
O exemplo a seguir define a data e a hora como um valor específico.
PS> Get-Date
Monday, June 10, 2024 2:05:48 PM
PS> Set-Date '6/11/2024 2:05:48 PM'
Tuesday, June 11, 2024 2:05:48 PM
Parâmetros
-Adjust
Especifica o valor para o qual esse cmdlet adiciona ou subtrai da data e hora atuais. Você 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.
Propriedades dos parâmetros
| Tipo: | TimeSpan |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Adjust
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Date
Altera a data e a hora para 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 apenas uma hora, a data não será alterada.
Propriedades dos parâmetros
| Tipo: | DateTime |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Date
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-DisplayHint
Especifica quais elementos da data e hora são exibidos. Os valores aceitáveis para este 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 apenas a exibição. Isso não afeta o objeto DateTime que Get-Date recupera.
Propriedades dos parâmetros
| Tipo: | DisplayHintType |
| Default value: | None |
| Valores aceites: | Date, Time, DateTime |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 este cmdlet.
Saídas
DateTime
Este cmdlet retorna um objeto que representa a data definida.
Notas
- Use este cmdlet com cautela 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 acionados por uma data ou hora. Use o WhatIf e Confirmar parâmetros para evitar erros.
- Você pode usar métodos .NET padrão com o DateTime e objetos TimeSpan usados com
Set-Date, como AddDays, AddMonthse FromFileTime. Para obter mais informações, consulte Métodos DateTime e Métodos TimeSpan no SDK do .NET.
