Ресурс DSC WaitForSome

Область применения: Windows PowerShell 5.x

Ресурс настройки требуемого состояния WaitForSome можно использовать в блоке узла в конфигурации DSC для определения зависимостей от конфигураций на других узлах.

Примечание

В этой документации по этому ресурсу DSC рассматривается версия, которая входит в состав PowerShell до версии 7.2. Модуль PSDscResources содержит новые и обновленные ресурсы DSC, которые официально поддерживаются корпорацией Майкрософт. Модуль PSDscResources доступен из коллекции PowerShell.

Дополнительные сведения и обновленную документацию см. в справочной документации по PSDscResources.

Ресурс выполняется успешно, если ресурс, указанный свойством ResourceName, находится в требуемом состоянии на минимальном числе узлов (определяется свойством NodeCount), заданных свойством NodeName.

Примечание

Ресурс WaitForSome использует удаленное управление Windows, чтобы проверить состояние других узлов. Дополнительные сведения о требованиях к безопасности и портах для WinRM см. в разделе Вопросы обеспечения безопасности удаленного взаимодействия PowerShell.

Синтаксис

WaitForSome [String] #ResourceName
{
    NodeCount = [UInt32]
    NodeName = [string[]]
    ResourceName = [string]
    [ RetryCount = [UInt32] ]
    [ RetryIntervalSec = [UInt64] ]
    [ ThrottleLimit = [UInt32] ]
    [ DependsOn = [string[]] ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Свойства

Свойство	Описание
NodeCount	Минимальное количество узлов, которые должны быть в требуемом состоянии для успешного выполнения этого ресурса.
NodeName	Целевые узлы ресурса, с которым настраивается отношение зависимости.
ResourceName	Имя ресурса, с которым настраивается отношение зависимости. Если этот ресурс относится к другой конфигурации, то его имя следует отформатировать как [ResourceType]ResourceName::[ConfigurationName]::[ConfigurationName].
RetryIntervalSec	Количество секунд перед повторной попыткой. Минимальное значение — 1.
RetryCount	Максимальное число повторных попыток.
ThrottleLimit	Количество одновременно подключаемых компьютеров. Значение по умолчанию — New-CimSession.

Общие свойства

Свойство	Описание
DependsOn	Указывает, что перед настройкой этого ресурса необходимо запустить настройку другого ресурса. Например, если идентификатор первого запускаемого блока сценария для конфигурации ресурса — ResourceName, а его тип — ResourceType, то синтаксис использования этого свойства таков: DependsOn = "[ResourceType]ResourceName".
PsDscRunAsCredential	Задает учетные данные для выполнения всего ресурса от другого имени.

Примечание

В WMF 5.0 было добавлено общее свойство PsDscRunAsCredential, разрешающее запуск любого ресурса DSC в контексте других учетных данных. Дополнительные сведения см. в разделе Использование учетных данных с ресурсами DSC.

Пример

Пример использования этого ресурса см. в статье Указание межузловых зависимостей.