New-SystemMessage
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.
Syntax
New-SystemMessage
-DsnCode <EnhancedStatusCode>
-Internal <Boolean>
-Language <CultureInfo>
-Text <String>
[-Confirm]
[-DomainController <Fqdn>]
[-WhatIf]
[<CommonParameters>] 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 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-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
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 |
-DomainController
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 |
-DsnCode
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.
| Type: | EnhancedStatusCode |
| 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 |
-Internal
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.
| Type: | Boolean |
| 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 |
-Language
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.
| 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 |
-QuotaMessageType
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 el 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.
| Type: | QuotaMessageType |
| 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 |
-Text
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, recibirá un error (debido a las comillas dobles de la etiqueta).
Use los siguientes códigos de escape para estos caracteres especiales:
<Para <>Para >"para "&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 "InfoSec" for more information.'
| 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 |
-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 |
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.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de