Set-Date
コンピューターのシステム時刻を、指定した時刻に変更します。
構文
Date (既定)
Set-Date
[-Date] <DateTime>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Adjust
Set-Date
[-Adjust] <TimeSpan>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-Date コマンドレットは、コンピューター上のシステムの日付と時刻を指定した日付と時刻に変更します。
新しい日付や時刻を指定するには、文字列を入力するか、 DateTime オブジェクトまたは TimeSpan オブジェクトを Set-Date に渡します。 新しい日付または時刻を指定するには、 Date パラメーターを使用します。 変更間隔を指定するには、 Adjust パラメーターを使用します。
システムの日付と時刻を変更するには、管理者権限が必要です。 Windows では、[ 管理者として実行 ] オプションを使用して PowerShell を起動します。
例
例 1: システム日付に 3 日を追加する
このコマンドは、現在のシステム日付に 3 日を加算します。 時間には影響しません。 このコマンドでは、 Date パラメータを使用して日付を指定します。
Get-Date コマンドレットは、現在の日付を DateTime オブジェクトとして返します。
DateTime オブジェクトの AddDays メソッドは、指定した日数 (3) を現在の DateTime オブジェクトに追加します。
Set-Date -Date (Get-Date).AddDays(3)
例 2: システム・クロックを 10 分戻す
この例では、現在のシステム時刻を 10 分戻します。
Adjust パラメーターを使用すると、ロケールの標準時間形式で変更間隔 (10 分未満) を指定できます。
DisplayHint パラメーターは PowerShell に時刻のみを表示するように指示しますが、Set-Dateが返す DateTime オブジェクトには影響しません。
Set-Date -Adjust -0:10:0 -DisplayHint Time
例 3: 日付と時刻を変数値に設定する
これらのコマンドは、ローカル コンピューター上のシステムの日付と時刻を、変数 $T に保存された日付と時刻に変更します。 最初のコマンドは、日付を取得して $T に格納します。
2 番目のコマンドは、Date パラメーターを使用して、 の $T オブジェクトを Set-Date コマンドレットに渡します。
$T = Get-Date
Set-Date -Date $T
例 4: システム・クロックに 90 分を追加する
これらのコマンドは、ローカル コンピューターのシステム時刻を 90 分進めます。
最初のコマンドでは、 New-TimeSpan コマンドレットを使用して 90 分間隔の TimeSpan オブジェクトを作成し、 $90mins 変数に保存します。
2 番目のコマンドは、 の Set-Date パラメーターを使用して、 変数の $90mins オブジェクトの値で日付を調整します。
$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins
5: 特定の日付と時刻に変更する
次の例では、日付と時刻を特定の値に設定します。
PS> Get-Date
Monday, June 10, 2024 2:05:48 PM
PS> Set-Date '6/11/2024 2:05:48 PM'
Tuesday, June 11, 2024 2:05:48 PM
パラメーター
-Adjust
このコマンドレットが現在の日付と時刻を加算または減算する値を指定します。 ロケールの標準の日付と時刻形式で調整を入力するか、Adjust パラメーターを使用して、New-TimeSpanからSet-Dateに TimeSpan オブジェクトを渡すことができます。
パラメーターのプロパティ
| 型: | TimeSpan |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Adjust
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Date
日付と時刻を指定した値に変更します。 新しい日付は短い日付形式で入力し、時刻はロケールの標準時間形式で入力できます。 または、 から Get-Date オブジェクトを渡すこともできます。
時刻ではなく日付を指定した場合、 Set-Date は時刻を指定した日付の深夜に変更されます。 時刻のみを指定した場合、日付は変更されません。
パラメーターのプロパティ
| 型: | DateTime |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Date
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-DisplayHint
表示する日付と時刻の要素を指定します。 このパラメーターに使用できる値は次のとおりです。
-
Date- 日付のみを表示します。 -
Time- 時刻のみを表示します。 -
DateTime- 日付と時刻を表示します。
このパラメータは、表示にのみ影響します。
Get-Date取得する DateTime オブジェクトには影響しません。
パラメーターのプロパティ
| 型: | DisplayHintType |
| 規定値: | None |
| 指定可能な値: | Date, Time, DateTime |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
DateTime
このコマンドレットに日付をパイプできます。
出力
DateTime
このコマンドレットは、設定した日付を表すオブジェクトを返します。
メモ
- このコマンドレットは、コンピューターの日付と時刻を変更するときは慎重に使用してください。 この変更により、コンピューターは、日付または時刻によってトリガーされるシステム全体のイベントと更新を受信できなくなる可能性があります。 WhatIf パラメータと Confirm パラメータを使用して、エラーを回避します。
- 標準の .NET メソッドは、AddDays、AddMonths、
Set-Dateなどの で使用される DateTime オブジェクトと TimeSpan オブジェクトと共に使用できます。 詳細については、「.NET SDK の DateTime メソッド と TimeSpan メソッド 」を参照してください。
