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 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
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	cf

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Id

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

參數屬性

類型:	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 平臺。

相關連結

• Get-TimeZone