Skip to content

Latest commit

 

History

History
130 lines (104 loc) · 3.27 KB

WaitForSomeNodes.adoc

File metadata and controls

130 lines (104 loc) · 3.27 KB

DSC Resource 'WaitForSomeNodes'

WaitForSomeNodes waits for a specified number of nodes to reach a desired DSC configuration state before proceeding.

When to use 'WaitForSomeNodes'

Use this resource when your DSC configuration requires a minimum number (but not necessarily all) of other nodes to complete their configuration first. For example, wait for at least 2 out of 3 cluster nodes to be configured before proceeding with cluster formation. This provides a middle ground between WaitForAllNodes and WaitForAnyNode.

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

DSC Resource

Documentation
Table 1. Attributes of category 'WaitForSomeNodes'
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 '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