New-MessageClassification
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 Al especificar un nombre que incluya espacios, el nombre completo debe aparecer entre comillas, de la siguiente forma, como por ejemplo, |
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, |
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, |
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, 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 El valor predeterminado es |
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"