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.