New-MessageClassification (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-08
Use 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>] [-DomainController <Fqdn>] [-RecipientDescription <String>] [-TemplateInstance <PSObject>] [-UserDisplayEnabled <$true | $false>]
New-MessageClassification -Identity <MessageClassificationIdParameter> -Locale <CultureInfo> [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientDescription <String>] [-SenderDescription <String>] [-TemplateInstance <PSObject>] [-UserDisplayEnabled <$true | $false>]
Descripción detallada
Para ejecutar el cmdlet New-MessageClassification, debe delegar lo siguiente a la cuenta que use:
- Función Administrador de la organización de Exchange
Para obtener más información sobre los permisos, la delegación de funciones y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
DisplayName |
Necesario |
System.String |
Use 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 Si escribe un nombre con espacios, debe adjuntar el nombre completo entre comillas, como por ejemplo, |
Identity |
Necesario |
Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter |
Use 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 |
Use este parámetro para especificar el nombre administrativo de la instancia de clasificación de mensaje. El nombre se usa para administrar la instancia de clasificación de mensaje. Si escribe un nombre con espacios, debe adjuntar el nombre completo entre comillas, como por ejemplo, |
SenderDescription |
Necesario |
System.String |
Use este parámetro para explicar al remitente el objetivo que tiene la clasificación de mensaje. 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. Adjunte la descripción entre comillas, como por ejemplo, |
ClassificationID |
Opcional |
System.Guid |
Use 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. Use este parámetro si va a configurar clasificaciones de mensajes que abarque dos bosques de Exchange en la misma empresa. |
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 en la instancia de ADAM local de Active Directory. |
RecipientDescription |
Opcional |
System.String |
Use este parámetro para explicar al destinatario el objetivo que tenía la clasificación de mensaje. 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. Adjunte la descripción entre comillas, como por ejemplo, Si no especifica un valor para el parámetro, se usa la descripción introducida 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 |
Use 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 El valor predeterminado es |
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"