Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Add-ClusterResource

Last Updated: 2/14/2017

SYNOPSIS

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

SYNTAX

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

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.

EXAMPLES

Example 1

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

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.

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
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Group

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

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Specifies the clustered role where the new resource is added.

Type: PSObject
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Specifies the name of the cluster resource to create.

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ResourceType

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

Type: String
Parameter Sets: (All)
Aliases: ResType, Type

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SeparateMonitor

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

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

Microsoft.FailoverClusters.PowerShell.ClusterGroup

OUTPUTS

Microsoft.FailoverClusters.PowerShell.ClusterResource

NOTES

Get-ClusterResource

Move-ClusterResource

Remove-ClusterResource

Resume-ClusterResource

Start-ClusterResource

Stop-ClusterResource

Suspend-ClusterResource

© 2017 Microsoft