Start-ClusterResource

Article
07/03/2012

Start-ClusterResource

Bring a resource online in a failover cluster.

Syntax

Start-ClusterResource [-InputObject <psobject>] [[-Name] <string>] [-Cluster <string>] [-Wait <int>] [<CommonParameters>]

InputObject
Name
Cluster
Wait

Detailed Description

Before the resource is brought online, any resources that it depends are brought online.

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

InputObject

Specifies the cluster resource to online.

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

Name

Specifies the name of the cluster resource to start. This can also be the name of a cluster shared volume.

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

Wait

Specifies the time in seconds to wait for the operation. If this parameter is not specified the operation waits for completion. If "-Wait 0" is specified the call is initiated and the cmdlet returns right away.

Default Value: **

Data Type: int

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

Input Type

Microsoft.FailoverClusters.PowerShell.ClusterResource, Microsoft.FailoverClusters.PowerShell.ClusterSharedVolume

Return Type

Microsoft.FailoverClusters.PowerShell.ClusterResource, Microsoft.FailoverClusters.PowerShell.ClusterSharedVolume

Examples

-------------------------- EXAMPLE 1 --------------------------

Command Prompt: C:\PS>

 
Start-ClusterResource "IP Address 172.24.11.0" 
 
Name                State               Group               ResourceType 
----                -----               -----               ------------ 
IP Address 172.2... Online              cluster1FS12        IP Address

Description

-----------

This command brings the resource called "IP Address 172.24.11.0" online on the local cluster. Before bringing the resource online, it brings online any resources that the resource depends on.

-------------------------- EXAMPLE 2 --------------------------

Command Prompt: C:\PS>

 
Start-ClusterResource "IP Address 172.24.11.0" -Wait 0 
 
Name                State               Group               ResourceType 
----                -----               -----               ------------ 
IP Address 172.2... OnlinePending       cluster1FS12        IP Address

Description

-----------

This command brings the resource called "IP Address 172.24.11.0" online on the local cluster. Before bringing the resource online, it brings online any resources that the resource depends on. The prompt returns as soon as the action has been initiated.

Partager via

Start-ClusterResource