Get-RetentionCompliancePolicy
Esse cmdlet está disponível apenas no PowerShell de Conformidade de Segurança & . Para obter mais informações, consulte PowerShell de Conformidade de Segurança&.
Use o Get-RetentionCompliancePolicy para exibir políticas de retenção existentes no portal de conformidade do Microsoft Purview.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
Get-RetentionCompliancePolicy
[[-Identity] <PolicyIdParameter>]
[-DistributionDetail]
[-ErrorPolicyOnly]
[-ExcludeTeamsPolicy]
[-IncludeTestModeResults]
[-RetentionRuleTypes]
[-TeamsPolicyOnly]
[<CommonParameters>] Description
Esta lista descreve as propriedades exibidas por padrão.
- Nome: o nome exclusivo da política.
- Carga de trabalho: no momento, ele mostrará todas as cargas de trabalho (Exchange, SharePoint, OneDriveForBusiness, Skype, ModernGroup) e não mostrará a carga de trabalho real na qual a política é aplicada.
- Habilitado: o valor True significa que a política está habilitada.
- Modo: o modo operacional atual da política. Os valores possíveis são Teste (o conteúdo é testado, mas nenhuma regra é imposta), AuditAndNotify (quando o conteúdo corresponde às condições especificadas pela política, a regra não é imposta, mas emails de notificação são enviados) ou Impor (todos os aspectos da política são habilitados e imposto).
Para usar esse cmdlet no PowerShell de Conformidade de Segurança & , você precisa receber permissões. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.
Exemplos
Exemplo 1
Get-RetentionCompliancePolicyEste exemplo exibe informações de resumo de todas as políticas de retenção da sua organização.
Exemplo 2
Get-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -DistributionDetail | Format-ListEste exemplo exibe informações detalhadas para a política chamada "Conformidade do Regulamento 123", incluindo valores precisos para as propriedades DistributionStatus e *Location.
Parâmetros
-DistributionDetail
A opção DistributionDetail retorna informações detalhadas de distribuição de políticas na propriedade DistributionResults. Não é preciso especificar um valor com essa opção.
Se você não usar essa opção, os valores dos valores de propriedade DistributionStatus e *Location serão imprecisos.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ErrorPolicyOnly
A opção ErrorPolicyOnly especifica se deve mostrar apenas políticas com erros de distribuição nos resultados. Não é preciso especificar um valor com essa opção.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ExcludeTeamsPolicy
A opção ExcludeTeamsPolicy especifica se as políticas do Teams devem ser excluídas dos resultados. Não é preciso especificar um valor com essa opção.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Identity
O parâmetro Identity especifica a política de retenção que você deseja exibir. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
| Type: | PolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-IncludeTestModeResults
A opção IncludeTestModeResults especifica se deve incluir o status do modo de teste nos detalhes da política. Não é preciso especificar um valor com essa opção.
Para obter mais informações sobre o modo de simulação, consulte Saiba sobre o modo de simulação.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RetentionRuleTypes
A opção RetentionRuleTypes especifica se deve retornar o valor da propriedade RetentionRuleTypes nos resultados. Não é preciso especificar um valor com essa opção.
Para ver a propriedade RetentionRuleTypes, você precisa canalizar o comando para um cmdlet de formatação. Por exemplo, Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes. Se você não usar a opção RetentionRuleTypes, o valor aparecerá em branco.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TeamsPolicyOnly
A opção TeamsPolicyOnly especifica se deve mostrar apenas as políticas do Teams nos resultados. Não é preciso especificar um valor com essa opção.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |