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