Compartir a través de

New-SystemMessage

Módulo:
Exchange PowerShell

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

Use el cmdlet New-SystemMessage para crear mensajes del sistema personalizados. 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

Dsn 

New-SystemMessage
    -DsnCode <EnhancedStatusCode>
    -Internal <Boolean>
    -Language <CultureInfo>
    -Text <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-WhatIf]
    [<CommonParameters>]

Quota 

New-SystemMessage
    -Language <CultureInfo>
    -QuotaMessageType <QuotaMessageType>
    -Text <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-WhatIf]
    [<CommonParameters>]

Description

Los NDR se emiten a los remitentes de mensajes de correo electrónico que no han llegado a sus destinatarios previstos. Los mensajes de cuotas se envían a los usuarios cuyos buzones o carpetas públicas han alcanzado las cuotas de advertencia, envío prohibido o recepción prohibida. Los NDR personalizados y los mensajes de cuota reemplazan los mensajes predeterminados que se incluyen con Exchange.

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-SystemMessage -DsnCode 5.3.5 -Language en -Internal $false -Text "The recipient email system can't process this email message. Please contact your system administrator for more information."

En este ejemplo se crea un NDR en inglés personalizado para el código de estado mejorado 5.3.5 para remitentes externos.

Ejemplo 2

New-SystemMessage -QuotaMessageType WarningMailbox -Language en -Text "Your mailbox has exceeded the warning limit specified by your email administrator. Please reduce the size of your mailbox."

En este ejemplo se crea un mensaje de cuota en inglés personalizado para los buzones que superan su cuota de advertencia de problema.

Parámetros

-Confirm

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

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

-DomainController

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

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

-DsnCode

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

El parámetro DsnCode especifica el código de estado mejorado para el mensaje del sistema personalizado.

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. Puede especificar un código predeterminado que se incluya con Exchange o puede especificar un código personalizado.

Para generar una lista de códigos de estado mejorados predeterminados que usa 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".

Debe usar este parámetro con los parámetros Language e Internal.

No se puede usar este parámetro con el parámetro QuotaMessageType.

Propiedades del parámetro

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

Conjuntos de parámetros

Dsn
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

-Internal

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

El parámetro Internal especifica si el mensaje del sistema se muestra a usuarios internos o externos. Los valores admitidos son:

  • $true: el NDR se muestra a los remitentes internos.
  • $false: el NDR se muestra a los remitentes externos.

Debe usar este parámetro con los parámetros DsnCode y Language.

No se puede usar este parámetro con el parámetro QuotaMessageType.

Propiedades del parámetro

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

Conjuntos de parámetros

Dsn
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

-Language

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

El parámetro Language especifica el idioma del mensaje (por ejemplo, en para inglés o ja para japonés). Para obtener la lista de códigos de idioma admitidos, consulte Idiomas admitidos para NDR.

Debe usar este parámetro con los parámetros DsnCode o QuotaMessageType.

Propiedades del parámetro

Tipo:CultureInfo
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

-QuotaMessageType

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

El parámetro QuotaMessageType especifica la cuota para el mensaje del sistema personalizado. Los valores admitidos 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 ProhibitSendReceiveQuota.
  • ProhibitSendReceiveMailBox: un buzón supera su límite ProhibitSendReceiveQuota.
  • WarningMailbox: un buzón supera su límite IssueWarningQuota cuando tiene un límite ProhibitSendQuota o ProhibitSendReceiveQuota configurado.
  • 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 configurado un límite ProhibitPostQuota.
  • 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 su límite MailboxMessagesPerFolderCountWarningQuota cuando tiene configurado un límite 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 FolderHierarchyChildrenCountWarningQuota cuando tiene configurado un límite FolderHierarchyChildrenCountReceiveQuota.
  • WarningFolderHierarchyChildrenCount: un buzón supera su límite FolderHierarchyChildrenCountWarningQuota cuando tiene un límite FolderHierarchyChildrenCountReceiveQuota configurado.
  • ProhibitReceiveFoldersCount: un buzón supera su límite FoldersCountReceiveQuota.
  • WarningFoldersCount: un buzón supera su límite FoldersCountWarningQuota cuando tiene configurado un límite FoldersCountReceiveQuota.
  • WarningFoldersCountUnlimited Un buzón supera su límite FoldersCountWarningQuota cuando no tiene configurado un límite FoldersCountReceiveQuota.

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 su límite FolderHierarchyDepthWarningQuota cuando tiene configurado un límite FolderHierarchyDepthReceiveQuota.
  • WarningFolderHierarchyDepth: un buzón supera su límite FolderHierarchyDepthWarningQuota cuando tiene un límite FolderHierarchyDepthReceiveQuota configurado.

Debe usar este parámetro con el parámetro Language.

No se puede usar este parámetro con los parámetros DsnCode o Internal.

Propiedades del parámetro

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

Conjuntos de parámetros

Quota
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

-Text

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

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

Debe usar este parámetro con los parámetros DsnCode o QuotaMessageType.

Este parámetro puede contener etiquetas HTML y de texto. 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: Si usa esta etiqueta, debe usar comillas simples (no comillas dobles) alrededor de la cadena de texto completa. De lo contrario, obtendrá un error (debido a las comillas dobles en la etiqueta).

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

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

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 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

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.