DSC WaitForSome Resource

Applies To: Windows PowerShell 5.x

The WaitForSome Desired State Configuration (DSC) resource can be used within a node block in a DSC configuration to specify dependencies on configurations on other nodes.

Note

This documentation of this DSC resource covers the version that's included with PowerShell prior to version 7.2. The PSDscResources module contains new and updated DSC Resources that are officially supported by Microsoft. The PSDscResources module is available from the PowerShell Gallery.

For more information and updated documentation, see the PSDscResources reference documentation.

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.

Note

WaitForSome 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.

Syntax

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

Properties

Property Description
NodeCount The minimum number of nodes that must be in the desired state for this resource to succeed.
NodeName The target nodes of the resource to depend on.
ResourceName The resource name to depend on. If this resource belongs to a different configuration, format the name as [ResourceType]ResourceName::[ConfigurationName]::[ConfigurationName].
RetryIntervalSec The number of seconds before retrying. Minimum is 1.
RetryCount The maximum number of times to retry.
ThrottleLimit Number of machines to connect simultaneously. Default is New-CimSession default.

Common properties

Property Description
DependsOn Indicates that the configuration of another resource must run before this resource is configured. For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".
PsDscRunAsCredential Sets the credential for running the entire resource as.

Note

The PsDscRunAsCredential common property was added in WMF 5.0 to allow running any DSC resource in the context of other credentials. For more information, see Use Credentials with DSC Resources.

Example

For an example of how to use this resource, see Specifying cross-node dependencies