NAME

Set-DcsVirtualDiskThreshold

SYNOPSIS

Sets System Health thresholds for virtual disks. Thresholds can be set for Allocated Space, I/O Latency, Storage Latency, and History Log Size and Retention Period for data protected (CDP-enabled) virtual disks.

SYNTAX

Set-DcsVirtualDiskThreshold   -VirtualDisk <Object>   [ -AllocatedSpaceAttention <UInt64> ]   [ -AllocatedSpaceWarning <UInt64> ]   [ -AllocatedSpaceCritical <UInt64> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

Set-DcsVirtualDiskThreshold   -VirtualDisk <Object>   [ -LatencyAttention <UInt64> ]   [ -LatencyWarning <UInt64> ]   [ -LatencyCritical <UInt64> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

Set-DcsVirtualDiskThreshold   -VirtualDisk <Object>   [ -StorageLatencyAttention <UInt64> ]   [ -StorageLatencyWarning <UInt64> ]   [ -StorageLatencyCritical <UInt64> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

Set-DcsVirtualDiskThreshold   -VirtualDisk <Object>   [ -RetentionPeriodWarning <UInt64> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

Set-DcsVirtualDiskThreshold   -VirtualDisk <Object>   [ -HistoryLogSizeAttention <UInt64> ]   [ -HistoryLogSizeWarning <UInt64> ]   [ -HistoryLogSizeCritical <UInt64> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

DESCRIPTION

Sets System Health thresholds for virtual disks. Thresholds can be set for Allocated Space, I/O Latency, Storage Latency, and History Log Size and Retention Period for data protected (CDP-enabled) virtual disks. The I/O Latency Threshold is for the front-end paths to the virtual disk. Storage Latency Threshold monitors the back-end paths. Thresholds can be set for attention, warning, and critical levels which will generate the appropriate level messages in System Health.

PARAMETERS

-VirtualDisk<Object>

VirtualDiskData object, name, or ID that identifies the virtual disk.

Required: true

Position: named

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

-AllocatedSpaceAttention<UInt64>

This parameter has been deprecated and will always be empty. This parameter is left in the interface for backwards compatibility. It cannot be changed.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-AllocatedSpaceWarning<UInt64>

This parameter has been deprecated and will always be empty. This parameter is left in the interface for backwards compatibility. It cannot be changed.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-AllocatedSpaceCritical<UInt64>

This parameter has been deprecated and will always be empty. This parameter is left in the interface for backwards compatibility. It cannot be changed.

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>

This parameter sets the attention level of the I/O Latency Threshold. The value is the the amount of milliseconds (ms). Valid values are "0" through "60000". The default value is "30". In this case, when the latency for a front-end path to the virtual disk reaches 30 ms, an attention message will be generated.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-LatencyWarning<UInt64>

This parameter sets the warning level of the I/O Latency Threshold. The value is the the amount of milliseconds (ms). Valid values are "0" to "60000". The default value is "60". In this case, when the latency for a front-end path to the virtual disk reaches 60 ms, a warning message will be generated.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-LatencyCritical<UInt64>

This parameter sets the critical level of the I/O Latency Threshold. The value is the the amount of milliseconds (ms). Valid values are "0" to "60000". The default value is "120". In this case, when the latency for a front-end path to the virtual disk reaches 120 ms, a critical message will be generated.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-StorageLatencyAttention<UInt64>

This parameter sets the attention level of the Storage Latency Threshold. The value is the the amount of milliseconds (ms). Valid values are "0" through "60000". The default value is "120". In this case, when the latency for a back-end path to the disk reaches 120 ms, an attention message will be generated.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-StorageLatencyWarning<UInt64>

This parameter sets the warning level of the Storage Latency Threshold. The value is the the amount of milliseconds (ms). Valid values are "0" to "60000". The default value is "240". In this case, when the latency for a back-end path to the virtual disk reaches 240 ms, a warning message will be generated.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-StorageLatencyCritical<UInt64>

This parameter sets the critical level of the I/O Latency Threshold. The value is the the amount of milliseconds (ms). Valid values are "0" to "60000". The default value is "480". In this case, when the latency for a back-end path to the virtual disk reaches 480 ms, a critical message will be generated.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-RetentionPeriodWarning<UInt64>

This parameter allows a threshold to be set that will issue a System Health warning if the number of hours left in the history log drops below the threshold that is set. Enter the value in number of hours. (The value will be reflected in milliseconds in the returned object in both AttentionLevel and Warning Level fields. Note: Only a warning will be issued.) Valid values are 0-1000. The default setting is 0, which means that the threshold is disabled and will not produce a warning.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-HistoryLogSizeAttention<UInt64>

This parameter sets the attention level of the history log size threshold for a data protected virtual disk. The value is the percentage of the maximum history log size set for the virtual disk. Valid values are 100 - 10000. The default value is 100 percent. In this case, when the current history log size reaches 100% of the maximum history log size setting an attention message will be generated.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-HistoryLogSizeWarning<UInt64>

This parameter sets the warning level of the history log size threshold for a data protected virtual disk. The value is the percentage of the maximum history log size set for the virtual disk. Valid values are 100 - 10000. The default value is 100 percent. In this case, when the current history log size reaches 100% of the maximum history log size setting a warning message will be generated.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-HistoryLogSizeCritical<UInt64>

This parameter sets the critical level of the history log size threshold for a data protected virtual disk. The value is the percentage of the maximum history log size set for the virtual disk. Valid values are 100 - 10000. The default value is 0 percent, which will not be reached and therefore not produce a critical alert. For instance, if the setting is 300, when the current history log size reaches 300% of the maximum history log size setting a critical message will be generated.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

<Common Parameters>

This 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

VirtualDiskData : Object that identifies the virtual disk.

OUTPUTS

ThresholdMonitorTemplateData : A type of MonitorTemplateData object which identifies and describes the threshold monitor.

NOTES

Note: The behavior of history log size thresholds are different in the console. In the console, there is one setting and it sets a threshold for a System Health warning. To obtain the same behavior in the cmdlets, set the Attention and Warning levels to the same value and ensure the Critical level is set to 0. Also see Get-DcsVirtualDisk, Set-DcsVirtualDiskProperties.

EXAMPLES

Set-DcsVirtualDiskThreshold -VirtualDisk "Virtual disk 1" -AllocatedSpaceAttention 95 -AllocatedSpaceWarning 100 -AllocatedSpaceCritical 101
		

$CriticalVDs = Get-DcsVirtualDisk | where{$_.StorageProfileId -eq 'E84B65FF-B69A-4EF1-B79E-71D3DC29E867'}
$CriticalVDs | Set-DcsVirtualDiskThreshold -LatencyWarning 15000 -LatencyCritical 20000
		

Set-DcsVirtualDiskThreshold -VirtualDisk "Virtual disk 7" -HistoryLogSizeAttention 100 -HistoryLogSizeWarning 120 -HistoryLogSizeCritical 150
		

$VDs = Get-DcsVirtualDisk -OnlyWithReplications
$VDs | ForEach { Set-DcsVirtualDiskThreshold -VirtualDisk $_.Id -StorageLatencyWarning 15000 -StorageLatencyCritical 20000