Set-Cluster Parameter

Controls specific properties of an object in a failover cluster, such as a resource, a group, or a network.

Syntax

Set-ClusterParameter
   [-InputObject <PSObject>]
   [-Create]
   [-Delete]
   [-Cluster <String>]
   [<CommonParameters>]
Set-ClusterParameter
   [-InputObject <PSObject>]
   [[-Name] <String>]
   [[-Value] <PSObject>]
   [-Create]
   [-Delete]
   [-Cluster <String>]
   [<CommonParameters>]
Set-ClusterParameter
   [-InputObject <PSObject>]
   [[-Multiple] <Hashtable>]
   [-Create]
   [-Delete]
   [-Cluster <String>]
   [<CommonParameters>]

Description

The Set-ClusterParameter cmdlet controls specific properties of an object in a failover cluster, such as a resource, a group, or a network.

-- For a disk resource, you can set the disk signature or GUID of a disk, and turn maintenance on or off for that disk.

-- For a Network Name resource, you can set DNS-related information about the resource.

-- For an IP address resource, you can set DHCP-related information about the IP Address resource.

-- For resources used by virtual machines, you can set details about the settings for the virtual machines.

Examples

Example 1

PS C:\> Get-ClusterResource -Name cluster1FS | Set-ClusterParameter -Name HostRecordTTL -Value 300

This example configures the clustered resource called cluster1FS on the local cluster, by setting the value of HostRecordTTL to 300.

Example 2

PS C:\> Get-ClusterResource -Name "Cluster IP Address" | Set-ClusterParameter -Multiple @{"Address"="172.24.22.168";"Network"="Cluster Network 2";"EnableDhcp"=1}

This example uses the Multiple parameter to configure the clustered resource called Cluster IP Address, by setting the Address , Network , and EnableDhcp parameters simultaneously.

Example 3

PS C:\> $res = Get-ClusterResource -Name "IP Address"



PS C:\> $param1 = New-Object -ComObject Microsoft.FailoverClusters.PowerShell.ClusterParameter -Property $res,Address,10.55.88.46



PS C:\> $param2 = New-Object -ComObject Microsoft.FailoverClusters.PowerShell.ClusterParameter -Property $res,SubnetMask,255.0.0.0



PS C:\> $params = $param1,$param2



PS C:\> $params | Set-ClusterParameter

This example configures the clustered resource called IP Address to use a new static IP. Because the new address and subnet mask are required, both parameters must be passed to this cmdlet together.

Optional Parameters

-Cluster
Type: String
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Create
Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Delete
Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Type: PSObject
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Multiple
Type: Hashtable
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Type: String
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Value
Type: PSObject
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Inputs

Microsoft.FailoverClusters.PowerShell.Cluster

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterGroup

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterNetwork

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterNetworkInterface

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterNode

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterParameter

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterResource

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterResourceType

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterSharedVolume