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." -IsDefaultEste 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 $nullEste 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 $ArrayEste 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 $aEste 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.