New-AppRetentionComplianceRule
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 New-AppRetentionComplianceRule para criar regras de conformidade de retenção de aplicações.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default
New-AppRetentionComplianceRule
[-Name] <String>
-Policy <PolicyIdParameter>
[-Comment <String>]
[-Confirm]
[-ContentMatchQuery <String>]
[-ExcludedItemClasses <MultiValuedProperty>]
[-ExpirationDateOption <String>]
[-RetentionComplianceAction <String>]
[-RetentionDuration <Unlimited>]
[-RetentionDurationDisplayHint <HoldDurationHint>]
[-WhatIf]
[<CommonParameters>]
ComplianceTag
New-AppRetentionComplianceRule
-Policy <PolicyIdParameter>
[-Confirm]
[-ContentContainsSensitiveInformation <PswsHashtable[]>]
[-ContentMatchQuery <String>]
[-ExpirationDateOption <String>]
[-MachineLearningModelIDs <MultiValuedProperty>]
[-RetentionComplianceAction <String>]
[-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
New-AppRetentionComplianceRule -Name RetUnlimited -Policy "Regulation 567 Compliance" -RetentionDuration Unlimited
Este exemplo cria uma nova regra de retenção denominada RetUnlimited e adiciona-a à política de retenção denominada Conformidade do Regulamento 567.
Parâmetros
-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
Default
| 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.
Propriedades do parâmetro
| Tipo: | PswsHashtable[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ComplianceTag
| 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Default
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
ComplianceTag
| 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. A utilização deste 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".
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Default
| 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
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 |
-MachineLearningModelIDs
Aplicável: Conformidade do & de Segurança
{{ Fill MachineLearningModelIDs Description }}
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ComplianceTag
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: Conformidade do & de Segurança
O parâmetro Nome especifica um nome exclusivo para a regra de conformidade de retenção de aplicações. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Default
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Policy
Aplicável: Conformidade do & de Segurança
O parâmetro Política especifica a política de conformidade de retenção de aplicações que contém a regra de política de conformidade de retenção de aplicações. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Propriedades do parâmetro
| Tipo: | PolicyIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| 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
Default
| 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.
Propriedades do parâmetro
| Tipo: | HoldDurationHint |
| Valor padrão: | None |
| Valores aceitos: | Days, Months, Years |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Default
| 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.