Set-ClusterResourceDependency
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 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.
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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).
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 ""