Set-Date
指定する時刻にコンピューターのシステム時刻を変更します。
構文
Set-Date
[-Date] <DateTime>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
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 に指示しますが、返される DateTime オブジェクトにはSet-Date
影響しません。
Set-Date -Adjust -0:10:0 -DisplayHint Time
例 3: 日付と時刻を変数値に設定する
これらのコマンドは、ローカル コンピューター上のシステムの日付と時刻を変数 $T
に保存された日付と時刻に変更します。 最初のコマンドは日付を取得し、それを $T
.
2 番目のコマンドでは、Date パラメーターを使用して DateTime オブジェクト$T
をコマンドレットにSet-Date
渡します。
$T = Get-Date
Set-Date -Date $T
例 4: システム クロックに 90 分を追加する
これらのコマンドは、ローカル コンピューターのシステム時刻を 90 分進めます。
最初のコマンドでは、コマンドレットをNew-TimeSpan
使用して 90 分間隔の TimeSpan オブジェクトを作成し、変数に$90mins
保存します。
2 番目のSet-Date
コマンドでは、Adjust パラメーターを使用して、変数内の TimeSpan オブジェクトの値で日付を$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 パラメーターを使用して TimeSpan オブジェクトSet-Date
New-TimeSpan
を渡すことができます。
型: | TimeSpan |
Position: | 0 |
既定値: | None |
必須: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
Position: | Named |
既定値: | False |
必須: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Date
指定した値に日付と時刻を変更します。 新しい日付をロケールに対応する短い日付形式で、時刻をロケールに対応する標準の時刻形式で入力できます。 または、DateTime オブジェクトGet-Date
を渡すことができます。
日付を指定するが、時刻を指定しない場合は、 Set-Date
指定した日付の午前 0 時に時刻を変更します。 時刻のみを指定した場合、日付は変更されません。
型: | DateTime |
Position: | 0 |
既定値: | None |
必須: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplayHint
表示する日付と時刻の要素を指定します。 このパラメーターの有効値は、次のとおりです。
Date
- 日付のみを表示します。Time
- 時刻のみを表示します。DateTime
- 日付と時刻を表示します。
このパラメーターは、表示のみに影響します。 取得する DateTime オブジェクトには Get-Date
影響しません。
型: | DisplayHintType |
承認された値: | Date, Time, DateTime |
Position: | Named |
既定値: | None |
必須: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
Position: | Named |
既定値: | False |
必須: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
このコマンドレットに日付をパイプできます。
出力
このコマンドレットは、設定した日付を表すオブジェクトを返します。
メモ
- コンピューターの日付と時刻を変更する場合は、このコマンドレットを慎重に使用してください。 変更によって、コンピューターが、日付または時刻に基づいてトリガーされるシステム全体のイベントと更新を受信できなくなる可能性があります。 エラーを回避するには、 WhatIf パラメーターと Confirm パラメーターを使用します。
- 標準の .NET メソッドは、AddDays、AddMonths、FromFileTime など、DateTime オブジェクトと TimeSpan オブジェクトで
Set-Date
使用できます。 詳細については、「.NET SDK の DateTime メソッドと TimeSpan メソッド」を参照してください。
関連リンク
PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示