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 將電腦上的系統日期和時間改成你指定的日期和時間。
你可以透過輸入字串或傳遞 DateTime 或 TimeSpan 物件來 Set-Date指定新的日期和/或時間。 要指定新的日期或時間，請使用 日期 參數。 若要指定變更區間，請使用 調整 參數。
您必須擁有更改系統日期與時間的行政權限。 在 Windows 上，啟動 PowerShell 時，選擇 以管理員身份執行。
範例
範例 1：在系統日期上加三天
此指令會為當前系統日期增加三天。 這不會影響時間。 指令使用 Date 參數來指定日期。
指令小程式會 Get-Date 以 DateTime 物件回傳當前日期。
DateTime 物件的 AddDays 方法會為目前的 DateTime 物件加上指定天數3（）。
Set-Date -Date (Get-Date).AddDays(3)
範例二：將系統時鐘往後調10分鐘
這個例子會將當前系統時間往後退 10 分鐘。
調整參數允許你以標準時間格式指定區域變更區間（減十分鐘）。
DisplayHint 參數告訴 PowerShell 只顯示時間，但不影響回Set-Date傳的 DateTime 物件。
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 建立一個 90 分鐘間隔的 TimeSpan 物件，並將其儲存在變數中 $90mins 。
第二個指令使用 AdjustSet-Date 參數，將日期調整為變數中 $90minsTimeSpan 物件的值。
$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
指定此指令子從當前日期與時間中加減的值。 你可以用標準的日期和時間格式輸入調整，或使用 Adjust（調整 ）參數將 TimeSpan 物件從 New-TimeSpan 傳到 Set-Date。
參數屬性
| 類型: | TimeSpan |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Adjust
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 參見 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Date
將日期和時間改為指定的值。 你可以用簡短日期格式輸入新日期，並以標準時間格式輸入您所在地區的時間。 或者，你也可以從 中傳遞一個 DateTime 物件。Get-Date
如果你指定日期但沒指定時間，時間會 Set-Date 改成指定日期的午夜。 如果你只指定時間，日期不會改變。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Date
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-DisplayHint
指定顯示日期與時間的哪些元素。 此參數可接受的值為：
-
Date- 只顯示日期。 -
Time- 只顯示時間。 -
DateTime- 顯示日期與時間。
這個參數只影響顯示器本身。 它不會影響擷取的 Get-DateDateTime 物件。
參數屬性
| 類型: | 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
你可以把日期輸入這個指令小程式。
輸出
DateTime
此 cmdlet 回傳一個物件，代表它設定的日期。
備註
- 在更改電腦日期和時間時，請謹慎使用這個指令。 此變更可能阻止電腦接收由日期或時間觸發的系統性事件與更新。 使用 WhatIf 和 Confirm 參數以避免錯誤。
- 你可以使用標準.NET方法，搭配
<>DateTime 和 TimeSpan 物件，例如AddDays 、AddMonths 以及FromFileTime 。 欲了解更多資訊，請參閱 .NET SDK 中的 DateTime Methods 及 TimeSpan 方法。
