Set-RetentionComplianceRule

Sintaxe

Default (Default)

Set-RetentionComplianceRule
    [-Identity] <ComplianceRuleIdParameter>
    [-ApplyComplianceTag <String>]
    [-Comment <String>]
    [-Confirm]
    [-ContentContainsSensitiveInformation <PswsHashtable[]>]
    [-ContentDateFrom <DateTime>]
    [-ContentDateTo <DateTime>]
    [-ContentMatchQuery <String>]
    [-ExcludedItemClasses <MultiValuedProperty>]
    [-ExpirationDateOption <String>]
    [-IRMRiskyUserProfiles <String>]
    [-PriorityCleanup]
    [-RetentionComplianceAction <String>]
    [-RetentionDuration <Unlimited>]
    [-RetentionDurationDisplayHint <HoldDurationHint>]
    [-WhatIf]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1

Set-RetentionComplianceRule -Identity "Internal Company Rule" -RetentionDuration 180 -RetentionDurationDisplayHint Days

Parâmetros

-ApplyComplianceTag

Aplicável: Segurança & Conformidade

O parâmetro ApplyComplianceTag especifica o rótulo aplicado a mensagens de email ou documentos pela regra (que afeta por quanto tempo o conteúdo é retido). Um valor válido para esse parâmetro é o nome de um rótulo existente. Se o valor contiver espaços, coloque-o entre aspas.

Você pode exibir e criar rótulos usando os cmdlets Get-ComplianceTag e New-ComplianceTag.

Não é possível usar esse parâmetro com os parâmetros Name ou PublishComplianceTag.

Não é possível usar esse parâmetro para regras de retenção do Teams.

Propriedades do parâmetro

Conjuntos de parâmetros

-Comment

Aplicável: Segurança & Conformidade

O parâmetro Comment especifica um comentário opcional. Se você especificar um valor que contenha espaços, coloque-o entre aspas ("), por exemplo: “Está é uma observação de administrador”.

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Aplicável: Segurança & Conformidade

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.

• Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
• A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.

Propriedades do parâmetro

Conjuntos de parâmetros

-ContentContainsSensitiveInformation

Aplicável: Segurança & Conformidade

O parâmetro ContentContainsSensitiveInformation especifica uma condição para a regra baseada em uma correspondência de tipo de informação confidencial no conteúdo. A regra é aplicada ao conteúdo que apresenta o tipo de informação confidencial especificado.

Esse parâmetro usa a sintaxe básica @(@{Name="SensitiveInformationType1";[minCount="Value"],@{Name="SensitiveInformationType2";[minCount="Value"],...). Por exemplo, @(@{Name="U.S. Social Security Number (SSN)"; minCount="2"},@{Name="Credit Card Number"}).

Use o cmdlet Get-DlpSensitiveInformationType para listar os tipos de informações confidenciais da sua organização no UCC_2nd. Para obter mais informações sobre os tipos de informações confidenciais, confira O que os tipos de informações confidenciais procuram.

Não é possível usar esse parâmetro para regras de retenção do Teams.

Propriedades do parâmetro

Conjuntos de parâmetros

-ContentDateFrom

Aplicável: Segurança & Conformidade

O parâmetro ContentDateFrom especifica a data de início do intervalo de datas do conteúdo a ser incluído.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada MM/dd/aaaa, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

Propriedades do parâmetro

Conjuntos de parâmetros

-ContentDateTo

Aplicável: Segurança & Conformidade

O parâmetro ContentDateTo especifica a data de término do intervalo de datas do conteúdo a ser incluído.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada MM/dd/aaaa, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

Propriedades do parâmetro

Conjuntos de parâmetros

-ContentMatchQuery

Aplicável: Segurança & Conformidade

O parâmetro ContentMatchQuery especifica um filtro de pesquisa de conteúdo.

Este parâmetro usa a cadeia de caracteres de pesquisa de texto ou uma consulta formatada através do uso da linguagem de consulta de palavra-chave (KQL). Para obter mais informações, consulte Referência de sintaxe QL por palavra-chave (KQL) e Consultas de palavra-chave e condições de pesquisa para descoberta eletrônica.

Não é possível usar esse parâmetro para regras de retenção do Teams.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcludedItemClasses

Aplicável: Segurança & Conformidade

O parâmetro ExcludedItemClasses especifica os tipos de mensagens a serem excluídas da regra. Você pode usar esse parâmetro somente para excluir itens de uma política de retenção, o que exclui a classe de item especificada de ser mantida. Esse parâmetro não exclui itens de políticas de exclusão. Normalmente, você usa esse parâmetro para excluir mensagens de caixa postal, conversas de mensagens instantâneas e outros conteúdos do Skype for Business Online de serem mantidos por uma política de retenção. Os valores comuns do Skype for Business incluem:

• IPM. Note.Microsoft.Conversation
• IPM. Note.Microsoft.Conversation.Voice
• IPM. Note.Microsoft.Missed
• IPM. Note.Microsoft.Missed.Voice
• IPM. Note.Microsoft.Voicemail
• IPM.Note.Microsoft.VoiceMessage.UA
• IPM. Note.Microsoft.Voicemail.UM
• IPM.Note.Microsoft.Voicemail.UM.CA

Além disso, você pode especificar classes de mensagem para itens do Exchange e classes de mensagens personalizadas ou não Microsoft. Os valores especificados não são validados, portanto, o parâmetro aceita qualquer valor de texto.

Você pode especificar vários valores de classe de item usando a seguinte sintaxe: "Value1","Value2",..."ValueN".

Não é possível usar esse parâmetro para regras de retenção do Teams.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExpirationDateOption

Aplicável: Segurança & Conformidade

O parâmetro ExpirationDateOption especifica se a data de expiração é calculada a partir da data de criação do conteúdo ou da data da última modificação. Os valores válidos são:

• CreationAgeInDays
• ModificationAgeInDays

Não é possível usar esse parâmetro para regras de retenção do Teams.

Propriedades do parâmetro

Conjuntos de parâmetros

-Identity

Aplicável: Segurança & Conformidade

O parâmetro Identity especifica a regra de retenção que você deseja modificar. É possível usar qualquer valor que identifique a regra com exclusividade. Por exemplo:

• Nome
• DN (nome diferenciado)
• GUID

Propriedades do parâmetro

Conjuntos de parâmetros

-IRMRiskyUserProfiles

Aplicável: Segurança & Conformidade

{{ Preencher IRMRiskyUserProfiles Description }}

Propriedades do parâmetro

Conjuntos de parâmetros

-PriorityCleanup

Aplicável: Segurança & Conformidade

A opção PriorityCleanup especifica se a regra associada a uma política de limpeza de prioridade deve ser atualizada. Não é preciso especificar um valor com essa opção.

As políticas de limpeza prioritária agilizam a exclusão de conteúdo confidencial substituindo quaisquer configurações de retenção existentes ou retenções de Descoberta Eletrônica. Para obter mais informações, consulte Limpeza prioritária.

Propriedades do parâmetro

Conjuntos de parâmetros

-RetentionComplianceAction

Aplicável: Segurança & Conformidade

O parâmetro RetentionComplianceAction especifica a ação de retenção para a regra. Os valores válidos são:

• Excluir
• Manter
• KeepAndDelete

Propriedades do parâmetro

Conjuntos de parâmetros

-RetentionDuration

Aplicável: Segurança & Conformidade

O parâmetro RetentionDuration especifica a duração de retenção para a regra de retenção. Os valores válidos são:

• Um inteiro: a duração da retenção em dias.
• Ilimitado: o conteúdo é mantido indefinidamente.

Propriedades do parâmetro

Conjuntos de parâmetros

-RetentionDurationDisplayHint

Aplicável: Segurança & Conformidade

O parâmetro RetentionDurationDisplayHint especifica as unidades que são usadas para exibir a duração de retenção no portal de conformidade do Microsoft Purview. Os valores válidos são Days, Months ou Years.

• Dias
• Meses
• Anos

Por exemplo, se esse parâmetro for definido como o valor Years e o parâmetro RetentionDuration for definido como o valor 365, o portal de conformidade do Microsoft Purview exibirá 1 ano como a duração de retenção de conteúdo.

Não é possível usar esse parâmetro para regras de retenção do Teams.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Aplicável: Segurança & Conformidade

A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters