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 Set-TimeZone cmdlet 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 identificador 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 solicita su 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 ningún resultado.

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 se ejecutara el cmdlet. 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.