Set-TimeZone

模組:

Microsoft.PowerShell.Management Module

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

語法

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>]

Description

此 Cmdlet 只能在 Windows 平臺上使用。

指令長子將 Set-TimeZone 系統時區設定為指定的時區。

範例

範例 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 屬性相符。

Note

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

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

可透過執行以下指令獲得完整的時區 ID 清單：

Get-TimeZone -ListAvailable

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(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

指定此指令本設定的時區名稱。 可透過執行以下指令獲得完整的時區名稱清單： 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 平臺。

相關連結

• Get-TimeZone