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.