Set-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 Set-SweepRule para modificar las reglas de barrido en los buzones de correo.
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
Set-SweepRule
[-Identity] <SweepRuleIdParameter>
[-Confirm]
[-DestinationFolder <MailboxFolderIdParameter>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-ExceptIfFlagged <Boolean>]
[-ExceptIfPinned <Boolean>]
[-KeepForDays <Int32>]
[-KeepLatest <Int32>]
[-Mailbox <MailboxIdParameter>]
[-Name <String>]
[-Provider <String>]
[-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
Set-SweepRule -Identity x2hlsdpGmUifjFgxxGIOJw== -KeepForDays 15 -ExceptIfPinned $trueEn este ejemplo se modifica la regla existente que tiene el valor de identificador de regla x2hlsdpGmUifjFgxxGIOJw== con el valor especificado.
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
Este parámetro está reservado para uso interno de Microsoft.
| 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 |
-Identity
El parámetro Identity especifica la regla de barrido que desea modificar. Puede usar cualquier valor que identifique de forma exclusiva la regla. Por ejemplo:
- Propiedad RuleId (por ejemplo, x2hlsdpGmUifjFgxxGIOJw==).
- Exchange Online:
MailboxAlias\RuleID(por ejemplo,rzaher\2hlsdpGmUifjFgxxGIOJw==). - Exchange local:
MailboxCanonicalName\RuleID(por ejemplo,contoso.com/Users/Rick Zaher\x2hlsdpGmUifjFgxxGIOJw==).
Puede obtener estos valores de identidad mediante el cmdlet Get-SweepRule.
| Type: | SweepRuleIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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 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 se 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 que contiene la regla que desea modificar. 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: | Named |
| Default value: | None |
| Required: | False |
| 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: | False |
| 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 |