New-SCSMEmailTemplate
Vytvoří novou š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í e-mailové šablony 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-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
První příkaz získá třídu s názvem Microsoft.AD.Printer pomocí rutiny Get-SCSMClass a uloží ji do proměnné $PrinterClass.
Druhý příkaz vytvoří zprávu pro e-mail a uloží ji do proměnné $Message. Tento příklad používá stejný řetězec jako předmět a text e-mailu.
Třetí příkaz získá sadu Management Pack, do které se má tato šablona uložit pomocí rutiny Get-SCSMManagementPack a uloží ji do proměnné $ManagementPack.
Čtvrtý a pátý příkaz ukládá hodnoty pro jazyk a kódování v $Language a $Encoding proměnných.
Poslední příkaz vytvoří e-mailovou šablonu, která se použije při změně tiskárny. Příkaz používá hodnoty vytvořené v prvních pěti příkazech.
Parametry
-Body
Určuje text zprávy, který může obsahovat řetězce vložení.
Typ: | System.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 cílí šablona e-mailu.
Typ: | Microsoft.EnterpriseManagement.Configuration.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 běží 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: | System.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 rutiny vás vyzve k potvrzení.
Typ: | System.Management.Automation.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 běží služba System Center Data Access. Zadaný uživatelský účet musí mít přístupová práva k danému serveru.
Typ: | System.Management.Automation.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: | System.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: | System.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: | System.Text.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: | System.Globalization.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á e-mailovou šablonu.
Typ: | Microsoft.EnterpriseManagement.Configuration.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 vrátí e-mailovou šablonu, kterou vytvoří. Tento objekt můžete předat jiným rutinám.
Typ: | System.Management.Automation.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 se serverem pro správu portálu Service Manager.
Typ: | Microsoft.SystemCenter.Core.Connection.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í odeslání e-mailu jako HTML.
Typ: | System.Management.Automation.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: | System.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 tabulek hash, které představují e-mailovou šablonu. Tabulka hash 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. To musí být typu CultureInfo. Představuje jazyk zprávy. Pokud zadáte více hashovacích tabulek, nemůžete pro jazyk použít stejnou hodnotu.
Typ: | System.Collections.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: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.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 rutina spustí. Rutina se nespustí.
Typ: | System.Management.Automation.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
None.
Tato rutina negeneruje žádný výstup.