Get-RetentionCompliancePolicy
Este cmdlet está disponível apenas no PowerShell de Segurança e Conformidade. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..
Utilize o Get-RetentionCompliancePolicy para ver as 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.
Sintaxe
Get-RetentionCompliancePolicy
[[-Identity] <PolicyIdParameter>]
[-DistributionDetail]
[-ErrorPolicyOnly]
[-ExcludeTeamsPolicy]
[-IncludeTestModeResults]
[-PriorityCleanup]
[-RetentionRuleTypes]
[-TeamsPolicyOnly]
[<CommonParameters>] Description
Esta lista descreve as propriedades que são apresentadas por predefinição.
- Nome: o nome exclusivo da política.
- Carga de trabalho: de momento, irá 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.
- Ativado: o valor Verdadeiro significa que a política está ativada.
- Modo: o modo de funcionamento atual da política. Os valores possíveis são Test (o conteúdo é testado, mas não são impostas regras), AuditAndNotify (quando o conteúdo corresponde às condições especificadas pela política, a regra não é imposta, mas os e-mails de notificação são enviados) ou Impor (todos os aspetos da política são ativados e impostos).
Para usar este cmdlet no PowerShell de Segurança e Conformidade, 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 apresenta informações detalhadas sobre a política denominada "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 não utilizar este comutador, os valores dos valores da propriedade DistributionStatus e *Location serão imprecisos.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-ErrorPolicyOnly
O comutador ErrorPolicyOnly especifica se pretende mostrar apenas as políticas que têm erros de distribuição nos resultados. Não é preciso especificar um valor com essa opção.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-ExcludeTeamsPolicy
O comutador ExcludeTeamsPolicy especifica se pretende excluir as políticas do Teams dos resultados. Não é preciso especificar um valor com essa opção.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | 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
| Tipo: | PolicyIdParameter |
| Cargo: | 1 |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-IncludeTestModeResults
O comutador IncludeTestModeResults especifica se deve incluir a 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.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-PriorityCleanup
{{ Prioridade de PreenchimentoDesução do Preenchimento }}
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-RetentionRuleTypes
O comutador RetentionRuleTypes especifica se pretende devolver o valor da propriedade RetentionRuleTypes nos resultados. Não é preciso especificar um valor com essa opção.
Para ver a propriedade RetentionRuleTypes, tem de encaminhar o comando para um cmdlet de formatação. Por exemplo, Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes. Se não utilizar o comutador RetentionRuleTypes, o valor aparece em branco.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-TeamsPolicyOnly
O comutador TeamsPolicyOnly especifica se pretende mostrar apenas as políticas do Teams nos resultados. Não é preciso especificar um valor com essa opção.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |