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
Default (valor predeterminado)
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: actualmente, muestra todas las cargas de trabajo (Exchange, SharePoint, OneDriveForBusiness, Skype, ModernGroup). No muestra 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
Aplicable: Cumplimiento de & de seguridad
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.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ErrorPolicyOnly
Aplicable: Cumplimiento de & de seguridad
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.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExcludeTeamsPolicy
Aplicable: Cumplimiento de & de seguridad
El modificador ExcludeTeamsPolicy especifica si se deben excluir las directivas de Teams de los resultados. No es necesario especificar un valor con este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: Cumplimiento de & de seguridad
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
Precaución: El valor $null o un valor inexistente para el parámetro Identity devuelve todos los objetos como si ejecutara el comando Get- sin el parámetro Identity. Compruebe que las listas de valores del parámetro Identity son precisas y no contienen valores $null inexistentes.
Propiedades de parámetro
| Tipo: | PolicyIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-IncludeTestModeResults
Aplicable: Cumplimiento de & de seguridad
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.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PriorityCleanup
Aplicable: Cumplimiento de & de seguridad
{{ Fill PriorityCleanup Description }}
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-RetentionRuleTypes
Aplicable: Cumplimiento de & de seguridad
El modificador RetentionRuleTypes especifica si se debe devolver el valor de las propiedades RetentionRuleTypes y HasRules 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, los valores RetentionRuleTypes aparecerán en blanco y HasRules aparecerá false.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-TeamsPolicyOnly
Aplicable: Cumplimiento de & de seguridad
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.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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.