共用方式為

Set-Date

  • 參考
模組:
Microsoft.PowerShell.Utility

將電腦上的系統時間變更為您指定的時間。

語法

Set-Date
   [-Date] <DateTime>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Date
   [-Adjust] <TimeSpan>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-Date Cmdlet 會將電腦上的系統日期和時間變更為您指定的日期和時間。 您可以輸入字串或傳遞 DateTime 或 TimeSpan 物件，Set-Date以指定新的日期和時間和/或時間。 若要指定新的日期或時間，請使用 Date 參數。 若要指定變更間隔，請使用 Adjust 參數。

範例

範例 1：將三天新增至系統日期

此命令會將三天新增至目前的系統日期。 這不會影響時間。 命令會使用 Date 參數來指定日期。

Get-Date Cmdlet 會以 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中。

第二個命令會使用 Date 參數，將 $T 中的 DateTime 對象傳遞至 Set-Date Cmdlet。

$T = Get-Date
Set-Date -Date $T

範例 4：將 90 分鐘新增至系統時鐘

這些命令會將本機電腦上的系統時間提前 90 分鐘。

第一個命令會使用 New-TimeSpan Cmdlet，建立具有 90 分鐘間隔的 TimeSpan 物件，並將它儲存在 $90mins 變數中。

第二個命令會使用 Set-Date 的 Adjust 參數，根據 $90mins 變數中 TimeSpan 物件的值來調整日期。

$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins

參數

-Adjust

指定這個 Cmdlet 從目前日期和時間加入或減去的值。 可以輸入地區設定的標準日期和時間格式調整，或使用 Adjust 參數，將 TimeSpan 物件從 New-TimeSpan 傳遞至 Set-Date。

類型:TimeSpan
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Date

將日期和時間變更為指定的值。 您可以輸入簡短日期格式的新日期，並以地區設定的標準時間格式輸入時間。 或者，您可以從 Get-Date傳遞 DateTime 物件。

如果您指定日期，但不是時間，Set-Date 將指定日期的時間變更為午夜。 如果您只指定時間，則不會變更日期。

類型:DateTime
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-DisplayHint

指定顯示日期和時間的專案。此參數可接受的值為：

  • Date。 只會顯示日期。
  • 時間。 只會顯示時間。
  • DateTime。 會顯示日期和時間。

此參數只會影響顯示器。 它不會影響 Get-Date 擷取 DateTime 物件。

類型:DisplayHintType
接受的值:Date, Time, DateTime
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

DateTime

您可以使用管線將日期傳送至 Set-Date。

輸出

DateTime

Set-Date 會傳回 代表其設定日期的物件。

備註

  • 變更電腦上的日期和時間時，請謹慎使用此 Cmdlet。 變更可能會防止電腦接收由日期或時間觸發的系統範圍事件和更新。 使用 WhatIf 和 Confirm 參數來避免錯誤。

  • 您可以使用標準 .NET 方法搭配 DateTime 和 TimeSpan 物件搭配 使用，例如 AddDays、AddMonths，以及 fromFileTime。 如需詳細資訊，請參閱 DateTime 方法 和

    MSDN 連結庫中 TimeSpan 方法。