Set-Date
將電腦上的系統時間變更為您指定的時間。
語法
Set-Date
[-Date] <DateTime>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-Date
[-Adjust] <TimeSpan>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Cmdlet 會將 Set-Date 電腦上的系統日期和時間變更為您指定的日期和時間。
您可以輸入字串或將 DateTime 或 TimeSpan 物件傳遞至 Set-Date，以指定新的日期和時間和/或時間。 若要指定新的日期或時間，請使用 Date 參數。 若要指定變更間隔，請使用 Adjust 參數。
您必須擁有系統管理許可權，才能變更系統日期和時間。 在 Windows 上，使用 [ 以系統管理員 身分執行] 選項啟動 PowerShell。
範例
範例 1：將三天新增至系統日期
此命令會將三天新增至目前的系統日期。 這不會影響時間。 命令會 使用 Date 參數來指定日期。
Cmdlet 會將 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中。
第二個命令會使用 Date 參數，將中的 DateTime 對象$T傳遞至 Set-Date Cmdlet。
$T = Get-Date
Set-Date -Date $T範例 4：將 90 分鐘新增至系統時鐘
這些命令會將本機電腦上的系統時間提前 90 分鐘。
第一個命令會New-TimeSpan使用 Cmdlet 來建立 TimeSpan 物件，間隔為 90 分鐘，並將它儲存在變數中$90mins。
第二個命令會使用 的 Set-Date Adjust 參數，依變數中 $90mins TimeSpan 物件的值來調整日期。
$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins5：變更為特定日期和時間
下列範例會將日期和時間設定為特定值。
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 |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前先提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Date
將日期和時間變更為指定的值。 您可以輸入簡短日期格式的新日期，並以地區設定的標準時間格式輸入時間。 或者，您可以從 傳遞 DateTime 物件 Get-Date。
如果您指定日期，但不是時間， Set-Date 請將指定日期的時間變更為午夜。 如果您只指定時間，則不會變更日期。
| 類型: | DateTime |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-DisplayHint
指定顯示日期和時間的專案。 此參數可接受的值為：
Date- 只顯示日期。Time- 只顯示時間。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 |
輸入
您可以使用管線將日期傳送至此 Cmdlet。
輸出
此 Cmdlet 會傳回 物件，代表其設定的日期。
備註
- 變更電腦上的日期和時間時，請謹慎使用此 Cmdlet。 變更可能會防止電腦接收由日期或時間觸發的系統範圍事件和更新。 使用 WhatIf 和 Confirm 參數來避免錯誤。
- 您可以使用標準 .NET 方法搭配搭配使用的
Set-DateDateTime 和 TimeSpan 物件，例如 AddDays、AddMonths 和 FromFileTime。 如需詳細資訊，請參閱 .NET SDK 中的 DateTime 方法和 TimeSpan 方法 。
