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