Set-Date

Referencia

Módulo:: Microsoft.PowerShell.Utility

Cambia la hora del sistema del equipo a una hora que especifique.

Sintaxis

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

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

Description

El cmdlet Set-Date cambia la fecha y hora del sistema en el equipo a una fecha y hora que especifique.

Puede especificar una nueva fecha o hora escribiendo una cadena o pasando un dateTime o objeto TimeSpan a Set-Date. Para especificar una nueva fecha u hora, use el parámetro date. Para especificar un intervalo de cambio, use el parámetro Ajustar.

Debe tener derechos administrativos para cambiar la fecha y hora del sistema. En Windows, inicie PowerShell con la opción Ejecutar como administrador.

Ejemplos

Ejemplo 1: Agregar tres días a la fecha del sistema

Este comando agrega tres días a la fecha actual del sistema. No afecta al tiempo. El comando usa el parámetro date para especificar la fecha.

El cmdlet Get-Date devuelve la fecha actual como un objeto dateTime . El método DateTimeAddDays agrega un número especificado de días (3) al objeto dateTime actual.

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

Ejemplo 2: Establecer el reloj del sistema 10 minutos atrás

En este ejemplo se establece el tiempo actual del sistema en 10 minutos.

El parámetro Adjust permite especificar un intervalo de cambio (menos diez minutos) en el formato de hora estándar para la configuración regional.

El parámetro DisplayHint indica a PowerShell que muestre solo la hora, pero no afecta al objeto DateTime que Set-Date devuelve.

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

Ejemplo 3: Establecer la fecha y hora en un valor de variable

Estos comandos cambian la fecha y hora del sistema en el equipo local a la fecha y hora guardadas en la variable $T. El primer comando obtiene la fecha y la almacena en $T.

El segundo comando usa el parámetro date para pasar el objeto dateTime en $T al cmdlet Set-Date.

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

Ejemplo 4: Agregar 90 minutos al reloj del sistema

Estos comandos avanzan la hora del sistema en el equipo local en 90 minutos.

El primer comando usa el cmdlet New-TimeSpan para crear un objeto timeSpan con un intervalo de 90 minutos y lo guarda en la variable $90mins.

El segundo comando usa el parámetro Adjust de Set-Date para ajustar la fecha por el valor del objeto timeSpan de en la variable $90mins.

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

5: Cambiar a una fecha y hora específicas

En el ejemplo siguiente se establece la fecha y hora en un 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 el valor para el que este cmdlet agrega o resta de la fecha y hora actuales. Puede escribir un ajuste en formato de fecha y hora estándar para la configuración regional o usar el parámetro Adjust para pasar un objeto timeSpan de de New-TimeSpan a Set-Date.

Tipo:	TimeSpan
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Date

Cambia la fecha y hora a los valores especificados. Puede escribir una nueva fecha en el formato de fecha corta y una hora en el formato de hora estándar para la configuración regional. O bien, puede pasar un objeto dateTime de desde Get-Date.

Si especifica una fecha, pero no una hora, Set-Date cambia la hora a medianoche en la fecha especificada. Si especifica solo una hora, no cambia la fecha.

Tipo:	DateTime
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-DisplayHint

Especifica qué elementos de la fecha y hora se muestran. Los valores aceptables para este parámetro son:

Date: muestra solo la fecha.
Time: solo muestra la hora.
DateTime: muestra la fecha y hora.

Este parámetro afecta solo a la pantalla. No afecta al objeto DateTime que Get-Date recupera.

Tipo:	DisplayHintType
Valores aceptados:	Date, Time, DateTime
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

DateTime

Puede canalizar una fecha a este cmdlet.

Salidas