Bagikan melalui


Set-TimeZone

Mengatur zona waktu sistem ke zona waktu tertentu.

Sintaks

Name (Default)

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

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 dari 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.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Id

Menentukan ID zona waktu yang ditetapkan cmdlet ini.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Id
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-InputObject

Menentukan objek TimeZoneInfo untuk digunakan sebagai input.

Properti parameter

Jenis:TimeZoneInfo
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

InputObject
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Name

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

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Name
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-PassThru

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

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

TimeZoneInfo

Output

None

Secara default, cmdlet ini tidak mengembalikan output.

TimeZoneInfo

Ketika 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.