Edit

Share via


Set-ClusterResourceDependency

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

Syntax

Default (Default)

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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputObject

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

Parameter properties

Type:PSObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Resource

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterResource

Outputs

None