Set-TimeZone
Establece la zona horaria del sistema en una zona horaria especificada.
Sintaxis
Name (Es el valor predeterminado).
Set-TimeZone
[-Name] <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Set-TimeZone
-Id <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
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 Id 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 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.
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 |
-Id
Especifica el identificador de la zona horaria que establece este cmdlet.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Id
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-InputObject
Especifica un objeto TimeZoneInfo que se va a usar como entrada.
Propiedades del parámetro
| Tipo: | TimeZoneInfo |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
InputObject
| Posición: | 0 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Name
| Posición: | 0 |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PassThru
Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ninguna salida.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| 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
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.
