Export (0) Print
Expand All
Expand Minimize

Set-ClusterResourceDependency

Windows Server 2012 R2 and Windows 8.1

Updated: October 17, 2013

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Set-ClusterResourceDependency

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

Syntax

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




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

Parameters

-Cluster<String>

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Dependency<String>

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 names should be enclosed in square brackets as [Cluster Disk 2]. To reset the resource dependency, use an empty string "" in this parameter.


Aliases

none

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-InputObject<PSObject>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Resource<String>

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


Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • Microsoft.FailoverClusters.PowerShell.ClusterResource

Outputs

The output type is the type of the objects that the cmdlet emits.

  • None

Examples

Example 1

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


PS C:\> Set-ClusterResourceDependency –Resource cluster1FS12 -Dependency "[IP Address 151.56.48.0]"

Example 2

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


C:\PS>Set-ClusterResourceDependency –Resource cluster1FS12 –Dependency "[IP Address 151.56.48.0] or [New IP Address]"

Example 3

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


C:\PS>Set-ClusterResourceDependency –Resource cluster1FS12 –Dependency ""

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft