Syntax
New-AlarmAction [[-AlarmDefinition] <AlarmDefinition>] [-AlarmActionTrigger <AlarmActionTrigger>] [-Body <String>] [-Cc <String[]>] -Email [-Server <VIServer[]>] [-Subject <String>] -To <String[]> [-Confirm] [-WhatIf] [<CommonParameters>]Related Commands
Online VersionDetailed Description
This cmdlet creates an alarm action or attaches an alarm action to the specified alarm.Parameters
| Name | Type | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|---|
| AlarmDefinition | AlarmDefinition | Specifies the alarm definition for which you want to configure actions. | false | True (ByValue) | |
| AlarmActionTrigger | AlarmActionTrigger | Specifies the alarm action trigger. If it is not specified, a default action trigger is created with a Yellow start value and a Red end value. | false | False | |
| Body | String | Specifies the text of the email message. | false | False | |
| Cc | String[] | Specifies the email addresses you want to add to the CC field of the email message. | false | False | |
| Confirm | SwitchParameter | If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation. | false | False | |
| SwitchParameter | Indicates that when the alarm is activated, the system sends an email message to the specified address. Use the Subject, To, CC, and Body parameters to customize the alarm message. | true | False | ||
| Script | SwitchParameter | Indicates that a script is run when the alarm is activated. | true | False | |
| ScriptPath | String | Specifies the path to a batch file, located on a vCenter Server system, that will run when the alarm is activated. | true | False | |
| Server | VIServer[] | Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-VIServer cmdlet. | false | False | |
| Snmp | SwitchParameter | Indicates that a SNMP message is sent when the alarm is activated. | true | False | |
| Subject | String | Specifies a subject for the email message you want to send. | false | False | |
| To | String[] | Specifies the email address to which you want to send a message. | true | False | |
| WhatIf | SwitchParameter | Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified. | false | False |
Return Type
The newly created AlarmAction objectNotes
Examples
-------------------------- Example 1 --------------------------
Get-AlarmDefinition -Name "Alarm1" | New-AlarmAction -Snmp
Creates an alarm action SNMP and attaches it to the specified alarm.
-------------------------- Example 2 --------------------------
New-AlarmAction -Snmp
Creates an alarm action SNMP.
-------------------------- Example 3 --------------------------
Get-AlarmDefinition -Name "Alarm1" | New-AlarmAction -Script -ScriptPath 'c:\test.bat'
Creates an alarm action script and attaches it to the specified alarm.
-------------------------- Example 4 --------------------------
New-AlarmAction -Script -ScriptPath 'c:\test.bat'
Creates an alarm action script.
-------------------------- Example 5 --------------------------
Get-AlarmDefinition -Name "Alarm1" | New-AlarmAction -Email -To 'test@vmware.com' -CC @('test1@vmware.com', 'test2@vmware.com') -Body 'Test body' -Subject 'Test subject'Creates an alarm action email and attaches it to the specified alarm.
-------------------------- Example 6 --------------------------
-AlarmAction -Email -To 'test@vmware.com' -CC @('test1@vmware.com', 'test2@vmware.com') -Body 'Test body' -Subject 'Test subject'Creates an alarm action email.