Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Add-ClusterResource

Add-ClusterResource

microsoft.failoverclusters.powershell.dll

Synopsis

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

Syntax

Add-ClusterResource [-Name] [-Group] [-ResourceType] [-Cluster] [-InputObject] [-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

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

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

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

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

Accept pipeline input?

false

Accept wildcard characters?

false

-SeparateMonitor <SwitchParameter>

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

Aliases

None

Required?

false

Position

named

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type

Microsoft.FailoverClusters.PowerShell.ClusterGroup

Return Type

Microsoft.FailoverClusters.PowerShell.ClusterResource

Notes

None

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 

Online Version
Get-ClusterResource
Move-ClusterResource
Remove-ClusterResource
Resume-ClusterResource
Start-ClusterResource
Stop-ClusterResource
Suspend-ClusterResource