Compartir a través de

Set-Date

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

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

Syntax

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

Description

El Set-Date cmdlet 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 objeto DateTime o 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 Adjust .

Ejemplos

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

Este comando suma tres días a la fecha actual del sistema. No afecta a la hora. El comando usa el parámetro Date para especificar la fecha.

El Get-Date cmdlet devuelve la fecha actual como un objeto DateTime . El método AddDays del objeto DateTime 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 Set-Date cmdlet .

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

Ejemplo 4: Agregar 90 minutos al reloj del sistema

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

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

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

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

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 New-TimeSpan a Set-Date.

Type:TimeSpan
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Date

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

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

Type:DateTime
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 : muestra solo la hora.
  • DateTime : muestra la fecha y hora.

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

Type:DisplayHintType
Accepted values:Date, Time, DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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. podría hacer que el equipo no reciba los eventos y actualizaciones de todo el sistema que se activan a partir de una fecha o una 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, AddMonths y FromFileTime. Para obtener más información, vea Métodos DateTime y Métodos TimeSpan en el SDK de .NET.