NAME

Set-DcsPoolMemberThreshold

SYNOPSIS

Sets the I/O Latency Thresholds for a pool Member.

SYNTAX

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

DESCRIPTION

Sets the I/O Latency Thresholds for a pool Member (physical disks and DataCore Disks added to pools). Thresholds can be set for attention, warning, and critical levels which will generate the appropriate level messages in System Health.

PARAMETERS

-PoolMember<Object>
PoolMemberData object, ID, or caption (name) that identifies the pool Member. PoolMemberData objects can be retrieved with the cmdlet Get-DcsPoolMember.

Required: true
Position: named
Default value:
Accept pipeline input: true (ByValue)
Accept wildcard characters: false

-Pool<String>
Name or ID that identifies the disk pool. To resolve by name, the name must be unique to the server group or the server must be specified.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-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

-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.

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.

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.

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

INPUTS

PoolMemberData : Object the identifies and describes the pool Member.

OUTPUTS

ThresholdMonitorTemplateData : Object the identifies and describes the thresholds for the pool Member.

NOTES

Also see related cmdlets: Set-DcsPoolMemberProperties, Get-DcsPoolMember.

EXAMPLES


-------------- Example 1 Sets new thresholds for a single pool Member --------------
Get-DcsPoolMember -Pool "Disk pool 1" -Disk "SSVVM01-WDC100-D1" | Set-DcsPoolMemberThreshold -LatencyAttention 10000 -LatencyWarning 20000 -LatencyCritical 40000
		

The cmdlet Get-DcsPoolMember is invoked to retrieve the PoolMemberData object for the disk named "SSVVM01-WDC100-D1" in the pool "Disk pool 1". The object is piped to the cmdlet Set-DcsPoolMemberThreshold to set the Latency Attention threshold to 10,000 milliseconds, the Latency Warning threshold to 20,000 milliseconds, and the Latency Critical threshold to 40,000 milliseconds. The ThresholdMonitorTemplateData object is returned.

AttentionLevel:10000
WarningLevel:20000
CriticalLevel:40000
CounterName:MaxReadWriteTime
Alias:I/O latency
Description:Monitors the physical disks latency.
MonitorType:DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]
MonitoredObjectType:DataCore.Executive.Controller.PhysicalDisk
MonitoredObjectId:{4bd69b5c-3b15-4c7d-a474-191b204d707f}
TypeId:T(DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]<DataCore.Executive.Controller.Phy
Sequencenumber:2853
Id:T(DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]<{4bd69b5c-3b15-4c7d-a474-191b204d
Caption:I/O latency
ExtendedCaption:I/O latency of {4bd69b5c-3b15-4c7d-a474-191b204d707f}
Internal:False
   

-------------- Example 2 Sets thresholds for all pool Members in a specific pool --------------
Get-DcsPoolMember -Pool "Disk pool 1" | ForEach {Set-DcsPoolMemberThreshold -PoolMember $_.Id -LatencyAttention 3000 -LatencyWarning 5000 -LatencyCritical 8000}
		

The cmdlet Get-DcsPoolMember is invoked to retrieve all PoolMemberData objects for the pool named "Disk pool 1". The ForEach loop is used to pipe each object to the cmdlet Set-DcsPoolMemberThreshold to set the Latency Attention threshold to 3,000 milliseconds, the Latency Warning threshold to 5,000 milliseconds, and the Latency Critical threshold to 8,000 milliseconds. The ThresholdMonitorTemplateData objects are returned.

AttentionLevel:3000
WarningLevel:5000
CriticalLevel:8000
CounterName:MaxReadWriteTime
Alias:I/O latency
Description:Monitors the physical disks latency.
MonitorType:DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]
MonitoredObjectType:DataCore.Executive.Controller.PhysicalDisk
MonitoredObjectId:{4bd69b5c-3b15-4c7d-a474-191b204d707f}
TypeId:T(DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]<DataCore.Executive.Controller.Phy
Sequencenumber:2916
Id:T(DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]<{4bd69b5c-3b15-4c7d-a474-191b204d
Caption:I/O latency
ExtendedCaption:I/O latency of {4bd69b5c-3b15-4c7d-a474-191b204d707f}
Internal:False
   
AttentionLevel:3000
WarningLevel:5000
CriticalLevel:8000
CounterName:MaxReadWriteTime
Alias:I/O latency
Description:Monitors the physical disks latency.
MonitorType:DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]
MonitoredObjectType:DataCore.Executive.Controller.PhysicalDisk
MonitoredObjectId:{758b64d4-64e0-4e97-a763-6adfefa95dc6}
TypeId:T(DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]<DataCore.Executive.Controller.Phy
Sequencenumber:2919
Id:T(DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]<{758b64d4-64e0-4e97-a763-6adfefa9
Caption:I/O latency
ExtendedCaption:I/O latency of {758b64d4-64e0-4e97-a763-6adfefa95dc6}
Internal:False
   
AttentionLevel:3000
WarningLevel:5000
CriticalLevel:8000
CounterName:MaxReadWriteTime
Alias:I/O latency
Description:Monitors the physical disks latency.
MonitorType:DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]
MonitoredObjectType:DataCore.Executive.Controller.PhysicalDisk
MonitoredObjectId:{5ce592f3-e676-4d24-94ad-7320f021e04b}
TypeId:T(DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]<DataCore.Executive.Controller.Phy
Sequencenumber:2922
Id:T(DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]<{5ce592f3-e676-4d24-94ad-7320f021
Caption:I/O latency
ExtendedCaption:I/O latency of {5ce592f3-e676-4d24-94ad-7320f021e04b}
Internal:False