Set-OMEConfiguration
Este cmdlet solo está disponible en el servicio basado en la nube.
Use el cmdlet Set-OMEConfiguration para configurar Cifrado de mensajes de Microsoft Purview.
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 (valor predeterminado)
Set-OMEConfiguration
[-Identity] <OMEConfigurationIdParameter>
[-BackgroundColor <String>]
[-Confirm]
[-DisclaimerText <String>]
[-EmailText <String>]
[-ExternalMailExpiryInDays <Int32>]
[-Image <Byte[]>]
[-IntroductionText <String>]
[-OTPEnabled <Boolean>]
[-PortalText <String>]
[-PrivacyStatementUrl <String>]
[-ReadButtonText <String>]
[-SocialIdSignIn <Boolean>]
[-WhatIf]
[<CommonParameters>]
Description
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-OMEConfiguration -Identity "OME Configuration" -EmailText "Encrypted message enclosed." -PortalText "This portal is encrypted." -DisclaimerText "Encryption security disclaimer." -Image ([System.IO.File]::ReadAllBytes('C:\Temp\OME Logo.gif'))
En este ejemplo se configuran los valores especificados para la configuración predeterminada de OME denominada "Configuración de OME".
Parámetros
-BackgroundColor
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro BackgroundColor especifica el color de fondo. Los valores admitidos son:
- Un valor de código de color hexadecimal HTML (#RRGGBB) entre comillas. Por ejemplo,
"#FFFFFF"es blanco. - Valor de nombre de color válido. Por ejemplo,
yellowes #ffff00. Para obtener una lista de los nombres de color válidos, consulte Referencia de color de fondo. - $null (en blanco). Este valor es el predeterminado.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
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.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DisclaimerText
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro DisclaimerText especifica el texto de renuncia en el correo electrónico que contiene el mensaje cifrado. La longitud máxima es de 1024 caracteres. Si el valor contiene espacios, escriba el valor entre comillas (").
Para quitar el texto existente y usar el valor predeterminado, use el valor $null para este parámetro.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-EmailText
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro EmailText especifica el texto predeterminado que acompaña a los mensajes de correo electrónico cifrados. El texto predeterminado aparece encima de las instrucciones para visualizar los mensajes cifrados. La longitud máxima es de 1024 caracteres. Si el valor contiene espacios, escriba el valor entre comillas (").
Para quitar el texto existente y usar el valor predeterminado, use el valor $null para este parámetro.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExternalMailExpiryInDays
Aplicable: Exchange Online
Este parámetro solo está disponible con una suscripción de Cifrado avanzado de mensajes de Microsoft 365.
El parámetro ExternalMailExpiryInDays especifica el número de días que el mensaje cifrado está disponible para los destinatarios externos en el portal de Microsoft 365. Un valor válido es un entero comprendido entre 0 y 730. El valor 0 significa que los mensajes nunca expiran. El valor predeterminado es 0.
No se puede actualizar el valor de este parámetro en la configuración predeterminada de OME. Solo puede modificar este valor en una configuración personalizada.
En la salida del cmdlet Get-OMEConfiguration, el valor de este parámetro se muestra en la propiedad ExternalMailExpiryInterval.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Int32
| Posición: | Named |
| Obligatorio: | 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: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro Identity especifica la configuración de OME que desea modificar. La configuración predeterminada de OME tiene el valor de identidad "OME Configuration".
Propiedades de parámetro
| Tipo: | OMEConfigurationIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Image
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro Image identifica y carga una imagen que se mostrará en el mensaje de correo electrónico y en el Centro de administración de Microsoft 365.
Un valor válido para este parámetro requiere que lea el archivo en un objeto codificado en bytes mediante la sintaxis siguiente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Puede usar este comando como valor de parámetro o puede escribir la salida en una variable ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) y usar la variable como valor de parámetro ($data).
- Formatos de archivo compatibles: .png, .jpg, .bmp o .tiff
- Tamaño óptimo del archivo de logotipo: menos de 40 KB
- Dimensiones óptimas de la imagen de logotipo: 170 x 70 píxeles
Para quitar una imagen existente y usar la imagen predeterminada, use el valor $null para este parámetro.
Propiedades de parámetro
| Tipo: | Byte[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-IntroductionText
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro IntroductionText especifica el texto que aparece junto al nombre y la dirección de correo electrónico del remitente. Si el valor contiene espacios, escriba el valor entre comillas (").
Para quitar el texto existente y usar el valor predeterminado, use el valor $null para este parámetro.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-OTPEnabled
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro OTPEnabled especifica si se permite a los destinatarios usar un código de acceso único para ver los mensajes cifrados. Los valores admitidos son:
- $true: los destinatarios pueden usar un código de acceso único para ver los mensajes cifrados. Este valor es el predeterminado.
- $false: los destinatarios no pueden usar un código de acceso único para ver los mensajes cifrados. El destinatario debe iniciar sesión con una cuenta profesional o educativa de Microsoft 365.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PortalText
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro PortalText especifica el texto que aparece en la parte superior del portal de visualización de correo cifrado. Se permite una longitud máxima de 128 caracteres. Si el valor contiene espacios, escriba el valor entre comillas (").
Para quitar el texto existente y usar el valor predeterminado, use el valor $null para este parámetro.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PrivacyStatementUrl
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro PrivacyStatementUrl especifica el vínculo Declaración de privacidad en el mensaje de notificación de correo electrónico cifrado.
Si no usa este parámetro, el vínculo Declaración de privacidad se dirige a la declaración de privacidad predeterminada de Microsoft.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ReadButtonText
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro ReadButtonText especifica el texto que aparece en el botón "Leer el mensaje". Si el valor contiene espacios, escriba el valor entre comillas (").
Para quitar el texto existente y usar el valor predeterminado, use el valor $null para este parámetro.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SocialIdSignIn
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro SocialIdSignIn especifica si un usuario puede ver un mensaje cifrado en el Centro de administración de Microsoft 365 mediante su propio identificador de red social (Google, Yahoo y cuenta de Microsoft). Los valores admitidos son:
- $true: Se permite el inicio de sesión con identificador de red social. Este valor es el predeterminado.
- $false: No se permite el inicio de sesión con identificador de red social. El parámetro OTPEnabled controla si el destinatario puede usar un código de acceso único o su cuenta profesional o educativa de Microsoft 365.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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: Exchange Online, complemento de seguridad integrado para buzones locales
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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.
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.