< Back
New-AMPerformanceCondition
Post
NAME New-AMPerformanceCondition
SYNOPSIS
Creates a new AutoMate Enterprise performance condition.
SYNTAX
New-AMPerformanceCondition [-Name] <String> [-MachineName <String>] -CategoryName <String> -CounterName <String>
-InstanceName <String> [-Operator {Below | Above}] [-Amount <Int32>] [-TimePeriod <Int32>] [-TimePeriodUnit
{Seconds | Minutes | Hours | Days | Milliseconds}] [-Wait] [-Timeout <Int32>] [-TimeoutUnit {Seconds | Minutes |
Hours | Days | Milliseconds}] [-TriggerAfter <Int32>] [-Notes <String>] [-Folder <Object>] [-Connection <Object>]
[-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
New-AMPerformanceCondition creates a new performance condition.
PARAMETERS
-Name <String>
The name of the new object.
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-MachineName <String>
The computer to check performance counters on.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-CategoryName <String>
The system category in which to monitor (i.e. Processor, Memory, Paging File, etc.). A category catalogues
performance counters in a logical unit.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-CounterName <String>
The type of counter related to the category in which to monitor. Performance counters are combined together
under categories. They are used to measure various aspects of performance, such as transfer rates for disks
or, for processors, the amount of processor time consumed. Specific counters are populated in this section
depending on the performance category selected.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-InstanceName <String>
The instance related to the category in which to monitor. A performance counter can be divided into instances,
such as processes, threads, or physical units.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Operator
Above or Below.
Required? false
Position? named
Default value Below
Accept pipeline input? false
Accept wildcard characters? false
-Amount <Int32>
The threshold to trigger on.
Required? false
Position? named
Default value 10
Accept pipeline input? false
Accept wildcard characters? false
-TimePeriod <Int32>
The amount of time to wait before triggering.
Required? false
Position? named
Default value 3
Accept pipeline input? false
Accept wildcard characters? false
-TimePeriodUnit
The unit of time for TriggerWhenTimePeriod.
Required? false
Position? named
Default value Milliseconds
Accept pipeline input? false
Accept wildcard characters? false
-Wait [<SwitchParameter>]
Wait for the condition, or evaluate immediately.
Required? false
Position? named
Default value True
Accept pipeline input? false
Accept wildcard characters? false
-Timeout <Int32>
If wait is specified, the amount of time before the condition times out.
Required? false
Position? named
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-TimeoutUnit
The unit for Timeout (Seconds by default).
Required? false
Position? named
Default value Seconds
Accept pipeline input? false
Accept wildcard characters? false
-TriggerAfter <Int32>
The number of times the condition should occur before the trigger fires.
Required? false
Position? named
Default value 1
Accept pipeline input? false
Accept wildcard characters? false
-Notes <String>
The new notes to set on the object.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Folder <Object>
The folder to place the object in.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Connection <Object>
The server to create the object on.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
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 (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
RELATED LINKS
https://github.com/AutomatePS/AutomatePS
SYNOPSIS
Creates a new AutoMate Enterprise performance condition.
SYNTAX
New-AMPerformanceCondition [-Name] <String> [-MachineName <String>] -CategoryName <String> -CounterName <String>
-InstanceName <String> [-Operator {Below | Above}] [-Amount <Int32>] [-TimePeriod <Int32>] [-TimePeriodUnit
{Seconds | Minutes | Hours | Days | Milliseconds}] [-Wait] [-Timeout <Int32>] [-TimeoutUnit {Seconds | Minutes |
Hours | Days | Milliseconds}] [-TriggerAfter <Int32>] [-Notes <String>] [-Folder <Object>] [-Connection <Object>]
[-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
New-AMPerformanceCondition creates a new performance condition.
PARAMETERS
-Name <String>
The name of the new object.
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-MachineName <String>
The computer to check performance counters on.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-CategoryName <String>
The system category in which to monitor (i.e. Processor, Memory, Paging File, etc.). A category catalogues
performance counters in a logical unit.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-CounterName <String>
The type of counter related to the category in which to monitor. Performance counters are combined together
under categories. They are used to measure various aspects of performance, such as transfer rates for disks
or, for processors, the amount of processor time consumed. Specific counters are populated in this section
depending on the performance category selected.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-InstanceName <String>
The instance related to the category in which to monitor. A performance counter can be divided into instances,
such as processes, threads, or physical units.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Operator
Above or Below.
Required? false
Position? named
Default value Below
Accept pipeline input? false
Accept wildcard characters? false
-Amount <Int32>
The threshold to trigger on.
Required? false
Position? named
Default value 10
Accept pipeline input? false
Accept wildcard characters? false
-TimePeriod <Int32>
The amount of time to wait before triggering.
Required? false
Position? named
Default value 3
Accept pipeline input? false
Accept wildcard characters? false
-TimePeriodUnit
The unit of time for TriggerWhenTimePeriod.
Required? false
Position? named
Default value Milliseconds
Accept pipeline input? false
Accept wildcard characters? false
-Wait [<SwitchParameter>]
Wait for the condition, or evaluate immediately.
Required? false
Position? named
Default value True
Accept pipeline input? false
Accept wildcard characters? false
-Timeout <Int32>
If wait is specified, the amount of time before the condition times out.
Required? false
Position? named
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-TimeoutUnit
The unit for Timeout (Seconds by default).
Required? false
Position? named
Default value Seconds
Accept pipeline input? false
Accept wildcard characters? false
-TriggerAfter <Int32>
The number of times the condition should occur before the trigger fires.
Required? false
Position? named
Default value 1
Accept pipeline input? false
Accept wildcard characters? false
-Notes <String>
The new notes to set on the object.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Folder <Object>
The folder to place the object in.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Connection <Object>
The server to create the object on.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
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 (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
RELATED LINKS
https://github.com/AutomatePS/AutomatePS