Set-SystemMessage

Este cmdlet solo está disponible en el entorno local de Exchange.

Use el cmdlet Set-SystemMessage para modificar mensajes personalizados del sistema. Los mensajes del sistema son notificaciones de estado de entrega (también conocidas como DSN, informes de no entrega, NDR o mensajes de devolución) y mensajes de cuota.

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

Default (valor predeterminado)

Set-SystemMessage
    [-Identity] <SystemMessageIdParameter>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Name <String>]
    [-Original]
    [-Text <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

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 tiene asignados. 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

Set-SystemMessage En\Internal\5.3.5 -Text "The recipient email system can't process this email message. Please contact your system administrator for more information."

En este ejemplo se modifica el texto del mensaje personalizado del sistema en inglés para el código de estado mejorado 5.3.5 para remitentes internos.

Ejemplo 2

Set-SystemMessage En\WarningMailbox -Text "Your mailbox has exceeded the warning limit specified by your email administrator. Please reduce the size of your mailbox."

En este ejemplo se modifica el texto del mensaje de cuota personalizado de WarningMailbox en inglés.

Parámetros

-Confirm

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al 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. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio: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, Exchange Server SE

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 de parámetro

Tipo:Fqdn
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro Identity especifica el mensaje de sistema personalizado que desea modificar. Puede usar cualquier valor que identifique de forma única el mensaje del sistema. Por ejemplo:

  • Identidad
  • Nombre completo (DN)
  • GUID

El valor de identidad de un mensaje del sistema utiliza uno de estos formatos:

  • Mensajes del sistema para códigos de estado mejorados: Language\<Internal | External>\DSNCode. Por ejemplo, En\Internal\5.1.2 o Ja\External\5.1.2.
  • Mensajes del sistema para las cuotas: Language\QuotaMessageType. Por ejemplo, En\ProhibitSendReceiveMailbox.

<Idioma>: Para obtener una lista de códigos de idioma admitidos, consulte Idiomas admitidos para NDR.

<DSNCode>: Los valores válidos son 4.x.y o 5.x.y, donde x e y son números de uno a tres dígitos. Para ver los códigos de sistema mejorados que utilizan actualmente los mensajes de sistema personalizados, ejecute el comando Get-SystemMessage. Para generar una lista de los códigos de estado mejorado predeterminados que utiliza Exchange, ejecute este comando: Get-SystemMessage -Original | Select-Object -Property Identity,DsnCode,Language,Text | ConvertTo-Html | Set-Content -Path "C:\My Documents\Default DSNs.html".

<QuotaMessageType>: Los valores válidos son:

Los criterios se pueden especificar mediante el uso del operador de comparación and. Los valores de propiedad que no se expresen como un entero deben estar entre comillas (").

  • ProhibitSendReceiveMailbox: un buzón supera su límite de ProhibitSendReceiveQuota.
  • ProhibitSendReceiveMailBox: un buzón supera su límite ProhibitSendReceiveQuota.
  • WarningMailbox: un buzón supera su límite de IssueWarningQuota cuando tiene configurado un límite de ProhibitSendQuota o ProhibitSendReceiveQuota.
  • WarningMailbox: un buzón supera su límite IssueWarningQuota cuando tiene un límite ProhibitSendQuota o ProhibitSendReceiveQuota configurado.

WarningMailboxUnlimitedSize: un buzón supera su límite IssueWarningQuota cuando no tiene un límite ProhibitSendQuota o ProhibitSendReceiveQuota configurado.

  • Cuotas de tamaño de las carpetas públicas:
  • WarningPublicFolder: una carpeta pública supera su límite IssueWarningQuota cuando tiene un límite ProhibitPostQuota configurado.
  • WarningPublicFolder: una carpeta pública supera su límite IssueWarningQuota cuando tiene un límite ProhibitPostQuota configurado.

WarningPublicFolderUnlimitedSize: una carpeta pública supera su límite IssueWarningQuota cuando no tiene un límite ProhibitPostQuota configurado.

  • Número máximo de mensajes en una carpeta de buzón de correo:
  • WarningMailboxMessagesPerFolderCount: un buzón supera el límite de MailboxMessagesPerFolderCountWarningQuota cuando tiene configurado un límite de MailboxMessagesPerFolderCountReceiveQuota.
  • WarningMailboxMessagesPerFolderCount: un buzón supera su límite MailboxMessagesPerFolderCountWarningQuota cuando tiene un límite MailboxMessagesPerFolderCountReceiveQuota configurado.

WarningMailboxMessagesPerFolderUnlimitedCount: un buzón supera su límite MailboxMessagesPerFolderCountWarningQuota cuando no tiene un límite MailboxMessagesPerFolderCountReceiveQuota configurado.

  • Número máximo de subcarpetas en una carpeta de buzón de correo:
  • WarningFolderHierarchyChildrenCount: un buzón supera su límite de FolderHierarchyChildrenCountWarningQuota cuando tiene configurado un límite de FolderHierarchyChildrenCountReceiveQuota.
  • WarningFolderHierarchyChildrenCount: un buzón supera su límite FolderHierarchyChildrenCountWarningQuota cuando tiene un límite FolderHierarchyChildrenCountReceiveQuota configurado.
  • ProhibitReceiveFoldersCount: un buzón supera el límite de FoldersCountReceiveQuota.
  • WarningFoldersCount: un buzón supera su límite de FoldersCountWarningQuota cuando tiene un límite de FoldersCountReceiveQuota configurado.
  • WarningFoldersCountUnlimited Un buzón supera el límite de FoldersCountWarningQuota cuando no tiene un límite de FoldersCountReceiveQuota configurado.

WarningFoldersCountUnlimited: un buzón supera su límite FoldersCountWarningQuota cuando no tiene un límite FoldersCountReceiveQuota configurado.

  • Número máximo de niveles (profundidad) en una carpeta de buzón de correo:
  • WarningFolderHierarchyDepth: un buzón supera el límite de FolderHierarchyDepthWarningQuota cuando tiene configurado un límite de FolderHierarchyDepthReceiveQuota.
  • WarningFolderHierarchyDepth: un buzón supera su límite FolderHierarchyDepthWarningQuota cuando tiene un límite FolderHierarchyDepthReceiveQuota configurado.

Propiedades de parámetro

Tipo:SystemMessageIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Name

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro Name especifica un nombre descriptivo para el mensaje del sistema. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Original

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El modificador original especifica si se dejará de utilizar el mensaje del sistema personalizado y empezará a utilizar el mensaje del sistema predeterminado. No es necesario especificar un valor con este modificador.

Este modificador es útil cuando se desea conservar el mensaje personalizado del sistema sin usarlo.

Este modificador solo funciona en mensajes del sistema personalizados para valores de código de estado mejorados predeterminados (no nuevos).

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Text

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro Texto especifica el texto del mensaje de sistema personalizado. El texto debe explicar por qué se envió el mensaje del sistema y las acciones que el usuario debe realizar.

Este parámetro puede contener texto y etiquetas HTML. La longitud máxima es de 512 caracteres (que incluye todo el texto y las etiquetas HTML).

Están disponibles las siguientes etiquetas HTML:

  • <B> y </B> (negrita)
  • <EM> y </EM> (cursiva)
  • <BR> (salto de línea)
  • <P> y </P> (párrafo)
  • <A HREF="url"> y </A> (hipervínculo). Nota: Debe usar comillas simples (no comillas dobles) alrededor de la cadena de texto completa si usa esta etiqueta. De lo contrario, se producirá un error (debido a las comillas dobles de la etiqueta).

Use los siguientes códigos de escape para estos caracteres especiales:

  • &lt; para <
  • &gt; para >
  • &quot; para "
  • &amp; por &

Este es un valor de ejemplo para este parámetro que usa etiquetas HTML y caracteres especiales:

'You tried to send a message to a <B>disabled</B> mailbox. Please visit <A HREF="https://it.contoso.com">Internal Support</A> or contact &quot;InfoSec&quot; for more information.'

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
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 Server SE

El modificador WhatIf muestra lo que hace el comando sin realizar ningún cambio. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio: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.