WaitForSomeNodes.adoc

DSC Resource 'WaitForSomeNodes'

WaitForSomeNodes can be used within a node block in a DSC configuration to specify dependencies on configurations on other nodes.

This resource succeeds if the resource specified by the ResourceName property is in the desired state on a minimum number of nodes (specified by NodeCount) defined by the NodeName property.

Source	https://github.com/dsccommunity/CommonTasks/tree/main/source/DSCResources/WaitForSomeNodes
DSC Resource	PSDesiredStateConfiguration
Documentation	WaitForSome

Table 1. Attributes of category 'WaitForSomeNodes'

Parameter	Attribute	DataType	Description	Allowed Values
Items	Mandatory	Hashtable[]	files and folders on the target node

Table 2. Attributes of category 'WaitForSomeNodes/Items'

Parameter	Attribute	DataType	Description	Allowed Values
NodeName	Required	String[]	The name of the target nodes the resource must be in the desired state.
NodeCount	Required	UInt32	The minimum number of nodes that must be in the desired state for this resource to succeed.
ResourceName	Key	String	The name of the resource that must be in the desired state.
RetryCount		UInt32	The maximum number of times to retry.
RetryIntervalSec		UInt64	The number of seconds before retrying. Minimum is 1.
ThrottleLimit		UInt32	Number of machines to connect simultaneously. Default is New-CimSession default.

Note	WaitForSomeNodes resource uses Windows Remote Management to check the state of other Nodes. For more information about port and security requirements for WinRM, see PowerShell Remoting Security Considerations.

Example

WaitForSomeNodes:
Items:
  - ResourceName: '[Service]StartSQLService'
    NodeName:
    - SQLServer1
    - SQLServer2
    NodeCount: 1
    RetryIntervalSec: 60
    RetryCount: 60
  - ResourceName: '[xADDomain]NewDomain'
    NodeName:
    - DC1
    - DC2
    - DC3
    NodeCount: 2
    RetryIntervalSec: 15
    RetryCount: 30