Add-ClusterResource

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: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. 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: Create a resource on the local cluster

This example creates an 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"

Related topics

Community Additions

ADD
Show: