Set-TimeZone
システム タイム ゾーンを指定したタイム ゾーンに設定します。
構文
Set-TimeZone
[-Name] <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-TimeZone
-Id <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-TimeZone
[-InputObject] <TimeZoneInfo>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
Set-TimeZone コマンドレットは、システム タイム ゾーンを指定したタイム ゾーンに設定します。
例
例 1: タイム ゾーンを ID で設定する
次の使用例は、ローカル コンピューターのタイム ゾーンを 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
前の例で説明したように、タイム ゾーンの ID と 名の が常に一致するとは限りません。 Name パラメーターは、TimeZoneInfo オブジェクトの StandardName プロパティまたは DaylightName プロパティと一致する必要があります。
手記
タイム ゾーン名は、Windows のカルチャ設定によって異なる場合があります。 この例では、en-USに設定されたシステムの値を示します。
例 3 - 使用可能なすべてのタイム ゾーンを一覧表示する
タイム ゾーン ID の完全な一覧は、次のコマンドを実行して取得できます。
Get-TimeZone -ListAvailable
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Id
このコマンドレットが設定するタイム ゾーンの ID を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-InputObject
入力として使用する TimeZoneInfo オブジェクトを指定します。
| 型: | TimeZoneInfo |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Name
このコマンドレットが設定するタイム ゾーンの名前を指定します。 タイム ゾーン名の完全な一覧は、次のコマンドを実行して取得できます: Get-TimeZone -ListAvailable.
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PassThru
作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
出力
None
既定では、このコマンドレットは出力を返しません。
PassThru パラメーターを使用すると、このコマンドレットは TimeZoneInfo オブジェクトを返します。
メモ
PowerShell には、Set-TimeZoneの次のエイリアスが含まれています。
- ウィンドウズ:
stz
このコマンドレットは、Windows プラットフォームでのみ使用できます。