Compartir a través de

Set-Date

Módulo:
Microsoft.PowerShell.Utility Module

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

Sintaxis

Date (Es el valor predeterminado). 

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

Adjust 

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 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 al cmdlet .

$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.

Propiedades del parámetro

Tipo:TimeSpan
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Adjust
Posición:0
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:DateTime
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Date
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:DisplayHintType
Valor predeterminado:None
Valores aceptados:Date, Time, DateTime
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

DateTime

Puede canalizar una fecha a este cmdlet.

Salidas

DateTime

Este cmdlet devuelve un objeto que representa la fecha establecida.

Notas

  • Use este cmdlet con precaución al cambiar la fecha y hora en el equipo. El cambio puede impedir que el equipo reciba eventos y actualizaciones de todo el sistema desencadenados por una fecha u hora. Use los parámetros WhatIf y Confirm para evitar errores.
  • Puede usar métodos estándar de .NET con los objetos DateTime y TimeSpan usados con Set-Date, como AddDays, AddMonthsy FromFileTime. Para obtener más información, consulte métodos DateTime y métodos TimeSpan en el SDK de .NET.