Add-OVSmtpAlertEmailFilter

Syntax

Add-OVSmtpAlertEmailFilter
    [-Name] <String>
    [-Emails] <Net.Mail.MailAddress[]>
    [-Filter <String>]
    [-SenderEmail <mailaddress>]
    [-SenderEmailPassword <securestring>]
    [-Scope <HPEOneView.Appliance.ScopeCollection[]>]
    [-ScopeMatchPreference <String>]
    [-Async]
    [-ApplianceConnection <Object>]
    [<CommonParameters>]

Add-OVSmtpAlertEmailFilter
    [-RemoteSupportFilter]
    [-Async]
    [-ApplianceConnection <Object>]
    [<CommonParameters>]

Description

Email alerting feature notifies specified recipients when a certain alert occurs. When this feature is configured and enabled, the appliance performs these steps in addition to posting the alert:

The appliance compares the alert to configured search criteria.
If the alert matches, it creates an email message containing the text of the alert.
The appliance sends the email message to designated recipients in both plain text and HTML MIME types. Sending in both types allows the recipient?s mail application to determine the display.

You can enable or disable this email notification feature, or you can enable or disable individual filter notifications, as required.

The appliance provides for as many as 100 recipient and filter combinations, and allows as many as 50 recipients in a single email message. This flexibility lets you fine-tune which alert messages are sent and to whom. For example, you can configure the appliance to send Warning alerts to one recipient and Critical alerts to another.

This Cmdlet will help create an advanced alert to the specified recipient(s). You can also use the Cmdlet to add default OneView Remote Support alerting to specified recipient(s) using the -RemoteSupportFilter parameter. Appliance Email notification must be configured.

Info

Minimum required privileges: Infrastructure administrator.

Examples

Example 1

Add-OVSmtpAlertEmailFilter -Name "Monitor CPU Error and Warning conditions" -query "CPU status:warning or status:critical" -emails admin1@domain.com,admin2@domain.com

Set SMTP Alert to notify when system CPU status is either "warning" or "critical", and email 2 addresses.

Example 2

Add-OVSmtpAlertEmailFilter -Name "My Test Filter 3" -Filter "status:critical" -Emails "user1@domain.com","user2@domain.com" -Scope "My new Scope","My new Scope2" -Async

Create a new email critical alert for the two scope names, and return the Async Task object without waiting.

Example 3

Add-OVSmtpAlertEmailFilter -RemoteSupportFilter

Create OneView Remote Support filter on the appliance.

Parameters

-Name <String>

Name of the Filter you are creating.

Aliases	None
Required?	True
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Filter <String>

REST API filter specifying the resource category, URI, name, and severity.

Example: CPU status:"warning" or status:"critical"

Aliases	query
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Scope <HPEOneView.Appliance.ScopeCollection[]>

Scope(s) the Filter should apply to. Omitting parameter will apply filter to all resources.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-ScopeMatchPreference <String>

If providing multiple Scope resources, specify AND or OR to indicate match preference.

Aliases	None
Required?	False
Position?	Named
Default value	OR
Accept pipeline input?	false
Accept wildcard characters?	False

-Emails <Net.Mail.MailAddress[]>

Destination EMail address(es).

Aliases	recipients
Required?	True
Position?	Named
Default value
Accept pipeline input?	true (ByValue)
Accept wildcard characters?	False

-Async <SwitchParameter>

Use this parameter to immediately return the async task. By default, the Cmdlet will wait for the task to complete.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-ApplianceConnection <Object>

Specify one or more [HPEOneView.Appliance.Connection] object(s) or Name property value(s).

Aliases	Appliance
Required?	False
Position?	Named
Default value	(${Global:ConnectedSessions} \| ? Default)
Accept pipeline input?	false
Accept wildcard characters?	False

-RemoteSupportFilter <SwitchParameter>

Use to create the HPE OneView Remote Support email filter for service events.

Aliases	None
Required?	True
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-SenderEmail <mailaddress>

Sending email address option to set filters-specific email sender address.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-SenderEmailPassword <securestring>

Sending email address option is provided, you can optionally specify an email address password to authenticate with.

Aliases	None
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 (http://go.microsoft.com/fwlink/?LinkID=113216)

Input Types

Net.Mail.MailAddress[]

Array of email address recipient(s).

Return Values

HPEOneView.Appliance.TaskResource {System.Management.Automation.PSCustomObject}

Returns an async task resource to monitor.