New-SCSMEmailTemplate
Erstellt eine neue E-Mail-Vorlage für Service Manager.
Syntax
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>] Beschreibung
Das Cmdlet New-SCSMEmailTemplate erstellt eine E-Mail-Vorlage für Service Manager.
Beispiele
Beispiel 1: Erstellen einer E-Mail-Vorlage für eine Änderung an einem Drucker
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 $MessageDer erste Befehl ruft mithilfe des Cmdlets Get-SCSMClass eine Klasse namens "Microsoft.AD.Printer" ab und speichert sie dann in der variablen $PrinterClass.
Der zweite Befehl erstellt eine Nachricht für die E-Mail und speichert sie in der variablen $Message. In diesem Beispiel wird dieselbe Zeichenfolge wie der Betreff und der Textkörper der E-Mail verwendet.
Der dritte Befehl ruft ein Management Pack ab, in dem diese Vorlage mithilfe des cmdlets Get-SCSMManagementPack gespeichert werden soll, und speichert sie dann in der variablen $ManagementPack.
Die vierten und fünften Befehle speichern Werte für Sprache und Codierung in den variablen $Language und $Encoding.
Der letzte Befehl erstellt eine E-Mail-Vorlage, die angewendet wird, wenn eine Änderung auf einen Drucker erfolgt. Der Befehl verwendet Werte, die in den ersten fünf Befehlen erstellt wurden.
Parameter
-Body
Gibt den Nachrichtentext an, der Einfügezeichenfolgen enthalten kann.
| Typ: | System.String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Class
Gibt den Namen der Klasse an, auf die die E-Mail-Vorlage ausgerichtet ist.
| Typ: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ComputerName
Gibt den Namen des Computers an, auf dem der System Center Data Access-Dienst ausgeführt wird. Das benutzerkonto, das im parameter Credential angegeben ist, muss über Zugriffsrechte für den angegebenen Computer verfügen.
| Typ: | System.String[] |
| Position: | Named |
| Standardwert: | Localhost |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | System.Management.Automation.SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Credential
Gibt die Anmeldeinformationen an, die dieses Cmdlet zum Herstellen einer Verbindung mit dem Server verwendet, auf dem der System Center Data Access-Dienst ausgeführt wird. Das angegebene Benutzerkonto muss über Zugriffsrechte für diesen Server verfügen.
| Typ: | System.Management.Automation.PSCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Description
Gibt eine Beschreibung für die E-Mail-Vorlage an.
| Typ: | System.String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisplayName
Gibt den Namen der E-Mail-Vorlage an.
| Typ: | System.String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Encoding
Gibt die Codierung an, die in der Nachricht verwendet werden soll.
| Typ: | System.Text.Encoding |
| Position: | Named |
| Standardwert: | Unicode (UTF-8) |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Language
Gibt die Sprache für die Nachricht an.
| Typ: | System.Globalization.CultureInfo |
| Position: | Named |
| Standardwert: | English (United States) |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ManagementPack
Gibt den Namen des Management Packs an, in dem dieses Cmdlet die E-Mail-Vorlage speichert.
| Typ: | Microsoft.EnterpriseManagement.Configuration.ManagementPack |
| Position: | Named |
| Standardwert: | The default management pack |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PassThru
Gibt an, dass dieses Cmdlet die von ihr erstellten E-Mail-Vorlage zurückgibt. Sie können dieses Objekt an andere Cmdlets übergeben.
| Typ: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SCSession
Gibt ein Objekt an, das die Sitzung auf einem Dienst-Manager-Verwaltungsserver darstellt.
| Typ: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SendAsHtml
Gibt an, dass dieses Cmdlet bewirkt, dass die E-Mail als HTML gesendet wird.
| Typ: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Subject
Gibt den Betreff für die E-Mail-Nachricht an.
| Typ: | System.String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-TemplateCollection
Gibt eine Auflistung von Hashtabellen an, die die E-Mail-Vorlage darstellen. Die Hashtabelle muss über die folgenden Schlüssel verfügen:
- Körper. Dies ist eine Zeichenfolge, die den Textkörper der Vorlage darstellt.
- Betreff. Dies ist eine Zeichenfolge, die den Betreff der E-Mail darstellt.
- Sprache. Dies muss vom Typ CultureInfo-sein. Sie stellt die Sprache für die Nachricht dar. Wenn Sie mehrere Hashtabellen angeben, können Sie nicht denselben Wert für Sprache verwenden.
| Typ: | System.Collections.Hashtable[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Urgency
Gibt die Dringlichkeit der E-Mail-Nachricht an. Gültige Werte sind:
- Hoch
- Mittel
- Niedrig
| Typ: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.EmailTemplateUrgency |
| Zulässige Werte: | Low, Medium, High |
| Position: | Named |
| Standardwert: | Medium |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | System.Management.Automation.SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
None.
Sie können keine Eingabe an dieses Cmdlet weiterleiten.
Ausgaben
None.
Dieses Cmdlet generiert keine Ausgabe.