将计算机上的系统时间更改为指定的时间。
语法
Set-Date [-Adjust] <TimeSpan> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirm] [-WhatIf] [<CommonParameters>]
Set-Date [-日期] <DateTime> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirm] [-WhatIf] [<CommonParameters>]
说明
Set-Date cmdlet 将计算机上的系统日期和时间更改为指定的日期和时间。通过键入字符串或通过将 DateTime 或 TimeSpan 对象传递给 Set-Date，可以指定新的日期和/或时间。若要指定新的日期或时间，请使用 Date 参数。若要指定更改间隔，请使用 Adjust 参数。
参数
-Adjust <TimeSpan>
向当前日期和时间中添加指定的值，或从中减去指定的值。您可以采用您的区域设置的标准日期和时间格式来键入调整，也可以使用 Adjust 参数将 TimeSpan 对象从 New-TimeSpan 传递给 Set-Date。
|
是否为必需？ |
true |
|
位置？ |
1 |
|
默认值 |
|
|
是否接受管道输入？ |
true (ByPropertyName) |
|
是否接受通配符？ |
false |
-日期 <DateTime>
将日期和时间更改为指定的值。您可以采用短日期格式键入新日期，并以您的区域设置的标准时间格式键入时间。或者，您也可以从 Get-Date 传递 Date-Time 对象。
如果指定了日期而未指定时间，则 Set-Date 会将时间更改为指定日期的午夜 12 点。如果仅指定了时间，则不会更改日期。
|
是否为必需？ |
true |
|
位置？ |
1 |
|
默认值 |
|
|
是否接受管道输入？ |
true (ByValue, ByPropertyName) |
|
是否接受通配符？ |
false |
-DisplayHint <DisplayHintType>
确定要显示哪些日期和时间元素。
有效值包括：
-- date：仅显示日期
-- time：仅显示时间
-- datetime：显示日期和时间
此参数仅影响显示内容，而不影响 Get-Date 检索到的 DateTime 对象。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
-Confirm
在执行命令之前提示您进行确认。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
-WhatIf
描述如果执行该命令会发生什么情况（无需实际执行该命令）。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
<CommonParameters>
此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.
输入和输出
输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。
|
输入 |
System.DateTime 可以通过管道将日期传递给 Set-Date。 |
|
输出 |
System.DateTime Set-Date 返回一个表示它所设置的日期的对象。 |
说明
请谨慎使用此 cmdlet。更改计算机上的日期和时间。此更改可能会使计算机无法接收由日期或时间触发的系统范围的事件和更新。使用 -WhatIf 和 -Confirm 参数可避免出现错误。
您可以在 Set-Date 中使用 DateTime 和 TimeSpan 对象的标准 .NET 方法，例如 AddDays、AddMonths 和 FromFileTime。有关详细信息，请参阅“DateTime 方法”和“TimeSpan 方法”。
示例 1
C:\PS>Set-Date -Date (Get-Date).AddDays(3) 说明 ----------- 此命令对当前系统日期加上三天。它不会影响时间。此命令使用 Date 参数来指定日期。它使用 Get-Date cmdlet 来获取当前日期和时间，并使用值 3（天）对 DateTime 对象应用 AddDays .NET 方法。
示例 2
C:\PS>set-date -adjust -0:10:0 -displayHint time 说明 ----------- 此命令将当前系统时间回调 10 分钟。它使用 Adjust 参数以区域设置的标准时间格式来指定更改间隔和时间更改（减去 10 分钟）。DisplayHint 参数指示 Windows PowerShell 仅显示时间，但不会影响 Set-Date 返回的 DateTime 对象。
示例 3
C:\PS>$t = get-date C:\PS>set-date -date $t 说明 ----------- 这些命令将计算机上的系统日期和时间更改为变量 $t 中保存的日期和时间。第一条命令获取日期并将其存储在 $t 中。第二条命令使用 Date 参数将 $t 中的 DateTime 对象传递给 Set-Date cmdlet。
示例 4
C:\PS>$90mins = new-timespan -minutes 90 C:\PS>set-date -adjust $90mins 说明 ----------- 这些命令将本地计算机上的系统时间前调 90 分钟。第一条命令使用 New-Timespan cmdlet 创建具有 90 分钟间隔的 TimeSpan 对象，然后将该 TimeSpan 对象保存到 $90mins 变量中。第二条命令使用 Set-Date 的 Adjust 参数按照 $90mins 变量中的 TimeSpan 对象值来调整日期。
另请参阅