Compartir a través de

Set-TimeZone

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Establece la zona horaria del sistema en una zona horaria especificada.

Sintaxis

Set-TimeZone
   [-Name] <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-TimeZone
   -Id <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-TimeZone
   [-InputObject] <TimeZoneInfo>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

El cmdlet Set-TimeZone establece la zona horaria del sistema en una zona horaria especificada.

Ejemplos

Ejemplo 1: Establecimiento de la zona horaria por identificador

En este ejemplo se establece la zona horaria del equipo local en UTC.

Set-TimeZone -Id "UTC"

Id                         : UTC
HasIanaId                  : True
DisplayName                : (UTC) Coordinated Universal Time
StandardName               : Coordinated Universal Time
DaylightName               : Coordinated Universal Time
BaseUtcOffset              : 00:00:00
SupportsDaylightSavingTime : False

Ejemplo 2: Establecimiento de la zona horaria por nombre

En este ejemplo se establece la zona horaria del equipo local en UTC.

Set-TimeZone -Name 'Coordinated Universal Time' -PassThru

Como vimos en el ejemplo anterior, el de identificador de y el Nombre de la zona horaria no siempre coinciden. El parámetro Name debe coincidir con las propiedades StandardName o DaylightName del objeto TimeZoneInfo.

Nota

Los nombres de zona horaria pueden variar en función de la configuración de referencia cultural en Windows. En este ejemplo se muestran los valores de un sistema establecido en en-US.

Ejemplo 3: Enumerar todas las zonas horarias disponibles

Para obtener una lista completa de identificadores de zona horaria, ejecute el siguiente comando:

Get-TimeZone -ListAvailable

Parámetros

-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

-Id

Especifica el identificador de la zona horaria que establece este cmdlet.

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

-InputObject

Especifica un objeto TimeZoneInfo que se va a usar como entrada.

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

-Name

Especifica el nombre de la zona horaria que establece este cmdlet. Para obtener una lista completa de nombres de zona horaria, ejecute el siguiente comando: Get-TimeZone -ListAvailable.

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

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ninguna salida.

Tipo:SwitchParameter
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

String

TimeZoneInfo

Salidas

None

De forma predeterminada, este cmdlet no devuelve ninguna salida.

TimeZoneInfo

Cuando se usa el parámetro PassThru, este cmdlet devuelve un objeto TimeZoneInfo.

Notas

PowerShell incluye los siguientes alias para Set-TimeZone:

  • Windows:
    • stz

Este cmdlet solo está disponible en plataformas Windows.