Udostępnij za pośrednictwem

New-SCSMEmailTemplate

Moduł:
System.Center.Service.Manager Module

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

Składnia

Default (Domyślna) 

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.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Class

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

Właściwości parametru

Typ:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:

System.String[]

Domyślna wartość:Localhost
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Właściwości parametru

Typ:System.Management.Automation.SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:System.Management.Automation.PSCredential
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Description

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

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DisplayName

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

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Encoding

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

Właściwości parametru

Typ:System.Text.Encoding
Domyślna wartość:Unicode (UTF-8)
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Language

Określa język komunikatu.

Właściwości parametru

Typ:System.Globalization.CultureInfo
Domyślna wartość:English (United States)
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ManagementPack

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

Właściwości parametru

Typ:Microsoft.EnterpriseManagement.Configuration.ManagementPack
Domyślna wartość:The default management pack
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PassThru

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

Właściwości parametru

Typ:System.Management.Automation.SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SCSession

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

Właściwości parametru

Typ:

Microsoft.SystemCenter.Core.Connection.Connection[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SendAsHtml

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

Właściwości parametru

Typ:System.Management.Automation.SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Subject

Określa temat wiadomości e-mail.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:

System.Collections.Hashtable[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Urgency

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

  • Wysoki
  • Średni
  • Niski

Właściwości parametru

Typ:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.EmailTemplateUrgency
Domyślna wartość:Medium
Dopuszczalne wartości:Low, Medium, High
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

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

Właściwości parametru

Typ:System.Management.Automation.SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

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.