Get-RetentionCompliancePolicy

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

Syntax

Get-RetentionCompliancePolicy
   [[-Identity] <PolicyIdParameter>]
   [-DistributionDetail]
   [-ErrorPolicyOnly]
   [-ExcludeTeamsPolicy]
   [-IncludeTestModeResults]
   [-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 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

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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.

Type:SwitchParameter
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 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
Type:PolicyIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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.

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