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 1En 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 10En 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 10En 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 |