Set-ClusterResourceDependency

Specifies the resources that a particular resource depends on within a failover cluster.

Syntax

Set-ClusterResourceDependency
   [[-Resource] <String>]
   [[-Dependency] <String>]
   [-InputObject <PSObject>]
   [-Cluster <String>]
   [<CommonParameters>]

Description

The Set-ClusterResourceDependency cmdlet specifies the resources that a particular resource depends on within a failover cluster. Existing dependencies will be overwritten by the dependencies that you specify.

The term or can be used in the expression describing the dependency. For example, an or dependency can be set up where a Network Name resource is dependent on either of two IP address resources, instead of being dependent on both. This use of or dependencies is common in multi-site cluster deployments.

Examples

Example 1

Set-ClusterResourceDependency -Resource cluster1FS12 -Dependency "[IP Address 151.56.48.0]"

This example makes the resource called cluster1FS12 dependent on [IP Address 151.56.48.0].

Example 2

$parameters = @{
    Resource = 'cluster1FS12'
    Dependency = '[IP Address 151.56.48.0] or [New IP Address]'
}
Set-ClusterResourceDependency @parameters

This example makes the resource called cluster1FS12 dependent on either [IP Address 151.56.48.0] or [New IP Address].

This example uses splatting to pass parameter values from the $Parameters variable to the command. Learn more about Splatting.

Example 3

Set-ClusterResourceDependency -Resource cluster1FS12 -Dependency ""

This example clears the dependency list for the resource named cluster1FS12, so that it no longer depends on any other resources.

Parameters

-Cluster

Specifies the name of the cluster on which to run this cmdlet. If the input for this parameter is . or it is omitted, then the cmdlet runs on the local cluster.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Dependency

Specifies the dependency expression to set for this resource. The format for this is string is as follows. "[Resource Name 1] [and|or [Resource Name 2] [...] ]"Resource Name 1Resource Name 2

Resource names should be enclosed in square brackets as [Cluster Disk 2]Cluster Disk 2. To reset the resource dependency, use an empty string "" in this parameter.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifies the cluster resource for which to set the dependency expression.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Resource

Specifies the name of the cluster resource for which to set the dependency expression.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterResource

Outputs

None