次の方法で共有

Set-Date

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

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

構文

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

例

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

パラメーターのプロパティ

型: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 メソッド 」を参照してください。