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

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

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 データ アクセス サービスが実行しているコンピューターの名前を指定します。 Credential パラメーターで指定されたユーザー アカウントには、指定されたコンピューターへのアクセス権が必要です。

Type:System.String[]
Position:Named
Default value:Localhost
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:System.Management.Automation.SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

このコマンドレットが 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

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

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPack
Position:Named
Default value:The default management pack
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

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

このコマンドレットによって電子メールが 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

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

  • Medium
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

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:System.Management.Automation.SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

None.

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

出力

None.

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