Поделиться через

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 изменяет системную дату и время на компьютере на указанную дату и время.

Можно указать новую дату и (или) время, введя строку или передав объект Set-DateDateTime или TimeSpan в . Чтобы указать новую дату или время, используйте параметр 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 отображать только время, но не влияет на возвращаемый объект Set-Date DateTime.

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 из Set-DateNew-TimeSpan .

Тип:TimeSpan
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Date

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

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

Тип:DateTime
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DisplayHint

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

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

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

Тип:DisplayHintType
Допустимые значения:Date, Time, DateTime
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

DateTime

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

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

DateTime

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

Примечания

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