Compartir a través de


New-SweepRule

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Use el cmdlet New-SweepRule para crear reglas de barrido en buzones de correo. Las reglas de barrido se ejecutan a intervalos regulares para ayudar a mantener la bandeja de entrada limpia.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

New-SweepRule
   [-Name] <String>
   -Provider <String>
   [-Confirm]
   [-DestinationFolder <MailboxFolderIdParameter>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-ExceptIfFlagged <Boolean>]
   [-ExceptIfPinned <Boolean>]
   [-KeepForDays <Int32>]
   [-KeepLatest <Int32>]
   [-Mailbox <MailboxIdParameter>]
   [-Sender <RecipientIdParameter>]
   [-SourceFolder <MailboxFolderIdParameter>]
   [-SystemCategory <SystemCategoryType>]
   [-WhatIf]
   [<CommonParameters>]

Description

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

New-SweepRule -Name "From Michelle" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender michelle@fabrikam.com -KeepLatest 1

En este ejemplo se crea una nueva regla de barrido denominada "From Michelle" en el buzón de Felipe Apodaca que mantiene el mensaje más reciente de en la carpeta Bandeja de michelle@fabrikam.com entrada y mueve los mensajes anteriores a la carpeta Elementos eliminados.

Ejemplo 2

New-SweepRule -Name "From Lila" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender lila@fabrikam.com -KeepForDays 10

En este ejemplo se crea una nueva regla de barrido denominada "From Lila" en el buzón de Felipe Apodaca que mueve los mensajes de la carpeta Bandeja de lila@fabrikam.com entrada que tienen más de 10 días a la carpeta Elementos eliminados.

Ejemplo 3

New-SweepRule -Name "From Jeff" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender jeffm@fabrikam.com -SourceFolder "Felipe:\Sent Items" -KeepForDays 10

En este ejemplo se crea una nueva regla de barrido denominada "From Jeff" en el buzón de Felipe Apodaca que mueve los mensajes de jeffm@fabrikam.com la carpeta Elementos enviados que tienen más de 10 días a la carpeta Elementos eliminados.

Parámetros

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-DestinationFolder

El parámetro DestinationFolder especifica una acción para la regla Sweep que mueve los mensajes a la carpeta especificada. La sintaxis es MailboxID:\ParentFolder[\SubFolder].

Para el valor de MailboxID, puede usar cualquier valor que identifique de forma única el buzón. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre completo (DN)
  • Dominio\Nombre de usuario
  • Dirección de correo electrónico
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuario o nombre de la entidad de seguridad de usuario (UPN)

Los valores de ejemplo de este parámetro son john@contoso.com:\Unimportant o John:\Inbox\Misc. El valor predeterminado es MailboxID:\Deleted Items.

Type:MailboxFolderIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Este parámetro solo está disponible en Exchange local.

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-Enabled

El parámetro Enabled especifica si la regla de barrido está habilitada o deshabilitada. Los valores admitidos son:

  • $true: la regla está habilitada. Este es el valor predeterminado.
  • $false: la regla está deshabilitada.

Después de crear la regla, puede habilitarla o deshabilitarla mediante los cmdlets Enable-SweepRule y Disable-SweepRule.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-ExceptIfFlagged

El parámetro ExceptIfFlagged especifica una excepción para la regla sweep que busca mensajes con una marca de mensaje aplicada. Los valores admitidos son:

  • $true: La acción de regla no se aplica a los mensajes que tienen una marca de mensaje aplicada.
  • $false: No se usa la excepción.

Los valores típicos de marca de mensaje son:

  • Cualquiera
  • Llamar
  • DoNotForward
  • Seguimiento
  • ForYourInformation
  • Reenviar
  • NoResponseNecessary
  • Lectura
  • Responder
  • ReplyToAll
  • Revisar
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-ExceptIfPinned

El parámetro PinMessage especifica una excepción para la regla sweep que busca mensajes anclados. Los valores admitidos son:

  • $true: La acción de regla no se aplica a los mensajes anclados a la parte superior de la Bandeja de entrada.
  • $false: No se usa la excepción.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-KeepForDays

El parámetro KeepForDays especifica una acción para la regla de barrido que especifica el número de días para mantener los mensajes que coinciden con las condiciones de la regla. Una vez transcurrido el número de días, los mensajes se mueven a la ubicación especificada por el parámetro DestinationFolder (de forma predeterminada, la carpeta Elementos eliminados).

No se puede usar este parámetro con el parámetro KeepLatest y la regla Sweep debe contener un valor de parámetro KeepForDays o KeepLatest.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-KeepLatest

El parámetro KeepLatest especifica una acción para la regla de barrido que especifica el número de mensajes que se deben mantener que coinciden con las condiciones de la regla. Una vez superado el número de mensajes, los mensajes más antiguos se mueven a la ubicación especificada por el parámetro DestinationFolder (de forma predeterminada, la carpeta Elementos eliminados).

No puede usar este parámetro con el parámetro KeepForDays y la regla Sweep debe contener un valor de parámetro KeepForDays o KeepLatest.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Mailbox

El parámetro Mailbox especifica el buzón donde desea crear la regla de barrido. Es posible usar cualquier valor que identifique exclusivamente el buzón. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre completo (DN)
  • Dominio\Nombre de usuario
  • Dirección de correo electrónico
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuario o nombre de la entidad de seguridad de usuario (UPN)
Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Name

El parámetro Name especifica el nombre de la regla de barrido. Si el valor contiene espacios, escríbalo entre comillas.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Provider

El parámetro Provider especifica el proveedor para la regla sweep. Si el valor contiene espacios, escríbalo entre comillas.

En el caso de las reglas de barrido que se crean en Outlook en la Web, el valor predeterminado es Exchange16.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Sender

El parámetro Sender especifica una condición para la regla sweep que busca el remitente especificado en los mensajes. En el caso de remitentes internos, puede usar cualquier valor que identifique de forma exclusiva al remitente. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre distintivo (DN)
  • DN canónico
  • GUID

Para remitentes externos, use su dirección de correo electrónico.

Type:RecipientIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceFolder

El parámetro SourceFolder especifica una condición para la regla de barrido que busca mensajes en la carpeta especificada. La sintaxis es MailboxID:\ParentFolder[\SubFolder].

Para el valor de MailboxID, puede usar cualquier valor que identifique de forma única el buzón. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre completo (DN)
  • Dominio\Nombre de usuario
  • Dirección de correo electrónico
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuario o nombre de la entidad de seguridad de usuario (UPN)

Los valores de ejemplo de este parámetro son john@contoso.com:\Marketing o John:\Inbox\Reports. El valor predeterminado es MailboxID:\Inbox.

Type:MailboxFolderIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SystemCategory

El parámetro SystemCategory especifica una condición para la regla de barrido que busca mensajes con la categoría del sistema especificada. Las categorías del sistema están disponibles para todos los buzones de la organización. Los valores admitidos son:

  • No definido
  • Cuentas
  • Documento
  • DocumentPlus
  • Evento
  • Familia
  • Archivo
  • Vuelo
  • FromContact
  • Importante
  • Liveview
  • Alojamiento
  • MailingList
  • Boletín
  • Photo
  • Compra
  • RentalCar
  • RestaurantReservation
  • RetiredPromotion
  • ShippingNotification
  • Compras
  • SocialUpdate
  • Viaje
  • Vídeo
Type:SystemCategoryType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online