Share via

New-MessageClassification

  • Artículo

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2007-06-28

Utilice el cmdlet New-MessageClassification para crear una instancia de clasificación de mensajes nueva en la organización de Exchange. Tras crear una clasificación de mensajes nueva, puede especificar la clasificación de mensajes como un predicado de reglas de transporte. Antes de que los usuarios de Microsoft Office Outlook 2007 y Outlook Web Access 2007 puedan aplicar la clasificación de mensajes a los mensajes, debe actualizar los sistemas de usuarios finales con el archivo XML de clasificación de mensajes creado por el archivo de script Export-OutlookClassification.ps1. El archivo de script Export-OutlookClassification.ps1 se ubica en el directorio \Archivos de programa\Microsoft\Exchange Server\Scripts.

Si crea una clasificación de mensajes nueva, é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.

Sintaxis

New-MessageClassification -Name <String> -DisplayName <String> -SenderDescription <String> [-ClassificationID <Guid>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-RecipientDescription <String>] [-TemplateInstance <PSObject>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

New-MessageClassification -Identity <MessageClassificationIdParameter> -Locale <CultureInfo> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientDescription <String>] [-SenderDescription <String>] [-TemplateInstance <PSObject>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Para ejecutar el cmdlet New-MessageClassification, debe delegar lo siguiente a la cuenta que use:

  • Función Administrador de organización de Exchange

Para obtener más información sobre permisos, delegación de funciones y derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

DisplayName

Necesario

System.String

Utilice el parámetro DisplayName para especificar el nombre para mostrar de la instancia de clasificación de mensajes. El nombre para mostrar aparece en Office 2007 y lo usan los usuarios de Outlook para seleccionar la clasificación de mensajes adecuada antes de enviar un mensaje.

Nota

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

Si el parámetro UserDisplayEnabled se establece en $true, el nombre para mostrar se muestra para el destinatario aun cuando esté instalado el archivo XML de clasificación de mensajes.

Al especificar un nombre que incluya espacios, el nombre completo debe aparecer entre comillas, de la siguiente forma, como por ejemplo, "Display Name". El parámetro DisplayName debe contener un máximo de 64 caracteres.

Identity

Necesario

Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter

Utilice este parámetro para crear una versión traducida de una clasificación de mensajes existente. También debe especificar el parámetroLocale. El parámetro Identity puede incluir un valor de cadena, que es el valor Name de una clasificación de mensajes existente.

Locale

Necesario

System.Globalization.CultureInfo

La especificación de un código cultural del parámetro Locale crea una versión específica de la configuración regional de la clasificación de mensajes. También debe aprobar el parámetro Identity de la clasificación de mensajes existente predeterminada al crear una versión específica de la configuración regional.

La entrada válida del parámetro Locale son los nombres de cadenas que aparecen en la columna Nombre cultural en la referencia de clase Biblioteca de clases de Microsoft .NET disponible en CultureInfo.

Name

Necesario

System.String

Utilice este parámetro para especificar el nombre administrativo para la instancia de clasificación de mensajes. El nombre se usa para administrar la instancia de clasificación de mensajes. Al especificar un nombre que incluya espacios, el nombre completo debe aparecer entre comillas, de la siguiente forma, como por ejemplo, "Adminstrative Name". El parámetro Name debe contener un máximo de 256 caracteres.

SenderDescription

Necesario

System.String

Utilice este parámetro para explicar al remitente la finalidad de la clasificación de mensajes. El texto que especifique en este parámetro se usa mediante los usuarios de Outlook para seleccionar la clasificación de mensajes adecuados antes de que envíen un mensaje. Escriba la descripción entre comillas de la siguiente forma, por ejemplo, "This is the sender description that explains when to use this message classification". El parámetro SenderDescription debe contener un máximo de 1024 caracteres.

ClassificationID

Opcional

System.Guid

Utilice este parámetro para especificar un Id. de clasificación de una clasificación de mensajes existente que desee importar y usar en la organización de Exchange. Utilice este parámetro si va a configurar clasificaciones de mensajes que abarque dos bosques de Exchange en la misma empresa.

Confirm

Opcional

System.Management.Automation.SwitchParameter

El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo del controlador de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory, incluya el parámetro DomainController en el comando. El parámetro DomainController no se admite en equipos que tienen instalada la función del servidor Transporte perimetral. La función del servidor Transporte perimetral sólo escribe y lee desde la instancia Application Mode (ADAM) de Active Directory.

RecipientDescription

Opcional

System.String

Utilice este parámetro para explicar al destinatario la finalidad de la clasificación de mensajes. El texto que especifique en este parámetro lo visualizan los usuarios de Outlook al recibir un mensaje que tenga esta clasificación de mensajes. Escriba la descripción entre comillas de la siguiente forma, por ejemplo, "This is the recipient description that explains how to treat the message that has been classified". El parámetro RecipientDescription debe contener un máximo de 1024 caracteres.

Si no especifica un valor para este parámetro, se usará la descripción que especifique para SenderDescription.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Cuando un objeto existente se suministra al parámetro TemplateInstance, el comando usa la configuración de ese objeto para crear una copia idéntica del objeto en un servidor de destino o local.

UserDisplayEnabled

Opcional

System.Boolean

Utilice este parámetro para especificar si los valores que ha especificado para los parámetros DisplayName y RecipientDescription se muestran en el mensaje de Outlook del destinatario.

Si establece el parámetro UserDisplayEnabled en $false, los mensajes enviados a los destinatarios y que tienen esta clasificación de mensajes no muestran ninguna información de clasificación.

El valor predeterminado es $true.

Confirm

Opcional

System.Management.Automation.SwitchParameter

El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf.

Ejemplo

El siguiente ejemplo de código muestra tres ejemplos que usan el cmdlet New-MessageClassification.

El primer ejemplo muestra el comando New-MessageClassification que tenga los parámetros necesarios.

El segundo ejemplo muestra cómo crear una versión específica de la configuración regional (Español - España) de una clasificación de mensajes existentes.

El tercer ejemplo muestra cómo crear otra versión específica de la configuración regional (Español - México) de una clasificación de mensajes existentes.

New-MessageClassification -Name Example -DisplayName "New Message Classification" -SenderDescription "This is the description text"
New-MessageClassification -Identity Example -Locale es-ES -DisplayName "España Example " -SenderDescription "Este es el texto de la descripción"
New-MessageClassification -Identity Example -Locale es-MX -DisplayName "México Example" -SenderDescription "Este es el texto de la descripción"