Leer en inglés

Compartir a través de


Get-RetentionCompliancePolicy

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

Use el Get-RetentionCompliancePolicy para ver las directivas de retención existentes en el portal de cumplimiento Microsoft Purview.

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

Get-RetentionCompliancePolicy
   [[-Identity] <PolicyIdParameter>]
   [-DistributionDetail]
   [-ErrorPolicyOnly]
   [-ExcludeTeamsPolicy]
   [-IncludeTestModeResults]
   [-PriorityCleanup]
   [-RetentionRuleTypes]
   [-TeamsPolicyOnly]
   [<CommonParameters>]

Description

En esta lista se describen las propiedades que se muestran de forma predeterminada.

  • Nombre: nombre único de la directiva.
  • Carga de trabajo: en este momento, mostrará todas las cargas de trabajo (Exchange, SharePoint, OneDriveForBusiness, Skype, ModernGroup) y no mostrará la carga de trabajo real en la que se aplica la directiva.
  • Habilitado: el valor True significa que la directiva está habilitada.
  • Modo: el modo de funcionamiento actual de la directiva. Los valores posibles son Test (el contenido se prueba, pero no se aplica ninguna regla), AuditAndNotify (cuando el contenido coincide con las condiciones especificadas por la directiva, la regla no se aplica, pero se envían correos electrónicos de notificación) o Aplicar (todos los aspectos de la directiva están habilitados y aplicados).

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

Get-RetentionCompliancePolicy

En este ejemplo se muestra información resumida de todas las directivas de retención de la organización.

Ejemplo 2

Get-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -DistributionDetail | Format-List

En este ejemplo se muestra información detallada de la directiva denominada "Cumplimiento del Reglamento 123", incluidos los valores precisos para las propiedades DistributionStatus y *Location.

Parámetros

-DistributionDetail

El conmutador DistributionDetail devuelve información de distribución de directivas detallada en la propiedad DistributionResults. No es necesario especificar un valor con este modificador.

Si no usa este modificador, los valores de los valores de las propiedades DistributionStatus y *Location serán inexactos.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Security & Compliance

-ErrorPolicyOnly

El modificador ErrorPolicyOnly especifica si se deben mostrar solo las directivas que tienen errores de distribución en los resultados. No es necesario especificar un valor con este modificador.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Security & Compliance

-ExcludeTeamsPolicy

El modificador ExcludeTeamsPolicy especifica si se deben excluir las directivas de Teams de los resultados. No es necesario especificar un valor con este modificador.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Security & Compliance

-Identity

El parámetro Identity especifica la directiva de retención que desea ver. Puede usar cualquier valor que identifique de forma exclusiva la directiva. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID
Tipo:PolicyIdParameter
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False
Se aplica a:Security & Compliance

-IncludeTestModeResults

El modificador IncludeTestModeResults especifica si se debe incluir el estado del modo de prueba en los detalles de la directiva. No es necesario especificar un valor con este modificador.

Para obtener más información sobre el modo de simulación, consulte Más información sobre el modo de simulación.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Security & Compliance

-PriorityCleanup

{{ Fill PriorityCleanup Description }}

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Security & Compliance

-RetentionRuleTypes

El modificador RetentionRuleTypes especifica si se debe devolver el valor de la propiedad RetentionRuleTypes en los resultados. No es necesario especificar un valor con este modificador.

Para ver la propiedad RetentionRuleTypes, debe canalizar el comando a un cmdlet de formato. Por ejemplo, Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes. Si no usa el modificador RetentionRuleTypes, el valor aparece en blanco.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Security & Compliance

-TeamsPolicyOnly

El modificador TeamsPolicyOnly especifica si se deben mostrar solo las directivas de Teams en los resultados. No es necesario especificar un valor con este modificador.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Security & Compliance