Set-AppRetentionComplianceRule
Este cmdlet está disponible solo en Security & Compliance PowerShell. Para obtener más información, consulte Security & Compliance PowerShell.
Use el Set-AppRetentionComplianceRule para modificar las reglas de cumplimiento de retención de aplicaciones.
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.
Sintaxis
Default (valor predeterminado)
Set-AppRetentionComplianceRule
[-Identity] <ComplianceRuleIdParameter>
[-Comment <String>]
[-Confirm]
[-ContentContainsSensitiveInformation <PswsHashtable[]>]
[-ContentDateFrom <System.DateTime>]
[-ContentDateTo <System.DateTime>]
[-ContentMatchQuery <String>]
[-ExcludedItemClasses <MultiValuedProperty>]
[-ExpirationDateOption <String>]
[-RetentionComplianceAction <String>]
[-RetentionDuration <Unlimited>]
[-RetentionDurationDisplayHint <HoldDurationHint>]
[-WhatIf]
[<CommonParameters>]
Description
Para usar este cmdlet en Security & Compliance PowerShell, debe tener asignados permisos. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.
Ejemplos
Ejemplo 1
Set-AppRetentionComplianceRule -Identity "563 Marketing Rule" -RetentionDuration 180 -RetentionDurationDisplayHint Days
En este ejemplo se actualiza la duración de la retención de una regla denominada 563 Marketing Rule.
Parámetros
-Comment
Aplicable: Seguridad & cumplimiento
El parámetro Comment especifica un comentario opcional. Si especifica un valor que contenga espacios, escríbalo entre comillas ("), por ejemplo: "Esto es una nota del administrador".
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: Seguridad & cumplimiento
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, los 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 otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ContentContainsSensitiveInformation
Aplicable: Seguridad & cumplimiento
El parámetro ContentContainsSensitiveInformation especifica una condición para la regla que se basa en una coincidencia de tipo de información confidencial en el contenido. La regla se aplica al contenido que incluye el tipo especificado de información confidencial.
Este parámetro usa la sintaxis básica @(@{Name="SensitiveInformationType1";[minCount="Value"],@{Name="SensitiveInformationType2";[minCount="Value"],...). Por ejemplo, @(@{Name="U.S. Social Security Number (SSN)"; minCount="2"},@{Name="Credit Card Number"}).
Use el cmdlet Get-DLPSensitiveInformationType para enumerar los tipos de información confidencial de su organización. Para obtener más información sobre los tipos de información confidencial, consulte Qué buscan los tipos de información confidencial de Exchange.
Propiedades de parámetro
| Tipo: | PswsHashtable[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ContentDateFrom
Aplicable: Seguridad & cumplimiento
{{ Fill ContentDateFrom Description }}
Propiedades de parámetro
| Tipo: | System.DateTime |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ContentDateTo
Aplicable: Seguridad & cumplimiento
{{ Fill ContentDateTo Description }}
Propiedades de parámetro
| Tipo: | System.DateTime |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ContentMatchQuery
Aplicable: Seguridad & cumplimiento
El parámetro ContentMatchQuery especifica un filtro de búsqueda de contenido.
Este parámetro usa una cadena de búsqueda de texto o una consulta con formato mediante el idioma de consulta de palabra clave (KQL). Para obtener más información, vea Referencia de sintaxis del Lenguaje de consulta por palabra clave (KQL) y Consultas de palabras clave y condiciones de búsqueda para eDiscovery.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExcludedItemClasses
Aplicable: Seguridad & cumplimiento
El parámetro ExcludedItemClasses especifica los tipos de mensajes que se excluirán de la regla. Solo puede usar este parámetro para excluir elementos de una directiva de retención, que excluye la clase de elemento especificada. El uso de este parámetro no excluye los elementos de las directivas de eliminación. Normalmente, este parámetro se usa para excluir mensajes de correo de voz, conversaciones de mensajería instantánea y otro contenido de Skype Empresarial Online de la retención de una directiva de retención. Los valores comunes de Skype Empresarial incluyen:
- MIP. Note.Microsoft.Conversation
- MIP. Note.Microsoft.Conversation.Voice
- MIP. Note.Microsoft.Missed
- MIP. Note.Microsoft.Missed.Voice
- MIP. Note.Microsoft.Voicemail
- IPM.Note.Microsoft.VoiceMessage.UA
- MIP. Note.Microsoft.Voicemail.UM
- IPM.Note.Microsoft.Voicemail.UM.CA
Además, puede especificar clases de mensaje para elementos de Exchange y clases de mensajes personalizados o que no sean de Microsoft. Los valores que especifique no se validan, por lo que el parámetro acepta cualquier valor de texto.
Puede especificar varios valores de clase de elemento utilizando la sintaxis siguiente: "Value1","Value2",..."ValueN".
Propiedades de parámetro
| Tipo: | Unlimited |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExpirationDateOption
Aplicable: Seguridad & cumplimiento
El parámetro ExpirationDateOption especifica si la fecha de expiración se calcula a partir de la fecha de creación del contenido o de la fecha de última modificación. Los valores admitidos son:
- CreationAgeInDays
- ModificationAgeInDays
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: Seguridad & cumplimiento
El parámetro Identity especifica la regla de cumplimiento de retención de aplicaciones que desea modificar. Puede usar cualquier valor que identifique de forma exclusiva la directiva. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
Propiedades de parámetro
| Tipo: | ComplianceRuleIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-RetentionComplianceAction
Aplicable: Seguridad & cumplimiento
El parámetro RetentionComplianceAction especifica la acción de retención de la regla. Los valores admitidos son:
- Eliminar
- Conservar
- KeepAndDelete
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-RetentionDuration
Aplicable: Seguridad & cumplimiento
El parámetro RetentionDuration especifica la duración de la suspensión de la regla de retención. Los valores admitidos son:
- Un entero: la duración de la suspensión en días.
- Ilimitado: El contenido se mantiene indefinidamente.
Propiedades de parámetro
| Tipo: | Unlimited |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-RetentionDurationDisplayHint
Aplicable: Seguridad & cumplimiento
El parámetro RetentionDurationDisplayHint especifica las unidades que se usan para mostrar la duración de la retención en el portal de cumplimiento de Microsoft Purview. Los valores válidos son Days, Months y Years.
- Días
- Meses
- Años
Por ejemplo, si este parámetro se establece en el valor Años y el parámetro RetentionDuration se establece en el valor 365, el portal de cumplimiento de Microsoft Purview muestra 1 año como duración de retención de contenido.
Propiedades de parámetro
| Tipo: | HoldDurationHint |
| Valor predeterminado: | None |
| Valores aceptados: | Days, Months, Years |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Seguridad & cumplimiento
El modificador WhatIf no funciona en Security & Compliance PowerShell.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.