Bagikan melalui


Set-TimeZone

Mengatur zona waktu sistem ke zona waktu tertentu.

Sintaks

Set-TimeZone
   [-Name] <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-TimeZone
   -Id <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-TimeZone
   [-InputObject] <TimeZoneInfo>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Cmdlet Set-TimeZone mengatur zona waktu sistem ke zona waktu tertentu.

Contoh

Contoh 1: Atur zona waktu menurut Id

Contoh ini mengatur zona waktu pada komputer lokal ke 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

Contoh 2: Atur zona waktu menurut nama

Contoh ini mengatur zona waktu pada komputer lokal ke UTC.

Set-TimeZone -Name 'Coordinated Universal Time' -PassThru

Seperti yang kita lihat dalam contoh sebelumnya, Id dan nama Zona Waktu tidak selalu cocok. Parameter Nama harus cocok dengan properti StandardName atau DaylightName objek TimeZoneInfo.

Nota

Nama zona waktu dapat bervariasi berdasarkan pengaturan Budaya di Windows. Contoh ini menunjukkan nilai untuk sistem yang diatur ke en-US.

Contoh 3 - Mencantumkan semua zona waktu yang tersedia

Daftar lengkap ID Zona Waktu dapat diperoleh dengan menjalankan perintah berikut:

Get-TimeZone -ListAvailable

Parameter

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Id

Menentukan ID zona waktu yang ditetapkan cmdlet ini.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-InputObject

Menentukan objek TimeZoneInfo untuk digunakan sebagai input.

Jenis:TimeZoneInfo
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Name

Menentukan nama zona waktu yang ditetapkan cmdlet ini. Daftar lengkap nama Zona Waktu dapat diperoleh dengan menjalankan perintah berikut: Get-TimeZone -ListAvailable.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-PassThru

Mengembalikan objek yang mewakili item tempat Anda bekerja. Secara default, cmdlet ini tidak menghasilkan output apa pun.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

TimeZoneInfo

Output

None

Secara default, cmdlet ini tidak mengembalikan output.

TimeZoneInfo

Saat Anda menggunakan parameter PassThru, cmdlet ini mengembalikan objek TimeZoneInfo.

Catatan

PowerShell menyertakan alias berikut untuk Set-TimeZone:

  • Windows:
    • stz

Cmdlet ini hanya tersedia di platform Windows.