Cambia la hora del sistema en el equipo a la hora especificada.

Sintaxis

Set-Date [-Adjust] <TimeSpan> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirm] [-WhatIf] [<CommonParameters>]

Set-Date [-Fecha] <DateTime> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirm] [-WhatIf] [<CommonParameters>]

Descripción

El cmdlet Set-Date modifica la fecha y la hora del sistema en el equipo a la fecha y hora especificadas. Se puede establecer una nueva fecha y hora escribiendo una cadena o pasando un objeto DateTime o TimeSpan a Set-Date. Para especificar una fecha o una hora nueva, use el parámetro Date. Para especificar un intervalo de cambio, use el parámetro Adjust.

Parámetros

-Adjust <TimeSpan>

Suma o resta el valor especificado de la fecha y hora actuales. Puede escribir un ajuste en el formato de fecha y hora estándar de la configuración regional o usar el parámetro Adjust para pasar un objeto TimeSpan de New-TimeSpan a Set-Date.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

true (ByPropertyName)

¿Aceptar caracteres comodín?

false

-Fecha <DateTime>

Cambia la fecha y la hora a los valores especificados. Puede escribir una nueva fecha en el formato abreviado y una hora en el formato estándar para la configuración regional. También puede pasar un objeto Date-Time desde Get-Date.

Si se especifica una fecha pero no una hora, Set-Date cambia la hora a la medianoche de la fecha especificada. Si sólo se especifica una hora, no se modifica la fecha.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

true (ByValue, ByPropertyName)

¿Aceptar caracteres comodín?

false

-DisplayHint <DisplayHintType>

Determina qué elementos de fecha y hora se muestran.

Los valores válidos son:

-- date: muestra solo la fecha

-- time: muestra solo la hora

-- datetime: muestra la fecha y la hora

Este parámetro afecta únicamente a la presentación. No afecta al objeto DateTime que Get-Date recupera.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Confirm

Solicita confirmación antes de ejecutar el comando.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-WhatIf

Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

System.DateTime

Puede canalizar una fecha a Set-Date.

Salidas

System.DateTime

Set-Date devuelve un objeto que representa la fecha establecida.

Notas

Use este cmdlet con precaución. Este cmdlet cambia la fecha y la hora del equipo. Este cambio puede impedir que el equipo reciba actualizaciones y eventos en todo el sistema que se activan por la fecha o la hora. Use los parámetros -WhatIf y -Confirm para evitar que se produzcan errores.

Puede usar los métodos estándar de .NET con los objetos DateTime y TimeSpan usados con Set-Date, como AddDays, AddMonths y FromFileTime. Para obtener más información, vea los métodos DateTime y TimeSpan.

Ejemplo 1

C:\PS>Set-Date -Date (Get-Date).AddDays(3)

Descripción
-----------
Este comando suma tres días a la fecha actual del sistema. No tiene ningún efecto sobre la hora. El comando usa el parámetro Date para especificar la fecha. Usa el cmdlet Get-Date para obtener la fecha y la hora actuales y aplica a los objetos DateTime el método AddDays de .NET con el valor 3 (días).






Ejemplo 2

C:\PS>set-date -adjust -0:10:0 -displayHint time

Descripción
-----------
Este comando retrasa la hora actual del sistema en 10 minutos. Usa el parámetro Adjust para especificar un intervalo de cambio y el cambio de hora (menos 10 minutos) en el formato de hora estándar de la configuración regional. El parámetro DisplayHint indica a Windows PowerShell que muestre únicamente la hora, pero no afecta al objeto DateTime devuelto por Set-Date.






Ejemplo 3

C:\PS>$t = get-date

C:\PS>set-date -date $t

Descripción
-----------
Estos comando cambian la fecha y la hora del sistema en el equipo a la fecha y hora almacenadas en la variable $t. El primer comando obtiene la fecha y la almacena en la variable $t. El segundo comando usa el parámetro Date para pasar el objeto DateTime de $t al cmdlet Set-Date.






Ejemplo 4

C:\PS>$90mins = new-timespan -minutes 90

C:\PS>set-date -adjust $90mins

Descripción
-----------
Estos comandos adelantan las horas 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, a continuación, guarda el objeto TimeSpan 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 almacenado en la variable $90mins.






Vea también




Tabla de contenido