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

Set-Date

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

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

Синтаксис

Date (по умолчанию) 

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

Adjust 

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

Описание

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

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

Чтобы изменить системную дату и время, необходимо иметь права администратора. В Windows запустите PowerShell с параметром запуск от имени администратора.

Примеры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вторая команда использует параметр Adjust для настройки даты по значению объекта timeSpan TimeS в переменной .

$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

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

Свойства параметра

Тип:TimeSpan
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Adjust
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Confirm

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Date

Изменяет дату и время на указанные значения. Вы можете ввести новую дату в коротком формате даты и время в стандартном формате времени для языкового стандарта. Кроме того, можно передать объект dateTime dateTime из .

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

Свойства параметра

Тип:DateTime
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Date
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DisplayHint

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

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

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

Свойства параметра

Тип:DisplayHintType
Default value:None
Допустимые значения:Date, Time, DateTime
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

DateTime

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

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

DateTime

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

Примечания

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