NAME

Set-DcsServerPortThreshold

SYNOPSIS

Sets the Busy Count per Second Thresholds for a Fibre Channel server port.

SYNTAX

Set-DcsServerPortThreshold   [ -Server <String> ]   -Port <Object>   [ -BusyCountAttention <UInt64> ]   [ -BusyCountWarning <UInt64> ]   [ -BusyCountCritical <UInt64> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Sets the Busy Count per Second Thresholds for a Fibre Channel server port. 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

-Port<Object>
ScsiPortData object, name, or ID that identifies the port. To uniquely identify the port by name, the server must be specified. The ScsiPortData object can be obtained from the cmdlet Get-DcsPort.

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

-BusyCountAttention<UInt64>
This parameter will cause an attention message to be generated when the busy port count for a port reaches the attention threshold that is set. The value is the number of times per second that the port sends busy due to a queue full condition. The default value is "1" per second. Valid values are "0" - "10000". In the default case, when the port busy count reaches 1 per second, an attention message will be generated.

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

-BusyCountWarning<UInt64>
This parameter will cause a warning message to be generated when the busy port count for a port reaches the warning threshold that is set. The value is the number of times per second that the port sends busy due to a queue full condition. The default value is "1000" per second. Valid values are "0" - "10000". In the default case, when the port busy count reaches 1000 per second, a warning message will be generated.

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

-BusyCountCritical<UInt64>
This parameter will cause a critical message to be generated when the busy port count for a port reaches the critical threshold that is set. The value is the number of times per second that the port sends busy due to a queue full condition. The default value is "2000" per second. Valid values are "0" - "10000". In the default case, when the port busy count reaches 2000 per second, a critical message will be generated.

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

ScsiPortData : Object that identifies the port.

OUTPUTS

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

NOTES

Also see Set-DcsPortProperties, Get-DcsPort,

EXAMPLES


-------------- Example 1 Sets all thresholds for a port by name --------------
Set-DcsServerPortThreshold -Server "Server2" -Port "Server FC Port 3" -BusyCountAttention 500 -BusyCountWarning 1000 -BusyCountCritical 2000
		

The cmdlet is invoked to set the thresholds for the port named "Server FC Port 3" on the server named "Server2". The attention threshold is set to "500" per second, the warning threshold is set to "1000" per second, and the critical threshold is set to "2000" per second.

AttentionLevel:500
WarningLevel:1000
CriticalLevel:2000
CounterName:BusyCount
Alias:Busy count / sec
Description:Monitors the number of busy per second on the port
MonitorType:DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]
MonitoredObjectType:DataCore.Executive.Controller.ServerScsiPort
MonitoredObjectId:b549dc1d-7d26-4ffd-b1b4-6a71427f1fb7
TypeId:T(DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]<DataCore.Executive.Controller.Ser
Sequencenumber:796
Id:T(DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]<b549dc1d-7d26-4ffd-b1b4-6a71427f1
Caption:Busy count / sec
ExtendedCaption:Busy count / sec of b549dc1d-7d26-4ffd-b1b4-6a71427f1fb7
Internal:False
   

-------------- Example 2 Sets the critical threshold for all Fibre Channel ports on a specific server --------------
Get-DcsPort -Type FibreChannel -Machine "Server2" | ForEach  { Set-DcsServerPortThreshold -Port $_.Id -BusyCountCritical 1500 }
		

The Get-DcsPort cmdlet is invoked to get the ScsiPortData objects for all Fibre Channel ports on the machine named "Server1". The objects are piped to the cmdlet Set-DcsServerPortThreshold and the critical level threshold is set to "1500" per second.

AttentionLevel:500
WarningLevel:1000
CriticalLevel:1500
CounterName:BusyCount
Alias:Busy count / sec
Description:Monitors the number of busy per second on the port
MonitorType:DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]
MonitoredObjectType:DataCore.Executive.Controller.ServerScsiPort
MonitoredObjectId:b549dc1d-7d26-4ffd-b1b4-6a71427f1fb7
TypeId:T(DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]<DataCore.Executive.Controller.Ser
Sequencenumber:800
Id:T(DataCore.Executive.Controller.RisingThresholdPerfMonitor`1[T]<b549dc1d-7d26-4ffd-b1b4-6a71427f1
Caption:Busy count / sec
ExtendedCaption:Busy count / sec of b549dc1d-7d26-4ffd-b1b4-6a71427f1fb7
Internal:False