Set-Date
Меняет системное время компьютера на указанное.
Синтаксис
Set-Date
[-Date] <DateTime>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-Date
[-Adjust] <TimeSpan>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Set-Date
изменяет системную дату и время на компьютере на указанную дату и время.
Можно указать новую дату и (или) время, введя строку или передав объект Set-Date
DateTime или TimeSpan в . Чтобы указать новую дату или время, используйте параметр Date .
Чтобы указать интервал изменения, используйте параметр Adjust .
Примеры
Пример 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
Параметры
-Adjust
Указывает значение, для которого этот командлет добавляет или вычитает из текущей даты и времени.
может ввести корректировку в стандартном формате даты и времени для языкового стандарта или использовать параметр Adjust для передачи объекта TimeSpan из Set-Date
New-TimeSpan
.
Type: | TimeSpan |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Date
Устанавливает указанные значения даты и времени.
Можно ввести новую дату в кратком формате даты, а время — в стандартном формате времени для используемого языкового стандарта. Кроме того, можно передать объект DateTime из Get-Date
.
Если указать дату, но не время, Set-Date
измените время на полночь указанной даты. Если указано только время, дата не изменяется.
Type: | DateTime |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplayHint
Указывает элементы даты и времени. Допустимые значения для этого параметра:
Date
— отображает только дату.Time
— отображает только время.DateTime
— отображает дату и время.
Этот параметр влияет только на отображаемые значения
Он не влияет на объект DateTime , который Get-Date
извлекается.
Type: | DisplayHintType |
Accepted values: | Date, Time, DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Вы можете передать дату в этот командлет.
Выходные данные
Этот командлет возвращает объект, представляющий заданную дату.
Примечания
- Используйте этот командлет осторожно при изменении даты и времени на компьютере. Из-за изменения даты или времени компьютер может не получать системные события и обновления, которые запускаются в определенный день или момент времени. Используйте параметры WhatIf и Confirm, чтобы избежать ошибок.
- Стандартные методы .NET можно использовать с объектами DateTime и TimeSpan, используемыми с
Set-Date
такими объектами, как AddDays, AddMonths и FromFileTime. Дополнительные сведения см. в разделе "Методы DateTime" и "Методы TimeSpan" в пакете SDK для .NET.
Связанные ссылки
PowerShell
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по