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

Start-Sleep

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

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

Синтаксис

Seconds (По умолчанию) 

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

Milliseconds 

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

FromTimeSpan 

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 миллисекунд.

Этот параметр был добавлен в PowerShell 7.3.

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

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

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

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

-Milliseconds

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

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

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

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

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

-Seconds

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

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

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

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

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

CommonParameters

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

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

Int32

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

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

None

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

Примечания

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

  • Виндоус:

    • sleep

  • Ctrl+C выходит из Start-Sleep.

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