Set-Date
Меняет системное время компьютера на указанное.
Синтаксис
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 .
Примеры
Пример 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 из New-TimeSpan
в Set-Date
.
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
— отображает дату и время.
Этот параметр влияет только на отображаемые значения
Он не влияет на извлекаемый Get-Date
объект DateTime.
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.