Compartir a través de


New-MessageClassification

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Utilice el cmdlet New-MessageClassification para crear una instancia de clasificación de mensajes en la organización.

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

New-MessageClassification
   [-Name] <String>
   -DisplayName <String>
   -Locale <CultureInfo>
   -SenderDescription <String>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-RecipientDescription <String>]
   [-WhatIf]
   [<CommonParameters>]
New-MessageClassification
   [-Name] <String>
   -DisplayName <String>
   -SenderDescription <String>
   [-ClassificationID <Guid>]
   [-Confirm]
   [-DisplayPrecedence <ClassificationDisplayPrecedenceLevel>]
   [-DomainController <Fqdn>]
   [-PermissionMenuVisible <Boolean>]
   [-RecipientDescription <String>]
   [-RetainClassificationEnabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

Tras crear una clasificación de mensajes nueva, puede especificar la clasificación de mensajes como un predicado de reglas de transporte. Antes de Microsoft Outlook y Outlook en la Web los usuarios puedan aplicar la clasificación de mensajes a los mensajes, debe actualizar los sistemas de usuario final con el archivo XML de clasificación de mensajes creado por el archivo de script de Export-OutlookClassification.ps1. El archivo de script Export-OutlookClassification.ps1 se encuentra en el directorio %ExchangeInstallPath%Scripts.

Si crea una clasificación de mensajes, ésta no tiene configuración regional. De forma predeterminada, la nueva clasificación de mensajes se usa para todas las configuraciones regionales. Tras definir una clasificación de mensajes predeterminada, puede agregar nuevas configuraciones regionales de la clasificación ejecutando el cmdlet New-MessageClassification y especificando la identidad de la clasificación de mensajes predeterminada que desee localizar.

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

New-MessageClassification -Name "My Message Classification" -DisplayName "New Message Classification" -SenderDescription "This is the description text"

En este ejemplo se crea la clasificación de mensajes denominada Mi clasificación de mensajes con las siguientes propiedades:

  • El nombre para mostrar es New Message Classification.
  • La descripción del remitente es "This is the description text".

Ejemplo 2

New-MessageClassification -Name "My Message Classification" -Locale es-ES -DisplayName "España Example" -SenderDescription "Este es el texto de la descripción"

En Exchange local, en este ejemplo se crea una versión específica de la configuración regional (español - España) de una clasificación de mensajes existente denominada "Mi clasificación de mensajes".

Parámetros

-ClassificationID

El parámetro ClassificationID especifica el identificador de clasificación (GUID) de una clasificación de mensajes existente que desea importar y usar en su organización de Exchange. Use este parámetro si va a configurar clasificaciones de mensajes que abarcan dos bosques de Exchange en la misma organización.

Para buscar el valor classificationID de la clasificación de mensajes, reemplace por <MessageClassificationName> el nombre de la clasificación de mensajes y ejecute el siguiente comando: Get-MessageClassification -Identity "<MessageClassificationName>".

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DisplayName

El parámetro DisplayName especifica el título de la clasificación de mensajes que se muestra en Outlook y que seleccionan los usuarios. La longitud máxima es de 256 caracteres. Si el valor contiene espacios, escriba el valor entre comillas (").

El archivo XML de clasificación de mensajes debe estar presente en el equipo del remitente para que se visualice el nombre para mostrar.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DisplayPrecedence

El parámetro DisplayPrecedence especifica la precedencia relativa de la clasificación del mensaje con respecto a otras clasificaciones de mensaje que se pueden aplicar a un mensaje dado. Los valores admitidos son:

  • Highest
  • Higher
  • Alto
  • MediumHigh
  • Medio (este es el valor predeterminado)
  • MediumLow
  • Bajo
  • Lower
  • Lowest

Aunque Outlook solo permite a un usuario especificar una clasificación única para un mensaje, las reglas de transporte pueden aplicar otras clasificaciones a un mensaje. La clasificación con la prioridad más alta se muestra primero y las clasificaciones posteriores, que son aquellas con menor precedencia definida por este parámetro, se anexan en el orden adecuado a partir de entonces.

Type:ClassificationDisplayPrecedenceLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Este parámetro solo está disponible en Exchange local.

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.

El parámetro DomainController no es compatible con los servidores de transporte perimetral. Un servidor de transporte perimetral usa la instancia local de Active Directory Lightweight Directory Services (AD LDS) para leer y escribir datos.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Locale

Este parámetro funciona en exchange local.

El parámetro Locale especifica una versión específica de la configuración regional de una clasificación de mensajes existente. Use el parámetro -Name para identificar la clasificación de mensajes existente y el parámetro SenderDescription para especificar el texto descriptivo en otro idioma.

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

Type:CultureInfo
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Name

El parámetro Name especifica el nombre único para la clasificación de mensajes. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas (").

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-PermissionMenuVisible

El parámetro PermissionMenuVisible especifica si los valores especificados para los parámetros DisplayName y RecipientDescription se muestran en Outlook a medida que el usuario redacta un mensaje. Los valores admitidos son:

  • $true: los usuarios pueden asignar la clasificación de mensajes a los mensajes antes de que se envíen y se muestra la información de clasificación. Este es el valor predeterminado.
  • $false: Los usuarios no pueden asignar la clasificación de mensajes a los mensajes antes de que se envíen; sin embargo, los mensajes recibidos con esta clasificación de mensajes siguen mostrando la información de clasificación.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-RecipientDescription

El parámetro RecipientDescription especifica el texto detallado que se muestra al destinatario de Outlook cuando recibe un mensaje que tiene aplicada la clasificación de mensajes. La longitud máxima es de 1024 caracteres. Si el valor contiene espacios, escriba el valor entre comillas (").

Si no usa este parámetro, se usa el valor del parámetro SenderDescription.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-RetainClassificationEnabled

El parámetro RetainClassificationEnabled especifica si la clasificación de mensaje debe conservarse con el mensaje si se reenvía o si se responde el mensaje.

El valor predeterminado es $true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SenderDescription

El parámetro SenderDescription especifica el texto detallado que se muestra a los remitentes de Outlook cuando seleccionan una clasificación de mensajes para aplicarla a un mensaje antes de enviar el mensaje. La longitud máxima es de 1024 caracteres. Si el valor contiene espacios, escriba el valor entre comillas (").

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, 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 2010, 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.