Set-AppRetentionComplianceRule

Módulo:

ExchangePowerShell

Se aplica a:

Security & Compliance

Este cmdlet solo está disponible en PowerShell de cumplimiento de seguridad & . 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.

Syntax

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 PowerShell de cumplimiento de seguridad & , 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 retención de una regla denominada 563 Regla de marketing.

Parámetros

-Comment

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".

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-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:	Security & Compliance

-ContentContainsSensitiveInformation

El parámetro ContentContainsSensitiveInformation especifica una condición para la regla basada en una coincidencia de tipo de información confidencial en el contenido. La regla se aplica al contenido que contiene el tipo de información confidencial especificado.

Este parámetro usa la sintaxis @(@{Name="SensitiveInformationType1";[minCount="Value"],@{Name="SensitiveInformationType2";[minCount="Value"],...)básica . 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, vea Qué buscan los tipos de información confidencial de Exchange.

Type:	PswsHashtable[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ContentDateFrom

{{ Fill ContentDateFrom Description }}

Type:	System.DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ContentDateTo

{{ Fill ContentDateTo Description }}

Type:	System.DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ContentMatchQuery

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 de palabras clave (KQL) y Consultas de palabras clave y condiciones de búsqueda para eDiscovery.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ExcludedItemClasses

El parámetro ExcludedItemClasses especifica los tipos de mensajes que se van a excluir de la regla. Este parámetro solo se puede usar para excluir elementos de una directiva de suspensión, lo que excluye la retención de la clase de elemento especificada. El uso de este parámetro no excluirá los elementos de las directivas de eliminación. Normalmente, este parámetro se usa para excluir los mensajes de correo de voz, las conversaciones de mensajería instantánea y otros Skype Empresarial contenido en línea de la retención de contenido de una directiva de suspensión. Entre los valores de Skype Empresarial comunes se incluyen:

• IPM. Nota. Microsoft. Conversación
• IPM. Nota. Microsoft. Conversation.Voice
• IPM. Nota. Microsoft. Perdido
• IPM. Nota. Microsoft. Missed.Voice
• IPM. Nota. Microsoft. Mensaje de voz
• IPM. Nota. Microsoft.VoiceMessage.UA
• IPM. Nota. Microsoft. Voicemail.UM
• IPM. Nota. Microsoft.Voicemail.UM.CA

Además, puede especificar clases de mensaje para elementos de Exchange y clases de mensajes personalizadas o de terceros. Tenga en cuenta que los valores especificados no se validan, por lo que el parámetro acepta cualquier valor de texto.

Puede especificar varios valores de clase de elemento mediante la sintaxis siguiente: "Value1","Value2",..."ValueN".

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ExpirationDateOption

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Identity

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

Type:	ComplianceRuleIdParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RetentionComplianceAction

El parámetro RetentionComplianceAction especifica la acción de retención de la regla. Los valores admitidos son:

• Delete
• Conservar
• KeepAndDelete

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RetentionDuration

El parámetro RetentionDuration especifica la duración de la suspensión de la regla de retención. Los valores admitidos son:

• Entero: duración de retención en días.
• Ilimitado: el contenido se mantiene indefinidamente.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RetentionDurationDisplayHint

El parámetro RetentionDurationDisplayHint especifica las unidades que se usan para mostrar la duración de retención en el portal de cumplimiento 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 Years y el parámetro RetentionDuration se establece en el valor 365, el portal de cumplimiento Microsoft Purview mostrará 1 año como duración de retención de contenido.

Type:	HoldDurationHint
Accepted values:	Days, Months, Years
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-WhatIf

El modificador WhatIf no funciona en PowerShell de cumplimiento de seguridad & .

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance