Set-TimeZone
将系统时区设置为指定的时区。
语法
Name （默认值）
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>]
说明
此 cmdlet 仅在 Windows 平台上可用。
Set-TimeZone cmdlet 将系统时区设置为指定的时区。
示例
示例 1：按 ID 设置时区
本示例将本地计算机上的时区设置为 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
示例 2：按名称设置时区
本示例将本地计算机上的时区设置为 UTC。
Set-TimeZone -Name 'Coordinated Universal Time' -PassThru
如上一示例中所示，ID 和时区的 名称 并不总是匹配。 Name 参数必须与 TimeZoneInfo 对象的 StandardName 或 DaylightName 属性匹配。
注释
时区名称可能因 Windows 中的区域性设置而异。 此示例显示设置为 en-US的系统的值。
示例 3 - 列出所有可用时区
可以通过运行以下命令获取时区 ID 的完整列表：
Get-TimeZone -ListAvailable
参数
-Confirm
在运行 cmdlet 之前，提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Id
指定此 cmdlet 设置的时区的 ID。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Id
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-InputObject
指定要用作输入的 TimeZoneInfo 对象。
参数属性
| 类型: | TimeZoneInfo |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
InputObject
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
指定此 cmdlet 设置的时区的名称。 可以通过运行以下命令获取时区名称的完整列表：Get-TimeZone -ListAvailable。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Name
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PassThru
返回一个对象，该对象表示你正在处理的项目。 默认情况下，此 cmdlet 不生成任何输出。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
String
TimeZoneInfo
输出
None
默认情况下，此 cmdlet 不返回任何输出。
TimeZoneInfo
使用 PassThru 参数时，此 cmdlet 返回 TimeZoneInfo 对象。
备注
PowerShell 包含以下与 Set-TimeZone相关的别名：
- 窗户：
stz
此 cmdlet 仅在 Windows 平台上可用。
