Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP 7-mode documentation.

Cmdlet: Get-NcEmsMailHistory


NAME
Get-NcEmsMailHistory

SYNOPSIS
Get EMS mail history.

SYNTAX
Get-NcEmsMailHistory [[-Node] <String[]>] [[-SequenceNumber] <String[]>] [[-
MessageName] <String[]>] [-Attributes <EmsMailHistoryInfo>] [-Controller <Nc
Controller[]>] [<CommonParameters>]

Get-NcEmsMailHistory -Template [-Controller <NcController[]>] [<CommonParame
ters>]

Get-NcEmsMailHistory -Query <EmsMailHistoryInfo> [-Attributes <EmsMailHistor
yInfo>] [-Controller <NcController[]>] [<CommonParameters>]


DESCRIPTION
Get EMS mail history.


PARAMETERS
-Node <String[]>
Node emitting the EMS message. Data ONTAP wildcards are permitted.

Required? false
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-SequenceNumber <String[]>
The message sequence number. Data ONTAP wildcards are permitted.

Required? false
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-MessageName <String[]>
The emitted message's name. Data ONTAP wildcards are permitted.

Required? false
Position? 3
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Attributes <EmsMailHistoryInfo>
For improved scalability in large clusters, provide an EmsMailHistoryInf
o object with various fields set to indicate which fields to return on a
ll objects. Undesired fields should remain set to null. Use "Get-NcEms
MailHistory -Template" to get the initially empty EmsMailHistoryInfo obj
ect. If not specified, all data is returned for each object.

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

-Controller <NcController[]>
A Data ONTAP cluster-mode controller to receive this cmdlet, as embodied
by an NcController object. This parameter is returned by the Connect-N
cController cmdlet. If not specified, the value in the global variable
CurrentNcController is used. In the latter case, if CurrentNcController
contains a collection of NcController objects, this cmdlet is invoked o
n each controller in succession.

Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

-Template
Specify to get an empty EmsMailHistoryInfo object for use with advanced
queries involving the Query attribute.

Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Query <EmsMailHistoryInfo>
For advanced queries, provide a EmsMailHistoryInfo object with various f
ields set to indicate which records to retrieve. Other fields should re
main set to null. Use "Get-NcEmsMailHistory -Template" to get the initi
ally empty EmsMailHistoryInfo object.

Required? true
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 and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS
NetApp.Ontapi.Filer.C.Ems810.EmsMailHistoryInfo


NOTES


Category: ems
API: ems-mail-history-get-iter
Family: cluster

-------------- Example 1 --------------

C:\PS>Get-NcEmsMailHistory -MessageName app.log.info


Get the mail history for the EMS message app.log.info.


DropsSincePreviousTime :
MailAddress : {admin@localhost}
Message : app.log.info: test
MessageName : app.log.info
Node : fas3070cluster01-01
PreviousTime :
PreviousTimeDT :
SeqNum : 1
Time : 1333127534
TimeDT : 3/30/2012 1:12:14 PM


-------------- Example 2 --------------

C:\PS>$q = Get-NcEmsMailHistory -Template
$q.MailAddress = "admin@localhost"
Get-NcEmsMailHistory -Query $q


Get all the EMS mail messages that have been sent to the given address.


DropsSincePreviousTime :
MailAddress : {admin@localhost}
Message : app.log.info: test
MessageName : app.log.info
Node : fas3070cluster01-01
PreviousTime :
PreviousTimeDT :
SeqNum : 1
Time : 1333127534
TimeDT : 3/30/2012 1:12:14 PM



RELATED LINKS
Remove-NcEmsMailHistory







 Data ONTAP® PowerShell Toolkit