Creates a message filter for collections.

Detailed Description

The New-MMExMessageFilter cmdlet creates a message filter that will be used to skip specific messages in the collection based on the specified parameters. This filter can be used on collection level with Set-MMExCollection cmdlet . For details refer to Configuring Migration Using PowerShell section of User Guide.

Syntax

New-MMExMessageFilter

-MessageClassesToSkip <message class, full class name, suffix or prefix>

[-MessageClassesToSkipAgeBased <size limit>]

[-AgeInDays <integer>]

Examples

Example 1

New-MMExMessageFilter -MessageClassesToSkip "IPM.*.EnterpriseVault.Shortcut", "IPM.Post.*"

This command creates a message filter to skip all messages of the IPM.Post class including subclasses, and also all messages which class has IPM prefix and EnterpriseVault.Shortcut suffix.

Example 2

New-MMExMessageFilter -MessageClassesToSkip "IPM.*.EnterpriseVault.Shortcut", "IPM.Post.*" -MessageClassesToSkipAgeBased "IPM.Note.Shortcut" -AgeInDays 25

This command creates a message filter. It will skips all messages of the IPM.Post class including subclasses, all messages which class has IPM prefix and EnterpriseVault.Shortcut suffix, and all messages of the IPM.Note.Shortcut class that are older than 25 days.

Parameters

-MessageClassesToSkip
        

Specifies the list of message classes to be skipped. Migration Agent for Exchange will skip all specified message classes of messages..

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

TIP: You can use an asterisk wildcard character in names of message classes, so the full name need not be typed.

-MessageClassesToSkipAgeBased
        

Specifies a list of message classes that will be skipped depending on how many days ago these messages were created. Migration Agent for Exchange will skip certain message classes of messages that are older than a number of days specified by AgeInDays parameter.

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

TIP: You can use an asterisk wildcard character in names of message classes, so the full name need not be typed.

-AgeInDays

Specifies the number of days for MessageClassesToSkipAgeBased parameter. Migration Agent for Exchange will skip certain message classes of messages that are older than the specified number of days.

Required?	false
Position?	3
Default value	none
Accept pipeline input?	false
Accept wildcard characters?	false