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 将不生成任何输出。