Set-TimeZone
将系统时区设置为指定的时区。
语法
Set-TimeZone
[-Name] <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-TimeZone
-Id <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
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 并不总是匹配。 Name 参数必须与 TimeZoneInfo 对象的 StandardName 或 DaylightName 属性匹配。
注意
时区名称可能因 Windows 中的区域性设置而异。 此示例显示设置为 en-US
的系统的值。
示例 3 - 列出所有可用时区
可以运行以下命令以获取时区 ID 的完整列表:
Get-TimeZone -ListAvailable
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
指定此 cmdlet 设置的时区的 ID。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InputObject
指定要用作输入的 TimeZoneInfo 对象。
Type: | TimeZoneInfo |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
指定此 cmdlet 设置的时区的名称。 可以运行 Get-TimeZone -ListAvailable
命令以获取时区名称的完整列表。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
返回一个代表你所处理的项目的对象。 默认情况下,此 cmdlet 将不产生任何输出。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
输出
None
默认情况下,此 cmdlet 不返回任何输出。
如果使用 PassThru 参数,则此 cmdlet 会返回 TimeZoneInfo 对象。
备注
PowerShell 包含 Set-TimeZone
的以下别名:
- Windows:
stz
此 cmdlet 仅在 Windows 平台上可用。
相关链接
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈