New-SCSMEmailTemplate
为 Service Manager 创建新电子邮件模板。
语法
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>]
说明
New-SCSMEmailTemplate cmdlet 为Service Manager创建电子邮件模板。
示例
示例 1:为更改打印机创建电子邮件模板
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
第一个命令使用 Get-SCSMClass cmdlet 获取名为 Microsoft.AD.Printer 的类,然后将其存储在 $PrinterClass 变量中。
第二个命令为电子邮件创建一条消息,并将其存储在 $Message 变量中。 此示例使用与电子邮件的主题和正文相同的字符串。
第三个命令获取使用 Get-SCSMManagementPack cmdlet 保存此模板的管理包,然后将其存储在 $ManagementPack 变量中。
第四个和第五个命令将语言和编码的值存储在$Language和$Encoding变量中。
最后一个命令创建一个电子邮件模板,该模板在打印机发生更改时应用。 命令使用在前五个命令中创建的值。
参数
-Body
指定消息正文,可以包含插入字符串。
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Class
指定电子邮件模板面向的类的名称。
Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
指定运行 System Center Data Access 服务的计算机的名称。 Credential 参数中指定的用户帐户必须具有对指定计算机的访问权限。
Type: | System.String[] |
Position: | Named |
Default value: | Localhost |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
指定此 cmdlet 用于连接到运行 System Center Data Access 服务的服务器的凭据。 指定用户帐户必须具有对该服务器的访问权限。
Type: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
指定电子邮件模板的说明。
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
指定电子邮件模板的名称。
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encoding
指定要在邮件中使用的编码。
Type: | System.Text.Encoding |
Position: | Named |
Default value: | Unicode (UTF-8) |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Language
为邮件指定语言。
Type: | System.Globalization.CultureInfo |
Position: | Named |
Default value: | English (United States) |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ManagementPack
指定此 cmdlet 存储电子邮件模板的管理包的名称。
Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPack |
Position: | Named |
Default value: | The default management pack |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
指示此 cmdlet 返回它创建的电子邮件模板。 可以将此对象传递给其他 cmdlet。
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SCSession
指定表示与 Service Manager 管理服务器的会话的对象。
Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendAsHtml
指定此 cmdlet 导致电子邮件以 HTML 形式发送。
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Subject
指定电子邮件的主题。
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemplateCollection
指定表示电子邮件模板的哈希表的集合。 哈希表必须具有以下键:
- 正文。 这是一个表示模板正文的字符串。
- 主题。 这是一个表示电子邮件主题的字符串。
- 语言: 这必须属于 CultureInfo 类型。 它表示消息的语言。 如果指定多个哈希表,则不能对 Language 使用相同的值。
Type: | System.Collections.Hashtable[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Urgency
指定电子邮件的紧急性。 有效值为:
- 高
- 中等
- 低
Type: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.EmailTemplateUrgency |
Accepted values: | Low, Medium, High |
Position: | Named |
Default value: | Medium |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
Type: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
None.
不能通过管道将输入传递给此 cmdlet。
输出
None.
此 cmdlet 将不生成任何输出。