Compartir a través de

New-OMEConfiguration

Módulo:
Exchange PowerShell

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet New-OMEConfiguration para crear una configuración de 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 (Es el valor predeterminado). 

New-OMEConfiguration
    [-Identity] <OrganizationIdParameter>
    [-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

New-OMEConfiguration -Identity "Contoso Marketing" -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 crea una nueva configuración de OME denominada "Contoso Marketing" con los valores especificados. Los parámetros sin usar obtienen los valores predeterminados.

Parámetros

-BackgroundColor

Aplicable: Exchange Online

El parámetro BackgroundColor especifica el color de fondo. Los valores admitidos son:

  • Un valor de código de color HTML hexadecimal (triple hexadecimal) disponible (por ejemplo, 0x000000 es blanco).
  • Un valor de texto disponible (por ejemplo, yellow es 0x00FFFF00).
  • $null (en blanco). Este valor es el predeterminado.

Para obtener más información, consulte Agregar la marca de su organización a los mensajes cifrados.

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

-Confirm

Aplicable: Exchange Online

Este parámetro está reservado para uso interno de Microsoft.

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

-DisclaimerText

Aplicable: Exchange Online

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 (").

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

-EmailText

Aplicable: Exchange Online

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 (").

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

-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.

En la salida del cmdlet Get-OMEConfiguration, el valor de este parámetro se muestra en la propiedad ExternalMailExpiryInterval.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Int32
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: Exchange Online

El parámetro Identity especifica un nombre único para el objeto de configuración de OME. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas (").

Propiedades del parámetro

Tipo:OrganizationIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Image

Aplicable: Exchange Online

El parámetro Image identifica y carga una imagen que se muestra 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

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

-IntroductionText

Aplicable: Exchange Online

El parámetro IntroductionText especifica el texto predeterminado que acompaña a los mensajes de correo electrónico cifrados. El texto predeterminado aparece debajo de la dirección de correo electrónico del destinatario para ver el mensaje cifrado. Si el valor contiene espacios, escriba el valor entre comillas (").

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

-OTPEnabled

Aplicable: Exchange Online

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 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

-PortalText

Aplicable: Exchange Online

El parámetro PortalText especifica el texto que aparece en la parte superior del portal de visualización de correo electrónico cifrado. Se permite una longitud máxima de 128 caracteres. Si el valor contiene espacios, escriba el valor entre comillas (").

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

-PrivacyStatementUrl

Aplicable: Exchange Online

{{ Fill PrivacyStatementUrl Description }}

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

-ReadButtonText

Aplicable: Exchange Online

El parámetro ReadButtonText especifica el texto que aparece en el botón "Leer mensaje". Si el valor contiene espacios, escriba el valor entre comillas (").

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

-SocialIdSignIn

Aplicable: Exchange Online

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, etc.). 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 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

-WhatIf

Aplicable: Exchange Online

Este parámetro está reservado para uso interno de Microsoft.

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.