Set-DlpSensitiveInformationType

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet Set-DlpSensitiveInformationType para modificar regras confidenciais de tipo de informação que usam impressões digitais do documento.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Set-DlpSensitiveInformationType
   [-Identity] <SensitiveInformationTypeIdParameter>
   [-Confirm]
   [-Description <String>]
   [-FileData <Byte[]>]
   [-Fingerprints <MultiValuedProperty>]
   [-IsExact <Boolean>]
   [-Locale <CultureInfo>]
   [-Name <String>]
   [-Threshold <UInt32>]
   [-ThresholdConfig <PswsHashtable>]
   [-WhatIf]
   [<CommonParameters>]

Description

Pacotes de regra de tipo de informação confidencial são usados pela DLP (prevenção contra perda de dados) para detectar conteúdo confidencial em mensagens.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Set-DlpSensitiveInformationType "Contoso Confidential" -Locale fr -Name "Contoso Confidentiel" -Description "Ce message contient des informations confidentielles." -IsDefault

Este exemplo adiciona uma tradução em francês à regra de tipo de informação confidencial existente chamada "Contoso Confidential" e define essa tradução em francês como o padrão.

Exemplo 2

Set-DlpSensitiveInformationType "Contoso Confidential" -Locale es -Name $null -Description $null

Este exemplo remove a tradução em espanhol existente da regra de tipo de informação confidencial chamada "Contoso Confidential".

Exemplo 3

$Benefits_Template = [System.IO.File]::ReadAllBytes('C:\My Documents\Contoso Benefits Template.docx')

$Benefits_Fingerprint = New-DlpFingerprint -FileData $Benefits_Template -Description "Contoso Benefits Template"

$Contoso_Confidential = Get-DlpSensitiveInformationType "Contoso Confidential"

$Array = [System.Collections.ArrayList]($Contoso_Confidential.Fingerprints)

$Array.Add($Benefits_FingerPrint[0])

Set-DlpSensitiveInformationType $Contoso_Confidential.Identity -FingerPrints $Array

Este exemplo modifica a regra de tipo de informação confidencial existente chamada "Contoso Confidential" adicionando uma nova impressão digital de documento para o arquivo C:\My Documents\Contoso Benefits Template.docx sem afetar nenhuma impressão digital de documento existente que já esteja definida.

Exemplo 4

$cc = Get-DlpSensitiveInformationType "Contoso Confidential"

$a = [System.Collections.ArrayList]($cc.Fingerprints)

$a

$a.RemoveAt(0)

Set-DlpSensitiveInformationType $cc.Identity -FingerPrints $a

Este exemplo modifica a regra de tipo de informação confidencial chamada "Contoso Confidential" removendo uma impressão digital de documento existente sem afetar outras impressões digitais de documento que já estão definidas.

Os três primeiros comandos retornam a lista de impressões digitais do documento no tipo de informações confidenciais. A primeira impressão digital de documento da lista tem o número de índice 0, a segunda tem o número de índice 1, e assim por diante. Use o número de índice para especificar a impressão digital de documento que você deseja remover. Os dois últimos comandos removem a primeira impressão digital do documento exibida na lista.

Parâmetros

-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

-Description

O parâmetro Description especifica uma descrição para a regra de tipo de informação confidencial. Você usa o parâmetro Descrição com os parâmetros Locale e Name para especificar descrições para a regra de tipo de informação confidencial em idiomas diferentes. Os valores localizados de Description aparecem na propriedade AllLocalizedDescriptions da regra de tipo de informação confidencial.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-FileData

{{ Fill FileData Description }}

Type:Byte[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Fingerprints

O parâmetro Impressões digitais especifica os arquivos de documento codificados por bytes que são usados como impressões digitais pela regra de tipo de informação confidencial. Para obter instruções sobre como importar documentos para usar como modelos para impressões digitais, consulte Nova DlpFingerprint ou a seção Exemplos. Para obter instruções sobre como adicionar e remover impressões digitais do documento de uma regra de tipo de informação confidencial existente, consulte a seção Exemplos.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Identity

O parâmetro Identity especifica a regra de tipo de informação confidencial que você deseja modificar. Você pode usar qualquer valor que identifique exclusivamente a regra de tipo de informação confidencial. Por exemplo:

  • Nome
  • Localizedname
  • Valor guid de identidade
Type:SensitiveInformationTypeIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Security & Compliance

-IsExact

{{ Preencher Descrição isExact }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Locale

O parâmetro Locale adiciona ou remove idiomas associados à regra de tipo de informação confidencial.

A entrada válida para esse parâmetro é um valor de código de cultura com suporte da classe Microsoft .NET Framework CultureInfo. Por exemplo, da-DK para dinamarquês ou ja-JP para japonês. Para obter mais informações, consulte Classe CultureInfo.

Normalmente, você usa o parâmetro Locale com os parâmetros Nome e Descrição para adicionar ou remover nomes e descrições traduzidos para a regra de tipo de informação confidencial. Você também pode usar o parâmetro Locale com a opção IsDefault para designar como padrão uma descrição e nome traduzido existente. Antes de poder remover a tradução padrão, você precisa definir outra tradução como padrão.

Type:CultureInfo
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 para a regra de tipo de informação confidencial. O valor deve ter menos de 256 caracteres.

Use o parâmetro Nome com os parâmetros Locale e Description para especificar nomes para a regra de tipo de informação confidencial em idiomas diferentes. Os valores localizados de Name aparecem na propriedade AllLocalizedNames da regra de tipo de informação confidencial.

O valor do parâmetro Name é usado na Dica de Política apresentada aos usuários no Outlook na Web. Quando um valor traduzido do parâmetro Name corresponde ao idioma do cliente, a Dica de Política é exibida no idioma do cliente. Se nenhum valor traduzido do parâmetro Name corresponder ao idioma do cliente, a tradução padrão especificada pelo parâmetro IsDefault será usada na Dica de Política.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Threshold

{{ Descrição do limite de preenchimento }}

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ThresholdConfig

{{ Fill ThresholdConfig Description }}

Type:PswsHashtable
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