Поиск по сайту:

Set-Date (Microsoft.PowerShell.Utility)

Set-Date

Модуль:
Microsoft.PowerShell.Utility

Изменяет системное время на компьютере на указанное вами время.

Синтаксис

Set-Date
   [-Date] <DateTime>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Date
   [-Adjust] <TimeSpan>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-Date изменяет системную дату и время на компьютере на указанные вами дату и время.

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

Для изменения системной даты и времени у вас должны быть права администратора. В Windows запустите PowerShell с параметром Запуск от имени администратора.

Примеры

Пример 1. Добавьте три дня к системной дате.

Эта команда добавляет три дня к текущей системной дате. На время это не влияет. Команда использует параметр Date для указания даты.

Командлет Get-Date возвращает текущую дату в виде объекта DateTime. Метод AddDays объекта DateTime добавляет указанное количество дней (3) к текущему объекту DateTime.

Set-Date -Date (Get-Date).AddDays(3)

Пример 2. Установите системные часы на 10 минут назад.

В этом примере текущее системное время устанавливается на 10 минут назад.

Параметр Adjust позволяет указать интервал изменения (минус десять минут) в стандартном формате времени для данной локали.

Параметр DisplayHint указывает PowerShell отображать только время, но не влияет на объект DateTime, который возвращает Set-Date.

Set-Date -Adjust -0:10:0 -DisplayHint Time

Пример 3. Установите дату и время в значение переменной

Эти команды изменяют системную дату и время на локальном компьютере на дату и время, сохраненные в переменной $T. Первая команда получает дату и сохраняет ее в $T.

Вторая команда использует параметр Date для передачи объекта DateTime в $T командлету Set-Date.

$T = Get-Date
Set-Date -Date $T

Пример 4. Добавьте 90 минут к системным часам.

Эти команды увеличивают системное время на локальном компьютере на 90 минут.

Первая команда использует командлет New-TimeSpan для создания объекта TimeSpan с 90-минутным интервалом и сохраняет его в переменной $90mins. .

Вторая команда использует параметр Adjust Set-Date для корректировки даты по значению объекта TimeSpan в $90mins. переменная.

$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 в Установить дату.

Тип :

TimeSpan

Позиция:

0

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

None

Необходимый:

True

Примите ввод конвейера:

True

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

False

-Confirm

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

Тип :

SwitchParameter

Псевдонимы:

cf

Позиция:

Именованный

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

False

Необходимый:

False

Примите ввод конвейера:

False

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

False

-Date

Изменяет дату и время на указанные значения. Вы можете ввести новую дату в коротком формате даты и время в стандартном формате времени для вашего региона. Или вы можете передать объект DateTime из Get-Date.

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

Тип :

DateTime

Позиция:

0

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

None

Необходимый:

True

Примите ввод конвейера:

True

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

False

-DisplayHint

Указывает, какие элементы даты и времени отображаются. Допустимые значения этого параметра:

  • Дата — отображает только дату.
  • Время — отображает только время.
  • DateTime — отображает дату и время.

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

Тип :

Дисплайхинттипе

Принятые значения:

Дата, Время, ДатаВремя

Позиция:

Именованный

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

None

Необходимый:

False

Примите ввод конвейера:

False

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

False

-WhatIf

Показывает, что произойдет, если командлет запустится. Командлет не запускается.

Тип :

SwitchParameter

Псевдонимы:

wi

Позиция:

Именованный

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

False

Необходимый:

False

Примите ввод конвейера:

False

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

False

Входы

ДатаВремя

Вы можете передать дату этому командлету.

Выходы

ДатаВремя

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

Примечания

  • Используйте этот командлет с осторожностью при изменении даты и времени на компьютере. Это изменение может помешать компьютеру получать общесистемные события и обновления, которые инициируются датой или временем. Используйте параметры WhatIf и Confirm, чтобы избежать ошибок.
  • Вы можете использовать стандартные методы .NET с объектами DateTime и TimeSpan, используемыми с Set-Date, например AddDays. , AddMonths и FromFileTime. Дополнительные сведения см. в разделах Методы DateTime и Методы TimeSpan в пакете SDK для .NET.