Set-TimeZone

  • 參考
模組:
Microsoft.PowerShell.Management

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

Syntax

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 會將 Set-TimeZone 系統時區設定為指定的時區。

範例

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

本範例會將本機計算機上的時區設定為UTC。

Set-TimeZone -Id "UTC"

Id                         : UTC
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 之前先提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

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

輸入

String

TimeZoneInfo

輸出

None

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

TimeZoneInfo

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

備註

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

  • stz