New-SCSMEmailTemplate
Crea una nueva plantilla de correo electrónico para Service Manager.
Sintaxis
New-SCSMEmailTemplate
[-Body <String>]
[-Subject <String>]
[-Language <CultureInfo>]
[-TemplateCollection <Hashtable[]>]
[-Encoding <Encoding>]
-Class <ManagementPackClass>
[-Description <String>]
[-ManagementPack <ManagementPack>]
-DisplayName <String>
[-SendAsHtml]
[-Urgency <EmailTemplateUrgency>]
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet
Ejemplos
Ejemplo 1: Crear una plantilla de correo electrónico para un cambio en una impresora
PS C:\>$PrinterClass = Get-SCSMClass -Name "Microsoft.AD.Printer"
PS C:\> $Message = 'Printer $Context/Property[''Type=Windows!Microsoft.AD.Printer'']/PrinterName$ has been updated'
PS C:\> $ManagementPack = Get-SCSMManagementPack -Name "ServiceManager.ConfigurationManagement.Configuration"
PS C:\> $Language = [System.Globalization.CultureInfo]"en-US"
PS C:\> $Encoding = [System.Text.Encoding]::ASCII
PS C:\> New-SCSMEmailTemplate -Class $PrinterClass -DisplayName "Printer Email Template" -Body $Message -Description "A template for printer notifications" -Encoding $Encoding -Language $Language -ManagementPack $ManagementPack -Subject $Message
El primer comando obtiene una clase denominada Microsoft.AD.Printer mediante el cmdlet Get-SCSMClass y, a continuación, la almacena en la variable $PrinterClass.
El segundo comando crea un mensaje para el correo electrónico y lo almacena en la variable $Message. En este ejemplo se usa la misma cadena que el asunto y el cuerpo del correo electrónico.
El tercer comando obtiene un módulo de administración en el que guardar esta plantilla mediante el cmdlet Get-SCSMManagementPack y, a continuación, lo almacena en la variable $ManagementPack.
Los comandos cuarto y quinto almacenan valores para el lenguaje y la codificación en las variables $Language y $Encoding.
El comando final crea una plantilla de correo electrónico que se aplica cuando se produce un cambio en una impresora. El comando usa valores creados en los cinco primeros comandos.
Parámetros
-Body
Especifica el cuerpo del mensaje, que puede incluir cadenas de inserción.
Tipo: | System.String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Class
Especifica el nombre de la clase a la que se dirige la plantilla de correo electrónico.
Tipo: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ComputerName
Especifica el nombre del equipo en el que se ejecuta el servicio de acceso a datos de System Center.
La cuenta de usuario especificada en el parámetro credential
Tipo: | System.String[] |
Posición: | Named |
Valor predeterminado: | Localhost |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Tipo: | System.Management.Automation.SwitchParameter |
Alias: | cf |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Credential
Especifica las credenciales que usa este cmdlet para conectarse al servidor en el que se ejecuta el servicio de acceso a datos de System Center. La cuenta de usuario especificada debe tener derechos de acceso a ese servidor.
Tipo: | System.Management.Automation.PSCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Description
Especifica una descripción de la plantilla de correo electrónico.
Tipo: | System.String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DisplayName
Especifica el nombre de la plantilla de correo electrónico.
Tipo: | System.String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Encoding
Especifica la codificación que se va a usar en el mensaje.
Tipo: | System.Text.Encoding |
Posición: | Named |
Valor predeterminado: | Unicode (UTF-8) |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Language
Especifica el idioma del mensaje.
Tipo: | System.Globalization.CultureInfo |
Posición: | Named |
Valor predeterminado: | English (United States) |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ManagementPack
Especifica el nombre del módulo de administración en el que este cmdlet almacena la plantilla de correo electrónico.
Tipo: | Microsoft.EnterpriseManagement.Configuration.ManagementPack |
Posición: | Named |
Valor predeterminado: | The default management pack |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PassThru
Indica que este cmdlet devuelve la plantilla de correo electrónico que crea. Puede pasar este objeto a otros cmdlets.
Tipo: | System.Management.Automation.SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SCSession
Especifica un objeto que representa la sesión en un servidor de administración de Service Manager.
Tipo: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SendAsHtml
Especifica que este cmdlet hace que el correo electrónico se envíe como HTML.
Tipo: | System.Management.Automation.SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Subject
Especifica el asunto del mensaje de correo electrónico.
Tipo: | System.String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-TemplateCollection
Especifica una colección de tablas hash que representan la plantilla de correo electrónico. La tabla hash debe tener las siguientes claves:
- Cuerpo. Se trata de una cadena que representa el cuerpo de la plantilla.
- Asunto. Se trata de una cadena que representa el asunto del correo electrónico.
- Idioma. Debe ser de tipo CultureInfo. Representa el idioma del mensaje. Si especifica varias tablas hash, no puede usar el mismo valor para Language.
Tipo: | System.Collections.Hashtable[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Urgency
Especifica la urgencia del mensaje de correo electrónico. Los valores válidos son:
- Alto
- Medio
- Bajo
Tipo: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.EmailTemplateUrgency |
Valores aceptados: | Low, Medium, High |
Posición: | Named |
Valor predeterminado: | Medium |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Tipo: | System.Management.Automation.SwitchParameter |
Alias: | wi |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Entradas
None.
No se puede canalizar la entrada a este cmdlet.
Salidas
None.
Este cmdlet no genera ninguna salida.