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-RetentionCompliancePolicyEn 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-ListEn 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 |