Set-DlpSensitiveInformationType
Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Algunos parámetros y configuraciones pueden ser exclusivos de un entorno u otro.
Use el cmdlet Set-DlpSensitiveInformationType para modificar las reglas de tipo de información confidencial que usan huellas digitales de documentos.
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.
Sintaxis
Default (Es el valor predeterminado).
Set-DlpSensitiveInformationType
[-Identity] <SensitiveInformationTypeIdParameter>
[-Confirm]
[-Description <String>]
[-FileData <Byte[]>]
[-Fingerprints <MultiValuedProperty>]
[-IsExact <Boolean>]
[-Locale <CultureInfo>]
[-Name <String>]
[-Threshold <UInt32>]
[-ThresholdConfig <PswsHashtable>]
[-WhatIf]
[<CommonParameters>]
Description
La prevención de pérdida de datos (DLP) usa paquetes de reglas de tipo de información confidencial para detectar contenido confidencial en los mensajes.
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. 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-DlpSensitiveInformationType "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 a la regla de tipo de información confidencial existente denominada "Contoso Confidential" y se establece esta traducción en francés como la predeterminada.
Ejemplo 2
Set-DlpSensitiveInformationType "Contoso Confidential" -Locale es -Name $null -Description $null
En este ejemplo se quita la traducción al español existente de la regla de tipo de información confidencial denominada "Contoso Confidential".
Ejemplo 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
En este ejemplo se modifica la regla de tipo de información confidencial existente denominada "Contoso Confidential" agregando una nueva huella digital del documento para el archivo C:\Mis documentos\Ventajas de Contoso Template.docx sin afectar a las huellas digitales de documento existentes que ya están definidas.
Ejemplo 4
$cc = Get-DlpSensitiveInformationType "Contoso Confidential"
$a = [System.Collections.ArrayList]($cc.Fingerprints)
$a
$a.RemoveAt(0)
Set-DlpSensitiveInformationType $cc.Identity -FingerPrints $a
En este ejemplo se modifica la regla de tipo de información confidencial denominada "Contoso Confidential" mediante la eliminación de 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 el tipo de información confidencial. 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
Aplicable: Cumplimiento de & de seguridad
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, los 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 otros cmdlets (por ejemplo, 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.
Este cmdlet tiene una pausa integrada, por lo que debe usar -Confirm:$false para omitir la confirmación.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Description
Aplicable: Cumplimiento de & de seguridad
El parámetro Description especifica una descripción para la regla de tipo de información confidencial. El parámetro Description se usa con los parámetros Configuración regional y Nombre para especificar descripciones para la regla de tipo de información confidencial en diferentes idiomas. Los valores localizados de Description aparecen en la propiedad AllLocalizedDescriptions de la regla de tipo de información confidencial.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-FileData
Aplicable: Cumplimiento de & de seguridad
{{ Fill FileData Description }}
Propiedades del parámetro
| Tipo: | Byte[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Fingerprints
Aplicable: Cumplimiento de & de seguridad
El parámetro Fingerprints especifica los archivos de documento codificados en bytes que la regla de tipo de información confidencial usa como huellas digitales. Para obtener instrucciones sobre cómo importar documentos para usarlos como plantillas para huellas digitales, consulte New-DlpFingerprint o la sección Ejemplos. Para obtener instrucciones sobre cómo agregar y quitar huellas digitales de documentos de una regla de tipo de información confidencial existente, consulte la sección Ejemplos.
Propiedades del parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: Cumplimiento de & de seguridad
El parámetro Identity especifica la regla de tipo de información confidencial que desea modificar. Puede usar cualquier valor que identifique de forma única la regla de tipo de información confidencial. Por ejemplo:
- Nombre
- LocalizedName
- Valor de GUID de identidad
Propiedades del parámetro
| Tipo: | SensitiveInformationTypeIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-IsExact
Aplicable: Cumplimiento de & de seguridad
{{ Fill IsExact Description }}
Propiedades del parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Locale
Aplicable: Cumplimiento de & de seguridad
El parámetro Configuración regional agrega o quita los idiomas asociados a la regla de tipo de información confidencial.
La entrada válida para este parámetro es un valor de código de referencia cultural compatible de la clase CultureInfo de Microsoft .NET Framework. Por ejemplo, da-DK para danés o ja-JP para japonés. Para obtener más información, consulte Clase CultureInfo.
Normalmente, se usa el parámetro Locale con los parámetros Name y Description para agregar o quitar nombres y descripciones traducidos para la regla de tipo de información confidencial. 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.
Propiedades del parámetro
| Tipo: | CultureInfo |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Aplicable: Cumplimiento de & de seguridad
El parámetro Name especifica un nombre para la regla de tipo de información confidencial. El valor debe ser inferior a 256 caracteres.
El parámetro Name se usa con los parámetros Configuración regional y Descripción para especificar nombres para la regla de tipo de información confidencial en diferentes idiomas. Los valores localizados de Name aparecen en la propiedad AllLocalizedNames de la regla de tipo de información confidencial.
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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Threshold
Aplicable: Cumplimiento de & de seguridad
{{ Descripción del umbral de relleno }}
Propiedades del parámetro
| Tipo: | UInt32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ThresholdConfig
Aplicable: Cumplimiento de & de seguridad
{{ Fill ThresholdConfig Description }}
Propiedades del parámetro
| Tipo: | PswsHashtable |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Cumplimiento de & de seguridad
El modificador WhatIf no funciona en Security & Compliance PowerShell.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.