Set-Date
将计算机上的系统时间更改为指定的时间。
语法
Date （默认值）
Set-Date
[-Date] <DateTime>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Adjust
Set-Date
[-Adjust] <TimeSpan>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Set-Date cmdlet 将计算机上的系统日期和时间更改为指定的日期和时间。
可以通过键入字符串或将 DateTime 或 TimeSpan 对象传递给 Set-Date来指定新的日期和时间。 若要指定新的日期或时间，请使用 Date 参数。
若要指定更改间隔，请使用 Adjust 参数。
示例
示例 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 参数将 中的 Set-Date 对象传递给 cmdlet。
$T = Get-Date
Set-Date -Date $T
示例 4：向系统时钟添加 90 分钟
这些命令将本地计算机上的系统时间提前 90 分钟。
第一个命令使用 New-TimeSpan cmdlet 创建 TimeSpan 对象，间隔为 90 分钟，并将其保存在 $90mins 变量中。
第二个命令使用 的 Set-Date 参数根据 变量中 $90mins 对象的值来调整日期。
$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins
参数
-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
指定显示日期和时间的元素。此参数的可接受值为：
- 日期。 仅显示日期。
- 时间。 仅显示时间。
- DateTime。 显示日期和时间。
此参数仅影响显示。
它不会影响 检索的 Get-Date 对象。
参数属性
| 类型: | DisplayHintType |
| 默认值: | None |
| 接受的值: | Date, Time, DateTime |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 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
可以通过管道将日期传递给 Set-Date。
输出
DateTime
Set-Date 返回一个对象，该对象表示所设置的日期。
备注
更改计算机上的日期和时间时，请谨慎使用此 cmdlet。 此更改可能会阻止计算机接收由日期或时间触发的系统范围事件和更新。 使用 WhatIf 和 确认 参数以避免错误。
可以将标准 .NET 方法与与 一起使用的 DateTime 和
Set-Date对象，例如 AddDays、AddMonths和 FromFileTime。 有关详细信息，请参阅 DateTime 方法 和MSDN 库中的 TimeSpan 方法。