Udostępnij za pośrednictwem

New-SCSMEmailTemplate

  • Odwołanie
Moduł:
System.Center.Service.Manager

Tworzy nowy szablon wiadomości e-mail dla programu Service Manager.

Składnia

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

Opis

Polecenie cmdlet New-SCSMEmailTemplate tworzy szablon wiadomości e-mail dla programu Service Manager.

Przykłady

Przykład 1. Tworzenie szablonu wiadomości e-mail dla zmiany drukarki

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

Pierwsze polecenie pobiera klasę o nazwie Microsoft.AD.Printer przy użyciu polecenia cmdlet Get-SCSMClass, a następnie zapisuje ją w zmiennej $PrinterClass.

Drugie polecenie tworzy wiadomość dla wiadomości e-mail i zapisuje ją w zmiennej $Message. W tym przykładzie użyto tego samego ciągu co temat i treść wiadomości e-mail.

Trzecie polecenie pobiera pakiet administracyjny, w którym można zapisać ten szablon przy użyciu polecenia cmdlet Get-SCSMManagementPack, a następnie zapisuje go w zmiennej $ManagementPack.

Czwarte i piąte polecenia przechowują wartości języka i kodowania w zmiennych $Language i $Encoding.

Ostatnie polecenie tworzy szablon wiadomości e-mail, który ma zastosowanie w przypadku zmiany drukarki. Polecenie używa wartości utworzonych w pierwszych pięciu poleceniach.

Parametry

-Body

Określa treść komunikatu, która może zawierać ciągi wstawiania.

Typ:System.String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Class

Określa nazwę klasy docelowej szablonu wiadomości e-mail.

Typ:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ComputerName

Określa nazwę komputera, na którym działa usługa System Center Data Access. Konto użytkownika określone w parametrze Credential musi mieć prawa dostępu do określonego komputera.

Typ:System.String[]
Position:Named
Domyślna wartość:Localhost
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:System.Management.Automation.SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Credential

Określa poświadczenia używane przez to polecenie cmdlet do nawiązywania połączenia z serwerem, na którym działa usługa System Center Data Access. Określone konto użytkownika musi mieć prawa dostępu do tego serwera.

Typ:System.Management.Automation.PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Description

Określa opis szablonu wiadomości e-mail.

Typ:System.String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DisplayName

Określa nazwę szablonu wiadomości e-mail.

Typ:System.String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Encoding

Określa kodowanie, które ma być używane w komunikacie.

Typ:System.Text.Encoding
Position:Named
Domyślna wartość:Unicode (UTF-8)
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Language

Określa język komunikatu.

Typ:System.Globalization.CultureInfo
Position:Named
Domyślna wartość:English (United States)
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ManagementPack

Określa nazwę pakietu administracyjnego, w którym to polecenie cmdlet przechowuje szablon wiadomości e-mail.

Typ:Microsoft.EnterpriseManagement.Configuration.ManagementPack
Position:Named
Domyślna wartość:The default management pack
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PassThru

Wskazuje, że to polecenie cmdlet zwraca utworzony szablon wiadomości e-mail. Ten obiekt można przekazać do innych poleceń cmdlet.

Typ:System.Management.Automation.SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SCSession

Określa obiekt reprezentujący sesję na serwerze zarządzania programu Service Manager.

Typ:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SendAsHtml

Określa, że to polecenie cmdlet powoduje wysłanie wiadomości e-mail jako HTML.

Typ:System.Management.Automation.SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Subject

Określa temat wiadomości e-mail.

Typ:System.String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TemplateCollection

Określa kolekcję tabel skrótów reprezentujących szablon wiadomości e-mail. Tabela skrótów musi mieć następujące klucze:

  • Ciało. Jest to ciąg reprezentujący treść szablonu.
  • Temat. Jest to ciąg reprezentujący temat wiadomości e-mail.
  • Język. Musi to być typ CultureInfo. Reprezentuje język komunikatu. Jeśli określisz wiele tabel skrótów, nie można użyć tej samej wartości dla języka.
Typ:System.Collections.Hashtable[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Urgency

Określa pilność wiadomości e-mail. Prawidłowe wartości to:

  • Wysoki
  • Średni
  • Niski
Typ:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.EmailTemplateUrgency
Dopuszczalne wartości:Low, Medium, High
Position:Named
Domyślna wartość:Medium
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:System.Management.Automation.SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None.

Nie można przekazać danych wejściowych potoku do tego polecenia cmdlet.

Dane wyjściowe

None.

To polecenie cmdlet nie generuje żadnych danych wyjściowych.