Set-ClusterResourceDependency
Set-ClusterResourceDependency
Specify the resources that a particular resource depends on within a failover cluster. Existing dependencies will be overwritten by the dependencies that you specify.
Syntax
Set-ClusterResourceDependency [-InputObject <psobject>] [[-Resource] <string>] [[-Dependency] <string>] [-Cluster <string>] [<CommonParameters>]
InputObject
Resource
Dependency
Cluster
Detailed Description
You can use "or" in the expression describing the dependency. An example for using "or": you can set up a dependency 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
Specifies the name of the cluster to run this cmdlet on. If you type "-Cluster ." or omit the parameter, the cmdlet runs on the local cluster.
Default Value: **
Data Type: string
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
named |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
Dependency
Specifies the dependency expression to set for this resource. The format for this is string is "[Resource Name 1] [and|or [Resource Name 2] [...] ]". Resource names should be enclosed in square brackets as [Cluster Disk 2]. Refer to the examples. To reset the resource dependency use an empty string "" in this parameter.
Default Value: **
Data Type: string
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
2 |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
InputObject
Specifies the cluster resource to set the dependency expression for.
Default Value: **
Data Type: psobject
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
true (ByValue) |
pipelineInput |
Position? |
named |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
Resource
Specifies the name of the cluster resource to set the dependency expression for.
Default Value: **
Data Type: string
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
1 |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
Input Type
Microsoft.FailoverClusters.PowerShell.ClusterResource
Return Type
Examples
-------------------------- EXAMPLE 1 --------------------------
Command Prompt: C:\PS>
Set-ClusterResourceDependency cluster1FS12 "[IP Address 151.56.48.0]"
Description
-----------
This command makes the resource called cluster1FS12 dependent on [IP Address 151.56.48.0].
-------------------------- EXAMPLE 2 --------------------------
Command Prompt: C:\PS>
Set-ClusterResourceDependency cluster1FS12 "[IP Address 151.56.48.0] or [New IP Address]"
Description
-----------
This command makes the resource called cluster1FS12 dependent on either [IP Address 151.56.48.0] or [New IP Address].
-------------------------- EXAMPLE 3 --------------------------
Command Prompt: C:\PS>
Set-ClusterResourceDependency cluster1FS12 ""
Description
-----------
This command clears the dependency list for the resource cluster1FS12, so that it no longer depends on any other resources.
See Also
Reference
Add-ClusterResourceDependency
Get-ClusterResourceDependency
Remove-ClusterResourceDependency
Get-ClusterResourceDependencyReport