共用方式為

Set-TimeZone

  • 參考
模組:
Microsoft.PowerShell.Management

將系統時區設定為指定的時區。

語法

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

此 Cmdlet 僅適用於 Windows 平臺。

Cmdlet 會將 Set-TimeZone 系統時區設定為指定的時區。

範例

範例 1：依標識符設定時區

本範例會將本機計算機上的時區設定為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

如上一個範例所示， [標識符 ] 和 [時區名稱 ] 不一定相符。 Name 參數必須符合 TimeZoneInfo 物件的 StandardName 或 DaylightName 屬性。

注意

時區名稱可能會根據 Windows 中的文化特性設定而有所不同。 此範例顯示系統設定為 en-US的值。

範例 3 - 列出所有可用的時區

您可以執行下列命令來取得時區識別碼的完整清單：

Get-TimeZone -ListAvailable

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Id

指定這個 Cmdlet 所設定時區的識別碼。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-InputObject

指定要 作為輸入的 TimeZoneInfo 物件。

類型:TimeZoneInfo
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Name

指定這個 Cmdlet 所設定的時區名稱。 您可以執行下列命令來取得時區名稱的完整清單： Get-TimeZone -ListAvailable。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-PassThru

會傳回 物件，代表您正在使用的專案。 根據預設，此 Cmdlet 不會產生任何輸出。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

String

TimeZoneInfo

輸出

None

根據預設，此 Cmdlet 不會傳回任何輸出。

TimeZoneInfo

當您使用 PassThru 參數時，這個 Cmdlet 會 傳回 TimeZoneInfo 物件。

備註

PowerShell 包含下列的 Set-TimeZone別名：

  • Windows：
    • stz

此 Cmdlet 僅適用於 Windows 平臺。