New-AppRetentionComplianceRule
Esse cmdlet está disponível apenas no PowerShell de Conformidade de Segurança & . Para obter mais informações, confira PowerShell de Conformidade de Segurança&.
Use o New-AppRetentionComplianceRule para criar regras de conformidade de retenção de aplicativo.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
New-AppRetentionComplianceRule
[-Name] <String>
-Policy <PolicyIdParameter>
[-Comment <String>]
[-Confirm]
[-ContentMatchQuery <String>]
[-ExcludedItemClasses <MultiValuedProperty>]
[-ExpirationDateOption <String>]
[-RetentionComplianceAction <String>]
[-RetentionDuration <Unlimited>]
[-RetentionDurationDisplayHint <HoldDurationHint>]
[-WhatIf]
[<CommonParameters>]
New-AppRetentionComplianceRule
-Policy <PolicyIdParameter>
[-Confirm]
[-ContentContainsSensitiveInformation <PswsHashtable[]>]
[-ContentMatchQuery <String>]
[-ExpirationDateOption <String>]
[-MachineLearningModelIDs <MultiValuedProperty>]
[-RetentionComplianceAction <String>]
[-WhatIf]
[<CommonParameters>]
Description
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
New-AppRetentionComplianceRule -Name RetUnlimited -Policy "Regulation 567 Compliance" -RetentionDuration Unlimited
Este exemplo cria uma nova regra de retenção chamada RetUnlimited e a adiciona à política de retenção chamada Conformidade do Regulamento 567.
Parâmetros
-Comment
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”.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Confirm
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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false
. - A maioria dos outros cmdlets (por exemplo, cmdlets 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ContentContainsSensitiveInformation
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 contém o tipo de informações confidenciais especificado.
Esse parâmetro usa a sintaxe @(@{Name="SensitiveInformationType1";[minCount="Value"],@{Name="SensitiveInformationType2";[minCount="Value"],...)
básica . 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 para sua organização. Para obter mais informações sobre tipos de informações confidenciais, consulte Quais tipos de informações confidenciais no Exchange procuram.
Type: | PswsHashtable[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ContentMatchQuery
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 KQL (Linguagem de Consulta de Palavra-Chave) e consultas de palavra-chave e condições de pesquisa para descoberta eletrônica.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ExcludedItemClasses
O parâmetro ExcludeedItemClasses especifica os tipos de mensagens a serem excluídas da regra. Você pode usar esse parâmetro apenas para excluir itens de uma política de retenção, que exclui a classe de item especificada de ser mantida. O uso desse parâmetro não excluirá itens das políticas de exclusão. Normalmente, você usa esse parâmetro para excluir mensagens de caixa postal, conversas de IM e outros Skype for Business conteúdo online de ser mantido por uma política de espera. Os valores comuns de Skype for Business incluem:
- IPM. Nota. Microsoft. Conversa
- IPM. Nota. Microsoft. Conversation.Voice
- IPM. Nota. Microsoft. Perdeu
- IPM. Nota. Microsoft. Missed.Voice
- IPM. Nota. Microsoft. Voicemail
- IPM. Nota. Microsoft.VoiceMessage.UA
- IPM. Nota. Microsoft. Voicemail.UM
- IPM. Nota. Microsoft.Voicemail.UM.CA
Além disso, você pode especificar classes de mensagens para itens do Exchange e classes de mensagens personalizadas ou de terceiros. Observe que 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"
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ExpirationDateOption
O parâmetro ExpirationDateOption especifica se a data de validade é calculada a partir da data de criação do conteúdo ou da última data de modificação. Os valores válidos são:
- CreationAgeInDays
- ModificationAgeInDays
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-MachineLearningModelIDs
{{ Fill MachineLearningModelIDs Description }}
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Name
O parâmetro Name especifica um nome exclusivo para a regra de conformidade de retenção de aplicativo. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Policy
O parâmetro Política especifica a política de conformidade de retenção de aplicativo que contém a regra de política de conformidade de retenção de aplicativo. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Type: | PolicyIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RetentionComplianceAction
O parâmetro RetentionComplianceAction especifica a ação de retenção para a regra. Os valores válidos são:
- Excluir
- Manter
- KeepAndDelete
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RetentionDuration
O parâmetro RetentionDuration especifica a duração de retenção da 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.
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RetentionDurationDisplayHint
O parâmetro RetentionDurationDisplayHint especifica as unidades usadas para exibir 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 esse parâmetro for definido como o valor Anos 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.
Type: | HoldDurationHint |
Accepted values: | Days, Months, Years |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-WhatIf
A opção WhatIf não funciona no PowerShell de Conformidade de Segurança & .
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |