Export (0) Print
Expand All
Expand Minimize

Add-ClusterResource

Updated: August 15, 2012

Applies To: Windows Server 2012

Add-ClusterResource

Adds a resource to a clustered role, or resource group, in a failover cluster.

Syntax

Parameter Set: InputObject
Add-ClusterResource [-Name] <String> [[-Group] <String> ] [-ResourceType] <String> [-Cluster <String> ] [-InputObject <PSObject> ] [-SeparateMonitor] [ <CommonParameters>]




Detailed Description

The Add-ClusterResource cmdlet adds a resource to a clustered role, or resource group, in a failover cluster. Before adding the resource, obtain the resource type and the name of the group to which to add the resource.

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

-Group<String>

Specifies the name of the clustered role where the new resource is added.


Aliases

none

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-InputObject<PSObject>

Specifies the clustered role where the new resource is added.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of the cluster resource to create.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ResourceType<String>

Specifies the name of the cluster resource type for the new cluster resource.


Aliases

restype, type

Required?

true

Position?

3

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SeparateMonitor

Specifies that the new resource should run in a separate resource monitor.


Aliases

none

Required?

false

Position?

named

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

Outputs

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

  • Microsoft.FailoverClusters.PowerShell.ClusterResource

Examples

EXAMPLE 1

This example creates a new IP Address resource called resource1 on the local cluster. The cmdlet configures the resource as part of the clustered role, or resource group, called ClusterSrv1.


PS C:\> Add-ClusterResource -Name resource1 -ResourceType "IP Address" -Group ClusterSrv1
Name                State               Group               ResourceType 
----                -----               -----               ------------        
resource1           Offline             ClusterSrv1         IP Address 

Related topics

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