Set-Date
將電腦上的系統時間變更為您指定的時間。
語法
Date (預設值)
Set-Date
[-Date] <DateTime>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Adjust
Set-Date
[-Adjust] <TimeSpan>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-Date Cmdlet 會將電腦上的系統日期和時間變更為您指定的日期和時間。
您可以輸入字串或傳遞 DateTime 或 TimeSpan 物件，Set-Date以指定新的日期和時間和/或時間。 若要指定新的日期或時間，請使用 Date 參數。 若要指定變更間隔，請使用 Adjust 參數。
您必須擁有系統管理許可權，才能變更系統日期和時間。 在 Windows 上，使用 [以系統管理員身分執行] 選項 啟動 PowerShell。
範例
範例 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 物件。
Set-Date -Adjust -0:10:0 -DisplayHint Time
範例 3：將日期和時間設定為變數值
這些指令會將本機電腦上的系統日期和時間變更為變數中所儲存的日期和時間 $T。 第一個命令會取得日期，並將它儲存在 $T中。
第二個命令會使用 Date 參數，將 中的 $T 對象傳遞至 Set-Date Cmdlet。
$T = Get-Date
Set-Date -Date $T
範例 4：將 90 分鐘新增至系統時鐘
這些命令會將本機電腦上的系統時間提前 90 分鐘。
第一個命令會使用 New-TimeSpan Cmdlet，建立具有 90 分鐘間隔的 TimeSpan 物件，並將它儲存在 $90mins 變數中。
第二個命令會使用 的 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
指定這個 Cmdlet 從目前日期和時間加入或減去的值。 您可以輸入地區設定的標準日期和時間格式調整，或使用 Adjust 參數，將 TimeSpan 物件從 New-TimeSpan 傳遞至 Set-Date。
參數屬性
| 類型: | TimeSpan |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Adjust
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Date
將日期和時間變更為指定的值。 您可以輸入簡短日期格式的新日期，並以地區設定的標準時間格式輸入時間。 或者，您可以從 傳遞 Get-Date 物件。
如果您指定日期，但不是時間，Set-Date 將指定日期的時間變更為午夜。 如果您只指定時間，則不會變更日期。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Date
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-DisplayHint
指定顯示日期和時間的專案。 此參數可接受的值為：
-
Date- 只顯示日期。 -
Time- 只顯示時間。 -
DateTime- 顯示日期和時間。
此參數只會影響顯示器。 它不會影響 擷取 Get-Date 物件。
參數屬性
| 類型: | DisplayHintType |
| 預設值: | None |
| 接受的值: | Date, Time, DateTime |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 該 Cmdlet 未被執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
DateTime
您可以使用管線將日期傳送至此 Cmdlet。
輸出
DateTime
此 Cmdlet 會傳回 物件，代表其設定的日期。
備註
- 變更電腦上的日期和時間時，請謹慎使用此 Cmdlet。 變更可能會防止電腦接收由日期或時間觸發的系統範圍事件和更新。 使用 WhatIf 和 Confirm 參數來避免錯誤。
- 您可以使用標準 .NET 方法搭配
DateTime 和TimeSpan 物件搭配使用，例如 AddDays 、AddMonths ，以及 fromFileTime。 如需詳細資訊，請參閱 .NET SDK 中的 DateTime 方法 和 TimeSpan 方法。
