Start-Sleep (Microsoft.PowerShell.Utility)

Start-Sleep

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

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

Синтаксис

Start-Sleep
     [-Seconds] <Double>
     [<CommonParameters>]

Start-Sleep
     -Milliseconds <Int32>
     [<CommonParameters>]

Start-Sleep
     -Duration <TimeSpan>
     [<CommonParameters>]

Описание

Командлет Start-Sleep приостанавливает действие сценария или сеанса на указанный период времени. Вы можете использовать его для многих задач, например для ожидания завершения операции или приостановки перед повторением операции.

Примеры

Пример 1: Приостановить выполнение на 1,5 секунды.

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

Start-Sleep -Seconds 1.5

Пример 2. Приостановка выполнения в командной строке

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

PS> Get-Date; Start-Sleep -Seconds 5; Get-Date

Friday, May 13, 2022 9:38:15 AM
Friday, May 13, 2022 9:38:20 AM

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

Пример 3. Команды сна с использованием TimeSpan

В этом примере все команды в сеансе приостанавливаются на 30 секунд.

Start-Sleep -Duration (New-TimeSpan -Seconds 30)

Параметры

-Duration

Использует объект TimeSpan, чтобы указать, как долго ресурс находится в режиме ожидания в миллисекундах. Значение не должно быть отрицательным TimeSpan и не должно превышать [int]::MaxValue миллисекунд.

Тип :: TimeSpan
Псевдонимы:: ts
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-Milliseconds

Указывает, как долго ресурс находится в режиме ожидания в миллисекундах. Параметр можно сократить до m.

Тип :: Int32
Псевдонимы:: ms
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-Seconds

Указывает, как долго ресурс находится в режиме ожидания в секундах. Вы можете опустить имя параметра или сократить его до s. Начиная с PowerShell 6.2.0, этот параметр принимает дробные значения.

Тип :: Двойной
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

Входы

Int32

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

Выходы

Нет

Этот командлет не возвращает никаких результатов.

Примечания

PowerShell включает следующие псевдонимы для Start-Sleep:

Windows:
Ctrl+C выходит из режима Start-Sleep.
Ctrl+C не выходит из состояния [Threading.Thread]::Sleep. Дополнительные сведения см. в разделе Метод Thread.Sleep.