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 コマンドレットは、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 コマンドレットを使用して Microsoft.AD.Printer という名前のクラスを取得し、$PrinterClass変数に格納します。

2 番目のコマンドは、電子メールのメッセージを作成し、$Message変数に格納します。 この例では、電子メールの件名と本文と同じ文字列を使用します。

3 番目のコマンドは、Get-SCSMManagementPack コマンドレットを使用してこのテンプレートを保存する管理パックを取得し、$ManagementPack変数に格納します。

4 番目と 5 番目のコマンドは、言語とエンコードの値を$Language変数と$Encoding変数に格納します。

最後のコマンドは、プリンターに変更が発生したときに適用される電子メール テンプレートを作成します。 このコマンドは、最初の 5 つのコマンドで作成された値を使用します。

パラメーター

-Body

挿入文字列を含めることができるメッセージ本文を指定します。

型:System.String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Class

電子メール テンプレートが対象とするクラスの名前を指定します。

型:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ComputerName

System Center Data Access サービスを実行するコンピューターの名前を指定します。 Credential パラメーターで指定されたユーザー アカウントには、指定したコンピューターへのアクセス権が必要です。

型:System.String[]
配置:Named
規定値:Localhost
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:System.Management.Automation.SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Credential

このコマンドレットが System Center Data Access サービスを実行するサーバーへの接続に使用する資格情報を指定します。 指定されたユーザー アカウントには、そのサーバーへのアクセス権が必要です。

型:System.Management.Automation.PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Description

電子メール テンプレートの説明を指定します。

型:System.String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisplayName

電子メール テンプレートの名前を指定します。

型:System.String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Encoding

メッセージで使用するエンコードを指定します。

型:System.Text.Encoding
配置:Named
規定値:Unicode (UTF-8)
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Language

メッセージの言語を指定します。

型:System.Globalization.CultureInfo
配置:Named
規定値:English (United States)
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ManagementPack

このコマンドレットが電子メール テンプレートを格納する管理パックの名前を指定します。

型:Microsoft.EnterpriseManagement.Configuration.ManagementPack
配置:Named
規定値:The default management pack
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PassThru

このコマンドレットは、作成した電子メール テンプレートを返します。 このオブジェクトは、他のコマンドレットに渡すことができます。

型:System.Management.Automation.SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SCSession

Service Manager 管理サーバーへのセッションを表すオブジェクトを指定します。

型:Microsoft.SystemCenter.Core.Connection.Connection[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SendAsHtml

このコマンドレットによって電子メールが HTML として送信されるように指定します。

型:System.Management.Automation.SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Subject

電子メール メッセージの件名を指定します。

型:System.String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TemplateCollection

電子メール テンプレートを表すハッシュ テーブルのコレクションを指定します。 ハッシュ テーブルには、次のキーが必要です。

  • 体。 これは、テンプレートの本文を表す文字列です。
  • 件名。 これは、メールの件名を表す文字列です。
  • 言語。 これは、CultureInfo型である必要があります。 メッセージの言語を表します。 複数のハッシュ テーブルを指定した場合、Language に同じ値を使用することはできません。
型:System.Collections.Hashtable[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Urgency

電子メール メッセージの緊急性を指定します。 有効な値は次のとおりです。

  • 高い
  • 中程度
  • 低い
型:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.EmailTemplateUrgency
指定可能な値:Low, Medium, High
配置:Named
規定値:Medium
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:System.Management.Automation.SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None.

このコマンドレットに入力をパイプすることはできません。

出力

None.

このコマンドレットは出力を生成しません。