Compartilhar via


Set-RetentionComplianceRule

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 cmdlet Set-RetentionComplianceRule para modificar as regras 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

Default (Padrão)

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

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

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

Este exemplo altera a duração da retenção da regra de retenção existente denominada "Regra Interna da Empresa".

Parâmetros

-ApplyComplianceTag

Aplicável: Conformidade do & de Segurança

O parâmetro ApplyComplianceTag especifica a etiqueta que é aplicada às mensagens de e-mail ou aos documentos pela regra (que afeta a duração da retenção do conteúdo). Um valor válido para este parâmetro é o nome de uma etiqueta existente. Se o valor contiver espaços, coloque-o entre aspas.

Pode ver e criar etiquetas com os cmdlets Get-ComplianceTag e New-ComplianceTag.

Não pode utilizar este parâmetro com os parâmetros Name ou PublishComplianceTag.

Não pode utilizar este parâmetro para regras de retenção do Teams.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Comment

Aplicável: Conformidade do & de Segurança

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

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: Conformidade do & de Segurança

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não 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 confirmar o comando antes de continuar.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ContentContainsSensitiveInformation

Aplicável: Conformidade do & de Segurança

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 pode utilizar este parâmetro para regras de retenção do Teams.

Propriedades do parâmetro

Tipo:

PswsHashtable[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ContentDateFrom

Aplicável: Conformidade do & de Segurança

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 utilizar o formato de data abreviada MM/dd/aaaa, introduza 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

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ContentDateTo

Aplicável: Conformidade do & de Segurança

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 utilizar o formato de data abreviada MM/dd/aaaa, introduza 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

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ContentMatchQuery

Aplicável: Conformidade do & de Segurança

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, veja Referência da sintaxe da Linguagem de Consulta de Palavras-chave (KQL) e Consultas de palavras-chave e condições de pesquisa para Deteção de Dados Eletrónicos.

Não pode utilizar este parâmetro para regras de retenção do Teams.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExcludedItemClasses

Aplicável: Conformidade do & de Segurança

O parâmetro ExcludedItemClasses especifica os tipos de mensagens a excluir da regra. Só pode utilizar este parâmetro para excluir itens de uma política de suspensão, o que exclui a classe de item especificada de ser mantida. Este parâmetro não exclui itens das políticas de eliminação. Normalmente, utiliza este parâmetro para excluir mensagens de voicemail, conversações de MI e outros Skype for Business conteúdo Online de serem mantidos por uma política de suspensão. Os valores de Skype for Business comuns incluem:

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

Além disso, pode especificar classes de mensagens para itens do Exchange e classes de mensagens personalizadas ou não microsoft. Os valores que especificar não são validados, pelo que o parâmetro aceita qualquer valor de texto.

Pode especificar vários valores de classe de itens com a seguinte sintaxe: "Value1","Value2",..."ValueN".

Não pode utilizar este parâmetro para regras de retenção do Teams.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExpirationDateOption

Aplicável: Conformidade do & de Segurança

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 pode utilizar este parâmetro para regras de retenção do Teams.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Conformidade do & de Segurança

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

  • Nome
  • DN (nome diferenciado)
  • GUID

Propriedades do parâmetro

Tipo:ComplianceRuleIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IRMRiskyUserProfiles

Aplicável: Conformidade do & de Segurança

{{ Preenchimento IRMRiskyUserProfiles Descrição }}

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PriorityCleanup

Aplicável: Conformidade do & de Segurança

O comutador PriorityCleanup especifica se pretende atualizar a regra associada a uma política de limpeza prioridade. Não é preciso especificar um valor com essa opção.

As políticas de limpeza prioritárias aceleram a eliminação de conteúdo confidencial ao substituir quaisquer definições de retenção existentes ou retenções de Deteção de Dados Eletrónicos. Para obter mais informações, veja Limpeza da Prioridade.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RetentionComplianceAction

Aplicável: Conformidade do & de Segurança

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

  • Excluir
  • Manter
  • KeepAndDelete

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RetentionDuration

Aplicável: Conformidade do & de Segurança

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

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

Propriedades do parâmetro

Tipo:Unlimited
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RetentionDurationDisplayHint

Aplicável: Conformidade do & de Segurança

O parâmetro RetentionDurationDisplayHint especifica as unidades utilizadas para apresentar a duração da 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 este parâmetro estiver definido como o valor Anos e o parâmetro RetentionDuration estiver definido como o valor 365, o portal de conformidade do Microsoft Purview apresenta 1 ano como a duração da suspensão do conteúdo.

Não pode utilizar este parâmetro para regras de retenção do Teams.

Propriedades do parâmetro

Tipo:HoldDurationHint
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Conformidade do & de Segurança

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.