Set-Date

  • 參考
模組:
Microsoft.PowerShell.Utility

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

Syntax

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 參數。

範例

範例 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 $90mins

參數

-Adjust

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

Type:TimeSpan
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

執行 Cmdlet 之前先提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Date

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

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

Type:DateTime
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DisplayHint

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

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

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

Type:DisplayHintType
Accepted values:Date, Time, DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

DateTime

您可以使用管線將日期傳送至此 Cmdlet。

輸出

DateTime

此 Cmdlet 會傳回 物件，代表其設定的日期。

備註

  • 變更電腦上的日期和時間時，請謹慎使用此 Cmdlet。 變更可能會防止電腦接收由日期或時間觸發的系統範圍事件和更新。 使用 WhatIf 和 Confirm 參數來避免錯誤。
  • 您可以使用標準 .NET 方法搭配搭配使用的 Set-DateDateTime 和 TimeSpan 物件，例如 AddDays、AddMonths 和 FromFileTime。 如需詳細資訊，請參閱 .NET SDK 中的 DateTime 方法和TimeSpan 方法 。