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