Устанавливает системное время на компьютере.

Синтаксис

Set-Date [-Adjust] <TimeSpan> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirm] [-WhatIf] [<CommonParameters>]

Set-Date [-Date] <DateTime> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirm] [-WhatIf] [<CommonParameters>]

Описание

Командлет Set-Date изменяет системные дату и время, заменяя их указанными значениями. Указать новую дату и время можно в виде строки, или передав командлету Set-Date объект DateTime или TimeSpan. Для указания новой даты или времени используйте параметр Date. Для указания интервала изменения используйте параметр Adjust.

Параметры

-Adjust <TimeSpan>

Прибавляет или вычитает указанное значение из текущей даты и времени. Можно вводить изменения в стандартном формате даты и времени для используемой локали либо использовать параметр Adjust, чтобы передать объект TimeSpan от командлета New-TimeSpan командлету Set-Date.

Обязательно?

true

Позиция?

1

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByPropertyName)

Принимать подстановочные знаки?

false

-Date <DateTime>

Устанавливает указанные значения даты и времени. Можно ввести новую дату в кратком формате даты, а время в стандартном формате времени для используемой локали. Или можно передать объект Date-Time из командлета Get-Date.

Если задана только дата (без времени), командлет Set-Date устанавливает время на полночь указанной даты. Если указано только время, дата не изменяется.

Обязательно?

true

Позиция?

1

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByValue, ByPropertyName)

Принимать подстановочные знаки?

false

-DisplayHint <DisplayHintType>

Определяет, какие элементы даты и времени будут отображаться.

Допустимые значения:

-- date: отображается только дата;

-- time: отображается только время;

-- datetime: отображаются дата и время.

Этот параметр влияет только на выводимый результат. Он не влияет на объект DateTime, возвращаемый командлетом Get-Date.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-Confirm

Запрашивает подтверждение перед выполнением команды.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-WhatIf

Описывает, что произойдет при выполнении команды, без ее фактического выполнения.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

Входные данные

System.DateTime

Можно передать дату в Set-Date с помощью конвейера.

Выходные данные

System.DateTime

Командлет Set-Date возвращает объект, представляющий заданную им дату.

Примечания

Используя этот командлет для изменения даты и времени на компьютере, будьте внимательны. Из-за изменения даты или времени компьютер может не получать системные события и обновления, которые запускаются в определенный день или момент времени. Для предотвращения ошибок используйте параметры -WhatIf и -Confirm.

Для работы с объектами DateTime и TimeSpan, которые используются с командлетом Set-Date, можно применять стандартные методы .NET, такие как AddDays, AddMonths и FromFileTime. Дополнительные сведения см. в разделах "Методы объектов DateTime" и "Методы объектов TimeSpan".

Пример 1

C:\PS>Set-Date -Date (Get-Date).AddDays(3)

Описание
-----------
Эта команда добавляет к текущей системной дате три дня. На время она не влияет. Параметр Date используется в этой команде для указания даты. Командлет Get-Date возвращает текущие значения даты и времени, после чего для объектов DateTime вызывается метод AddDays платформы .NET, добавляющий к текущей дате 3 дня.






Пример 2

C:\PS>set-date -adjust -0:10:0 -displayHint time

Описание
-----------
Эта команда переводит текущее системное время на 10 минут назад. Параметр Adjust используется в ней для указания интервала изменения (минус 10 минут) в стандартном формате времени текущей локали. Параметр DisplayHint указывает, что должно быть отображено только время; но он не влияет на объект DateTime, возвращаемый командлетом Set-Date.






Пример 3

C:\PS>$t = get-date

C:\PS>set-date -date $t

Описание
-----------
Эти команды изменяют системные дату и время компьютера, заменяя их значением, сохраненным в переменной $t. Первая команда получает дату и сохраняет ее в переменной $t. Вторая команда с помощью параметра Date передает объект DateTime из переменной $t командлету Set-Date.






Пример 4

C:\PS>$90mins = new-timespan -minutes 90

C:\PS>set-date -adjust $90mins

Описание
-----------
Эти команды переводят системное время на локальном компьютере на 90 минут вперед. Первая команда с помощью командлета New-Timespan создает объект TimeSpan, определяющий 90-минутный интервал, после чего сохраняет его в переменной $90mins. Вторая команда с помощью параметра Adjust командлета Set-Date изменяет время на интервал, который определяется объектом TimeSpan, сохраненным в переменной $90mins.






См. также