Set-DataClassification

Esse cmdlet é funcional somente no Exchange local.

Em Exchange Online, esse cmdlet foi substituído pelo cmdlet Set-DlpSensitiveInformationType no PowerShell de conformidade de segurança&.

Use o cmdlet Set-DataClassification para modificar regras de classificação de dados que usem 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-DataClassification
   [-Identity] <DataClassificationIdParameter>
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Fingerprints <MultiValuedProperty>]
   [-IsDefault]
   [-Locale <CultureInfo>]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

Os pacotes de regras de classificação são usados pela prevenção de perda de dados (DLP) para detectar conteúdo confidencial nas 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-DataClassification "Contoso Confidential" -Locale fr -Name "Contoso Confidentiel" -Description "Ce message contient des informations confidentielles." -IsDefault

Este exemplo acrescenta uma tradução em francês à regra de classificação de dados existente com o nome de "Confidencial da Contoso" e define esta tradução como sendo a padrão.

Exemplo 2

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

Este exemplo remove a tradução em espanhol existente da regra de classificação de dados denominada "Confidencial da Contoso".

Exemplo 3

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

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

$Contoso_Confidential = Get-DataClassification "Contoso Confidential"

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

$Array.Add($Benefits_FingerPrint)

Set-DataClassification $Contoso_Confidential.Identity -FingerPrints $Array

Este exemplo modifica a regra de classificação de dados existente, denominada "Confidencial da Contoso", com o acréscimo de uma nova impressão digital de documento no arquivo C:\My Documents\Contoso Benefits Template.docx, sem afetar as impressões digitais de documento existentes e já definidas.

Exemplo 4

$cc = Get-DataClassification "Contoso Confidential"

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

$a

$a.RemoveAt(0)

Set-DataClassification $cc.Identity -FingerPrints $a

Este exemplo modifica a regra de classificação de dados denominada "Confidencial da Contoso", removendo uma impressão digital de documento existente, sem afetar outras impressões digitais de documentos já definidas.

Os três primeiros comandos retornam a lista de impressões digitais do documento na classificação de dados. 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:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Description

O parâmetro Description especifica uma descrição para a regra de classificação de dados. O parâmetro Description juntamente com os parâmetros Locale e Name são usados para especificar descrições da regra de classificação de dados em idiomas diferentes. Os valores localizados de Description são mostrados na propriedade AllLocalizedDescriptions da regra de classificação de dados.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Fingerprints

O parâmetro Fingerprints especifica os arquivos de documento codificados por bytes, usados como impressões digitais pela regra de classificação de dados. Para obter instruções sobre como importar documentos para usar como modelos para impressões digitais, consulte Nova Impressão Digital ou a seção Exemplos. Para ler as instruções sobre como adicionar e remover impressões digitais de documentos de uma regra existente de classificação de dados, veja a seção Examples.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

O parâmetro Identity especifica a regra de classificação de dados que você quer modificar. Use qualquer valor que identifique com exclusividade a regra de classificação de dados. Por exemplo:

  • Nome
  • Localizedname
  • Valor guid de identidade
Type:DataClassificationIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IsDefault

A opção IsDefault é usada com o parâmetro Locale para especificar o idioma padrão da regra de classificação de dados. Não é preciso especificar um valor com essa opção.

O valor padrão Locale é armazenado na propriedade DefaultCulture.

Quando você modifica o valor padrão Locale, o valor Name da regra de classificação de dados muda para corresponder ao valor Name associado à nova localidade padrão. O valor original Name de quando a regra foi criada é armazenado permanentemente na propriedade LocalizedName.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Locale

O parâmetro Locale adiciona ou remove idiomas associados à regra de classificação de dados.

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.

Geralmente, o parâmetro Locale juntamente com os parâmetros Name e Description são usados para adicionar ou remover descrições e nomes traduzidos da regra de classificação de dados. 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:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Name

O parâmetro Name especifica um nome para a regra de classificação de dados. O valor deve ter menos de 256 caracteres.

O parâmetro Name juntamente com os parâmetros Locale e Description são usados para especificar nomes da regra de classificação de dados em idiomas diferentes. Os valores localizados de Name são mostrados na propriedade AllLocalizedNames da regra de classificação de dados.

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:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.