WaitForAnyNode.adoc

DSC Resource 'WaitForAnyNode'

WaitForAnyNode waits for any one of the specified nodes to reach a desired DSC configuration state before proceeding.

When to use 'WaitForAnyNode'

Use this resource when your DSC configuration needs at least one of several nodes to complete its configuration before proceeding. For example, wait for any one domain controller to be available before joining a machine to the domain. This resource blocks until at least one specified node reports the desired state.

This resource succeeds if the resource specified by the ResourceName property is in the desired state on any target nodes defined in the NodeName property.

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

Table 1. Attributes of category 'WaitForAnyNode'

Parameter	Attribute	DataType	Description	Allowed Values
Items		Hashtable[]	List of cross-node dependency configurations specifying nodes and resources to wait for

Table 2. Attributes of category 'WaitForAnyNode/Items'

Parameter	Attribute	DataType	Description	Allowed Values
NodeName	Required	String[]	The name of the target nodes the resource must be in the desired state.
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	WaitForAnyNode 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

WaitForAnyNode:
  Items:
  - ResourceName: '[xADDomain]NewDomain'
    NodeName: MyDC
    RetryIntervalSec: 15
    RetryCount: 30
  - ResourceName: '[Service]StartSQLService'
    NodeName:
    - SQLServer1
    - SQLServer2
    RetryIntervalSec: 60
    RetryCount: 60

See also

• WaitForAllNodes

• WaitForSomeNodes