Set-Date

モジュール:: Microsoft.PowerShell.Utility

コンピューターのシステム時刻を、指定した時刻に変更します。

構文

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 パラメーターを使用します。

例

例 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 オブジェクトには影響しません。

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

パラメーター

-Adjust

このコマンドレットが現在の日付と時刻を加算または減算する値を指定します。では、ロケールの標準の日付と時刻の形式で調整を入力するか、 Adjust パラメーターを使用して TimeSpan オブジェクトを New-TimeSpan から Set-Date に渡すことができます。

型:	TimeSpan
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Date

日付と時刻を指定した値に変更します。新しい日付は短い日付形式で入力し、時刻はロケールの標準時間形式で入力できます。または、から Get-Date オブジェクトを渡すこともできます。

時刻ではなく日付を指定した場合、 Set-Date は時刻を指定した日付の深夜に変更されます。時刻のみを指定した場合、日付は変更されません。

型:	DateTime
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DisplayHint

日付と時刻のどの要素を表示するかを指定します。このパラメータに指定できる値は次のとおりです。

Date 値です。日付のみを表示します。
時刻。時刻のみを表示します。
DateTime。日付と時刻が表示されます。

このパラメータは、表示にのみ影響します。が取得する Get-Date オブジェクトには影響しません。

型:	DisplayHintType
指定可能な値:	Date, Time, DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

DateTime

日付を Set-Date にパイプできます。

出力