NAME

Set-DcsPoolThreshold

SYNOPSIS

Sets the Available Space Thresholds, I/O Latency Thresholds, and Pool Depletion Thresholds for a disk pool.

SYNTAX

Set-DcsPoolThreshold   [ -Server <String> ]   -Pool <Object>   [ -AvailableSpaceAttention <UInt64> ]   [ -AvailableSpaceWarning <UInt64> ]   [ -AvailableSpaceCritical <UInt64> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

Set-DcsPoolThreshold   [ -Server <String> ]   -Pool <Object>   [ -LatencyAttention <UInt64> ]   [ -LatencyWarning <UInt64> ]   [ -LatencyCritical <UInt64> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

Set-DcsPoolThreshold   [ -Server <String> ]   -Pool <Object>   [ -PoolDepletionAttention <UInt64> ]   [ -PoolDepletionWarning <UInt64> ]   [ -PoolDepletionCritical <UInt64> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

DESCRIPTION

Sets the Available Space Thresholds, I/O Latency Thresholds, and Pool Depletion Thresholds for a disk pool. Thresholds can be set for attention, warning, and critical levels which will generate the appropriate level messages in System Health.

PARAMETERS

-Server<String>

Computer name or ID of the server. The computer name must be unique or the name must be fully qualified.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Pool<Object>

DiskPoolData or SharedDiskPoolData object, name, or ID that identifies the disk pool or shared disk pool. To resolve by name, the name must be unique to the server group or the server must be specified. The objects can be obtained from Get-DcsPool or Get-DcsSharedPool.

Required: true

Position: named

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

-AvailableSpaceAttention<UInt64>

The available space threshold that will generate an attention message. The value is a percentage of the total disk pool space. For instance, if the value is 40, when the available space is at 40% of the total disk pool space, an attention message will be posted to the System Health tool and Event Log.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-AvailableSpaceWarning<UInt64>

The available space threshold that will generate a warning message. The value is a percentage of the total disk pool space. For instance, if the value is 30, when the available space is at 30% of the total disk pool space, a warning message will be posted to the System Health tool and Event Log.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-AvailableSpaceCritical<UInt64>

The available space threshold that will generate a critical message. The value is a percentage of the total disk pool space. For instance, if the value is 20, when the available space is at 20% of the total disk pool space, a critical message will be posted to the System Health tool and Event Log.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Connection<String>

Alias of the connection to the server group. If not specified, the default connection is used.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-PipelineVariable<String>

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-LatencyAttention<UInt64>

The I/O latency threshold that will generate an attention message. The value is in milliseconds. Valid values are 0 to 60,000. The default value is 5,000 ms. For instance, when the I/O latency reaches 5,000 milliseconds, an attention message will be posted to the System Health tool and Event Log.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-LatencyWarning<UInt64>

The I/O latency threshold that will generate a warning message. The value is in milliseconds. Valid values are 0 to 60,000. The default value is 10,000 ms. For instance, when the I/O latency reaches 10,000 milliseconds, a warning message will be posted to the System Health tool and Event Log.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-LatencyCritical<UInt64>

The I/O latency threshold that will generate a critical message. The value is in milliseconds. Valid values are 0 to 60,000. The default value is 30,000 ms. For instance, when the I/O latency reaches 30,000 milliseconds, a critical message will be posted to the System Health tool and Event Log.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-PoolDepletionAttention<UInt64>

The pool depletion threshold that will generate an attention message. The threshold value is the number of days. Valid values range from 0 to 30. The value 0 disables the setting. The default value is 30 days. For example, when pool depletion is projected to be in 30 days, an attention message will be posted to the System Health tool and Event Log. The monitor stores the value in milliseconds.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-PoolDepletionWarning<UInt64>

The pool depletion threshold that will generate a warning message. The threshold value is the number of days. Valid values range from 0 to 30. The default value is 0 days which disables the setting. For example, if the value is 7, when pool depletion is projected to be in 7 days, a warning message will be posted to the System Health tool and Event Log. The monitor stores the value in milliseconds.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-PoolDepletionCritical<UInt64>

The pool depletion threshold that will generate a critical message. The threshold value is the number of days. Valid values range from 0 to 30. The default value is 0 days which disables the setting. For example, if the value is 2, when pool depletion is projected to be in 2 days, a critical message will be posted to the System Health tool and Event Log. The monitor stores the value in milliseconds.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

DiskPoolData or SharedDiskPoolData : Object that identifies the pool.

OUTPUTS

ThresholdMonitorTemplateData : Object that identifies and describes the threshold.

NOTES

Also see Get-DcsPool, Get-DcsSharedPool.

EXAMPLES

Set-DcsPoolThreshold -Server SSVVM1 -Pool "Disk pool 1" -AvailableSpaceAttention 40
		

Get-DcsPool | foreach {Set-DcsPoolThreshold -Pool $_ -LatencyCritical 25000}
		

Get-DcsSharedPool -SharedPool "Shared pool 1" | Set-DcsPoolThreshold -PoolDepletionAttention 15