共用方式為

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 平臺上使用。

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

範例

範例 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 或 Daylight Name 屬性。

注意

時區名稱可能會根據 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別名：

  • 窗戶：
    • stz

此 Cmdlet 僅適用於 Windows 平臺。