New-MessageClassification
Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Algunos parámetros y configuraciones pueden ser 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.
Sintaxis
Localized
New-MessageClassification
[-Name] <String>
-DisplayName <String>
-Locale <CultureInfo>
-SenderDescription <String>
[-Confirm]
[-DomainController <Fqdn>]
[-RecipientDescription <String>]
[-WhatIf]
[<CommonParameters>]
Identity
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 que 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 artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. 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
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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>".
Propiedades del parámetro
| Tipo: | Guid |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Identity
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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, los 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 otros cmdlets (por ejemplo, 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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DisplayName
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DisplayPrecedence
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
El parámetro DisplayPrecedence especifica la prioridad relativa de la clasificación de mensajes a otras clasificaciones de mensajes que se pueden aplicar a un mensaje especificado. Los valores admitidos son:
- Highest
- Higher
- Alto
- MediumHigh
- Medio (valor predeterminado)
- MediumLow
- Bajo
- Lower
- Lowest
Aunque Outlook solo permite a un usuario especificar una clasificación única para un mensaje, es posible que las reglas de transporte apliquen 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.
Propiedades del parámetro
| Tipo: | ClassificationDisplayPrecedenceLevel |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Identity
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DomainController
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | Fqdn |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Locale
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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 Microsoft .NET Framework (por ejemplo, da-DK para danés o ja-JP para japonés). Para obtener más información, consulte Clase CultureInfo.
Propiedades del parámetro
| Tipo: | CultureInfo |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Localized
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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 (").
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PermissionMenuVisible
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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 valor es el 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.
Propiedades del parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Identity
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-RecipientDescription
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-RetainClassificationEnabled
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Propiedades del parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Identity
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SenderDescription
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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 (").
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.
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.