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>] Description
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
指定訊息本文，其中包含插入字串。
| 類型: | System.String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Class
指定電子郵件範本目標類別的名稱。
| 類型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ComputerName
指定 System Center 資料存取服務執行所在的電腦名稱。 Credential 參數中指定的使用者帳戶必須具有指定計算機的訪問許可權。
| 類型: | System.String[] |
| Position: | Named |
| 預設值: | Localhost |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
| 類型: | System.Management.Automation.SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Credential
指定此 Cmdlet 用來連線到 System Center 資料存取服務執行所在的伺服器認證。 指定的使用者帳戶必須具有該伺服器的訪問許可權。
| 類型: | System.Management.Automation.PSCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Description
指定電子郵件範本的描述。
| 類型: | System.String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisplayName
指定電子郵件範本的名稱。
| 類型: | System.String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Encoding
指定要在訊息中使用的編碼方式。
| 類型: | System.Text.Encoding |
| Position: | Named |
| 預設值: | Unicode (UTF-8) |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Language
指定訊息的語言。
| 類型: | System.Globalization.CultureInfo |
| Position: | Named |
| 預設值: | English (United States) |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ManagementPack
指定此 Cmdlet 儲存電子郵件範本的管理元件名稱。
| 類型: | Microsoft.EnterpriseManagement.Configuration.ManagementPack |
| Position: | Named |
| 預設值: | The default management pack |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PassThru
指出此 Cmdlet 會傳回它建立的電子郵件範本。 您可以將這個物件傳遞至其他 Cmdlet。
| 類型: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SCSession
指定物件，表示 Service Manager 管理伺服器的會話。
| 類型: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SendAsHtml
指定此 Cmdlet 會使電子郵件以 HTML 傳送。
| 類型: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Subject
指定電子郵件訊息的主旨。
| 類型: | System.String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-TemplateCollection
指定代表電子郵件範本的哈希表集合。 哈希表必須具有下列索引鍵：
- 身體。 這是代表範本主體的字串。
- 主題。 這是代表電子郵件主旨的字串。
- 語言。 這必須是 CultureInfo類型。 它代表訊息的語言。 如果您指定多個哈希表，就無法對 Language 使用相同的值。
| 類型: | System.Collections.Hashtable[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Urgency
指定電子郵件訊息的緊迫性。 有效值為：
- 高
- 中等
- 低
| 類型: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.EmailTemplateUrgency |
| 接受的值: | Low, Medium, High |
| Position: | Named |
| 預設值: | Medium |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
| 類型: | System.Management.Automation.SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None.
您無法使用管線將輸入傳送至此 Cmdlet。
輸出
None.
此 Cmdlet 不會產生任何輸出。