Set-DataClassification

Este cmdlet solo funciona en Exchange local.

En Exchange Online, este cmdlet se ha reemplazado por el cmdlet Set-DlpSensitiveInformationType de PowerShell de cumplimiento de seguridad&.

Use el cmdlet Set-DataClassification para modificar las reglas de clasificación de datos que usan huellas digitales de documento.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Set-DataClassification
   [-Identity] <DataClassificationIdParameter>
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Fingerprints <MultiValuedProperty>]
   [-IsDefault]
   [-Locale <CultureInfo>]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

Los paquetes de reglas de clasificación se usan en la prevención de pérdida de datos (DLP) para detectar contenido confidencial en los mensajes.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

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

En este ejemplo se agrega una traducción al francés para la regla de clasificación de datos existente denominada "Contoso Confidential" y se establece esta traducción al francés como el valor predeterminado.

Ejemplo 2

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

En este ejemplo se quita la traducción al español existente de la regla de clasificación de datos denominada "Contoso Confidential".

Ejemplo 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

En este ejemplo se modifica la regla de clasificación de datos existente denominada "Contoso Confidential". Para ello se agrega una nueva huella digital de documento para el archivo C:\My Documents\Contoso Benefits Template.docx sin que ello afecte a ninguna huella digital de documento existente que ya esté definida.

Ejemplo 4

$cc = Get-DataClassification "Contoso Confidential"

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

$a

$a.RemoveAt(0)

Set-DataClassification $cc.Identity -FingerPrints $a

En este ejemplo se modifica la regla de clasificación de datos denominada "Contoso Confidential". Para ello, se quita una huella digital de documento existente sin afectar a otras huellas digitales de documento que ya estén definidas.

Los tres primeros comandos devuelven la lista de huellas digitales del documento en la clasificación de datos. La primera huella digital de documento que hay en la lista tiene el número de índice 0, la segunda tiene el número de índice 1 y así sucesivamente. Use el número de índice para especificar la huella digital de documento que desea quitar. Los dos últimos comandos quitan la primera huella digital del documento que se muestra en la lista.

Parámetros

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el 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

El parámetro Description especifica una descripción para la regla de clasificación de datos. El parámetro Description se usa con los parámetros Locale y Name para especificar las descripciones para la regla de clasificación de datos en distintos idiomas. Los valores localizados de Description aparecen en la propiedad AllLocalizedDescriptions de la regla de clasificación de datos.

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

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, 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

El parámetro Fingerprints especifica los archivos de documento codificados en bytes que la regla de clasificación de datos usa como huellas digitales. Para obtener instrucciones sobre cómo importar documentos para usarlos como plantillas para las huellas digitales, consulte La nueva huella digital o la sección Ejemplos. Para obtener instrucciones sobre el procedimiento para agregar o quitar huellas digitales de documento de una regla de clasificación de datos existente, vea la sección 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

El parámetro Identity especifica la regla de clasificación de datos que desea modificar. Puede usar cualquier valor que identifique de forma exclusiva la regla de clasificación de datos. Por ejemplo:

  • Nombre
  • LocalizedName
  • Valor de GUID de identidad
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

El conmutador IsDefault se usa con el parámetro Locale para especificar el idioma predeterminado para la regla de clasificación de datos. No es necesario especificar un valor con este modificador.

El valor Locale predeterminado se almacena en la propiedad DefaultCulture.

Cuando cambia el valor Locale predeterminado, el valor Name de la regla de clasificación de datos cambia para coincidir con el valor Name asociado a la nueva configuración regional predeterminada. El valor Name original en el momento en que se creó la regla se almacena de forma permanente en la propiedad 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

El parámetro Locale agrega o quita idiomas que están asociados a la regla de clasificación de datos.

La entrada válida para este parámetro es un valor de código de referencia cultural admitido de la Microsoft clase CultureInfo de .NET Framework. Por ejemplo, da-DK para danés o ja-JP para japonés. Para obtener más información, vea CultureInfo (clase).

Normalmente, el parámetro Locale se usa con los parámetros Name y Description para agregar o quitar descripciones y nombres traducidos para la regla de clasificación de datos. También puede usar el parámetro Locale con el conmutador IsDefault para designar un nombre y una descripción traducidos existentes como los valores predeterminados. Antes de quitar la traducción predeterminada, tendrá que establecer otra traducción como predeterminada.

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

El parámetro Name especifica un nombre para la regla de clasificación de datos. El valor debe ser inferior a 256 caracteres.

El parámetro Name se usa con los parámetros Locale y Description para especificar los nombres para la regla de clasificación de datos en distintos idiomas. Los valores localizados de Name aparecen en la propiedad AllLocalizedNames de la regla de clasificación de datos.

El valor del parámetro Name se usa en la sugerencia de directiva que se presenta a los usuarios en Outlook en la Web. Cuando un valor traducido del parámetro Name coincide con el idioma del cliente, la sugerencia de directiva se muestra en el idioma del cliente. Si el parámetro Name no tiene ningún valor traducido que coincida con el idioma del cliente, se usará la traducción predeterminada especificada por el parámetro IsDefault para la sugerencia de directiva.

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

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

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 los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.