Compartir a través de


New-AppRetentionComplianceRule

Este cmdlet está disponible solo en Security & Compliance PowerShell. Para obtener más información, consulte Security & Compliance PowerShell.

Use el New-AppRetentionComplianceRule para crear 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

New-AppRetentionComplianceRule
    [-Name] <String>
    -Policy <PolicyIdParameter>
    [-Comment <String>]
    [-Confirm]
    [-ContentMatchQuery <String>]
    [-ExcludedItemClasses <MultiValuedProperty>]
    [-ExpirationDateOption <String>]
    [-RetentionComplianceAction <String>]
    [-RetentionDuration <Unlimited>]
    [-RetentionDurationDisplayHint <HoldDurationHint>]
    [-WhatIf]
    [<CommonParameters>]

ComplianceTag

New-AppRetentionComplianceRule
    -Policy <PolicyIdParameter>
    [-Confirm]
    [-ContentContainsSensitiveInformation <PswsHashtable[]>]
    [-ContentMatchQuery <String>]
    [-ExpirationDateOption <String>]
    [-MachineLearningModelIDs <MultiValuedProperty>]
    [-RetentionComplianceAction <String>]
    [-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

New-AppRetentionComplianceRule -Name RetUnlimited -Policy "Regulation 567 Compliance" -RetentionDuration Unlimited

En este ejemplo se crea una nueva regla de retención denominada RetUnlimited y se agrega a la directiva de retención denominada Cumplimiento del Reglamento 567.

Parámetros

-Comment

Aplicable: Cumplimiento de & de seguridad

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 del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:Named
Mandatory: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: Cumplimiento de & de seguridad

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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: Cumplimiento de & de seguridad

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 del parámetro

Tipo:

PswsHashtable[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ComplianceTag
Posición:Named
Mandatory: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: Cumplimiento de & de seguridad

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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ComplianceTag
Posición:Named
Mandatory: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: Cumplimiento de & de seguridad

El parámetro ExcludedItemClasses especifica los tipos de mensajes que se excluirán 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 excluye 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 comunes Skype Empresarial se incluyen:

  • IPM. Note.Microsoft.Conversation
  • IPM. Note.Microsoft.Conversation.Voice
  • IPM. Note.Microsoft.Missed
  • IPM. Note.Microsoft.Missed.Voice
  • IPM. Note.Microsoft.Voicemail
  • IPM.Note.Microsoft.VoiceMessage.UA
  • IPM. 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 personalizadas o que no sean de Microsoft. 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".

Propiedades del parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:Named
Mandatory: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: Cumplimiento de & de seguridad

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 del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MachineLearningModelIDs

Aplicable: Cumplimiento de & de seguridad

{{ Fill MachineLearningModelIDs Description }}

Propiedades del parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ComplianceTag
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Aplicable: Cumplimiento de & de seguridad

El parámetro Name especifica un nombre único para la regla de cumplimiento de retención de aplicaciones. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas (").

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:0
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Policy

Aplicable: Cumplimiento de & de seguridad

El parámetro Policy especifica la directiva de cumplimiento de retención de aplicaciones que contiene la regla de directiva de cumplimiento de retención de aplicaciones. Puede usar cualquier valor que identifique de forma exclusiva la directiva. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID

Propiedades del parámetro

Tipo:PolicyIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RetentionComplianceAction

Aplicable: Cumplimiento de & de seguridad

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

  • Eliminar
  • Conservar
  • KeepAndDelete

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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: Cumplimiento de & de seguridad

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.

Propiedades del parámetro

Tipo:Unlimited
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:Named
Mandatory: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: Cumplimiento de & de seguridad

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 muestra 1 año como duración de retención de contenido.

Propiedades del parámetro

Tipo:HoldDurationHint
Valor predeterminado:None
Valores aceptados:Days, Months, Years
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:Named
Mandatory: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: Cumplimiento de & de seguridad

El modificador WhatIf no funciona en Security & Compliance PowerShell.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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.