New-SCSMEmailTemplate

Reference

Modul:: System.Center.Service.Manager

Vytvoří šablonu e-mailu pro Service Manager.

Syntaxe

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

Rutina New-SCSMEmailTemplate vytvoří šablonu e-mailu pro Service Manager.

Příklady

Příklad 1: Vytvoření šablony e-mailu pro změnu tiskárny

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"
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

První příkaz získá třídu s názvem Microsoft.AD.Printer pomocí rutiny Get-SCSMClass a poté ji uloží do proměnné $PrinterClass.

Druhý příkaz vytvoří zprávu pro e-mail a uloží ji do proměnné $Message. V tomto příkladu je použit stejný řetězec jako předmět a tělo e-mailu.

Třetí příkaz získá sadu Management Pack, do které se tato šablona uloží pomocí rutiny Get-SCSMManagementPack, a pak ji uloží do proměnné $ManagementPack.

Čtvrtý a pátý příkaz ukládají hodnoty pro jazyk a kódování v proměnných $Language a $Encoding.

Závěrečný příkaz vytvoří šablonu e-mailu, která se použije, když dojde ke změně na tiskárně. Příkaz používá hodnoty, které byly vytvořeny v prvních pěti příkazech.

Příklad 2: Vytvoření dvou šablon používajících různé jazyky

PS C:\$BodyEng = @'
>> A change has occurred to the following configuration item: 
>> $Context/Property[Type='System!System.Entity']/DisplayName$ 
>> which is owned by: 
>> $Context/Path[Relationship='System!System.ComputerPrimaryUser'   TypeConstraint='Windows!Microsoft.AD.UserBase']/Property[Type='Windows!Microsoft.AD.UserBase']/DistinguishedName$
>> Please investigate
>> Thank you
>> '@
PS C:\> $BodyGer = @'
>>  Eine Konfigurations nderung erfolgte in
>>  $Context/Property[Type='System!System.Entity']/DisplayName$ 
>>  der im Registrierungscontainer
>>  $Context/Path[Relationship='System!System.ComputerPrimaryUser' TypeConstraint='Windows!Microsoft.AD.UserBase']/Property[Type='Windows!Microsoft.AD.UserBase']/DistinguishedName$
>>  gespeichert ist.
>>  Pr fen Sie bitte nach.
>>  Vielen Dank 
>>  '@
PS C:\> $Templates = @{ Body = $BodyEng; Subject = "Change notification"; Language = [globalization.cultureinfo]"en-us" },@{ Body = $BodyGer; Subject = "Benachrichtigungs-Email"; Language = [globalization.cultureinfo]"de-de" }
PS C:\> $ComputerClass = Get-SCSMClass -Name "Microsoft.Windows.Computer"
PS C:\> "WindowsChangeEmailTemplate" -TemplateCollection $Templates

První příkaz uloží text pro tělo e-mailu pro anglickou šablonu do proměnné $BodyEng.

Druhý příkaz uloží text pro tělo e-mailu pro německou šablonu do proměnné $BodyGer.

Třetí příkaz vytvoří šablony jako zatřiďovací tabulky, které obsahují $BodyEng a $BodyGer a další obsah. Tyto dvě šablony mají různé hodnoty vlastnosti Language .

Čtvrtý příkaz získá třídu s názvem Microsoft.Windows.Computer pomocí příkazu Get-SCSMClass a poté ji uloží do proměnné $ComputerClass.

Závěrečný příkaz vytvoří dvě šablony e-mailů, jednu v angličtině a jednu v němčině. Aktivují se, když dojde ke změně v počítači s operačním systémem Windows.

Parametry

-Body

Určuje text zprávy, který může obsahovat vkládací řetězce.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Class

Určuje název třídy, na kterou je šablona e-mailu zaměřena.

Typ:	ManagementPackClass
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ComputerName

Určuje název počítače, na kterém je spuštěna služba System Center Data Access. Uživatelský účet zadaný v parametru Credential musí mít přístupová práva k zadanému počítači.

Typ:	String[]
Position:	Named
Default value:	Localhost
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Credential

Určuje přihlašovací údaje, které tato rutina používá pro připojení k serveru, na kterém je spuštěna služba System Center Data Access. Zadaný uživatelský účet musí mít přístupová práva k danému serveru.

Typ:	PSCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Description

Určuje popis šablony e-mailu.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DisplayName

Určuje název šablony e-mailu.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Encoding

Určuje kódování, které se má použít ve zprávě.

Typ:	Encoding
Position:	Named
Default value:	Unicode (UTF-8)
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Language

Určuje jazyk zprávy.

Typ:	CultureInfo
Position:	Named
Default value:	English (United States)
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ManagementPack

Určuje název sady Management Pack, do které tato rutina ukládá šablonu e-mailu.

Typ:	ManagementPack
Position:	Named
Default value:	The default management pack
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PassThru

Označuje, že tato rutina vrací šablonu e-mailu, kterou vytvořila. Tento objekt můžete předat jiným rutinám.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SCSession

Určuje objekt, který představuje relaci na server pro správu Service Manager.

Typ:	Connection[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SendAsHtml

Určuje, že tato rutina způsobí, že e-mail bude odeslán jako HTML.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Subject

Určuje předmět e-mailové zprávy.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-TemplateCollection

Určuje kolekci zatřiďovacích tabulek, které představují šablonu e-mailu. Zatřiďovací tabulka musí mít následující klíče:

Tělo. Jedná se o řetězec, který představuje tělo šablony.
Předmět. Jedná se o řetězec, který představuje předmět e-mailu.
Jazyk. Musí to být typ CultureInfo. Představuje jazyk zprávy. Pokud zadáte více zatřiďovacích tabulek, nemůžete použít stejnou hodnotu pro Jazyk.

Typ:	Hashtable[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Urgency

Určuje naléhavost e-mailové zprávy. Platné hodnoty jsou:

Vysoko
Středně
Nízké

Typ:	EmailTemplateUrgency
Přípustné hodnoty:	Low, Medium, High
Position:	Named
Default value:	Medium
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

None.

Vstup do této rutiny nelze převést.

Výstupy