New-SCSMEmailTemplate
Crée un modèle de messagerie pour 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
L’applet de commande New-SCSMEmailTemplate crée un modèle d’e-mail pour Service Manager.
Exemples
Exemple 1 : Créer un modèle d’e-mail pour une modification d’une imprimante
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 $MessageLa première commande obtient une classe nommée Microsoft.AD.Printer à l’aide de l’applet de commande Get-SCSMClass, puis la stocke dans la variable $PrinterClass.
La deuxième commande crée un message pour l’e-mail et le stocke dans la variable $Message. Cet exemple utilise la même chaîne que l’objet et le corps de l’e-mail.
La troisième commande obtient un pack d’administration dans lequel enregistrer ce modèle à l’aide de l’applet de commande Get-SCSMManagementPack, puis le stocke dans la variable $ManagementPack.
Les quatrième et cinquième commandes stockent les valeurs de langue et d’encodage dans les variables $Language et $Encoding.
La dernière commande crée un modèle d’e-mail qui s’applique lorsqu’une modification est apportée à une imprimante. La commande utilise les valeurs qui ont été créées dans les cinq premières commandes.
Paramètres
-Body
Spécifie le corps du message, qui peut inclure des chaînes d’insertion.
| Type: | System.String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Class
Spécifie le nom de la classe ciblée par le modèle d’e-mail.
| Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ComputerName
Spécifie le nom de l’ordinateur sur lequel le service System Center Data Access s’exécute. Le compte d’utilisateur spécifié dans le paramètre Informations d’identification doit disposer de droits d’accès à l’ordinateur spécifié.
| Type: | System.String[] |
| Position: | Named |
| Valeur par défaut: | Localhost |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
| Type: | System.Management.Automation.SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Credential
Spécifie les informations d’identification que cette applet de commande utilise pour se connecter au serveur sur lequel le service System Center Data Access s’exécute. Le compte d’utilisateur spécifié doit disposer des droits d’accès à ce serveur.
| Type: | System.Management.Automation.PSCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Description
Spécifie une description pour le modèle d’e-mail.
| Type: | System.String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DisplayName
Spécifie le nom du modèle d’e-mail.
| Type: | System.String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Encoding
Spécifie l’encodage à utiliser dans le message.
| Type: | System.Text.Encoding |
| Position: | Named |
| Valeur par défaut: | Unicode (UTF-8) |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Language
Spécifie la langue du message.
| Type: | System.Globalization.CultureInfo |
| Position: | Named |
| Valeur par défaut: | English (United States) |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ManagementPack
Spécifie le nom du pack d’administration dans lequel cette applet de commande stocke le modèle d’e-mail.
| Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPack |
| Position: | Named |
| Valeur par défaut: | The default management pack |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PassThru
Indique que cette applet de commande retourne le modèle d’e-mail qu’elle a créé. Vous pouvez passer cet objet à d’autres applets de commande.
| Type: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SCSession
Spécifie un objet qui représente la session auprès d’un serveur de gestion Service Manager.
| Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SendAsHtml
Spécifie que cette applet de commande entraîne l’envoi de l’e-mail au format HTML.
| Type: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Subject
Spécifie l’objet de l’e-mail.
| Type: | System.String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-TemplateCollection
Spécifie une collection de tables de hachage qui représentent le modèle d’e-mail. La table de hachage doit avoir les clés suivantes :
- Corps. Il s’agit d’une chaîne qui représente le corps du modèle.
- Objet. Il s’agit d’une chaîne qui représente l’objet de l’e-mail.
- Langue. Il doit être de type CultureInfo. Il représente la langue du message. Si vous spécifiez plusieurs tables de hachage, vous ne pouvez pas utiliser la même valeur pour Language.
| Type: | System.Collections.Hashtable[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Urgency
Spécifie l’urgence du message électronique. Les valeurs valides sont les suivantes :
- Élevé
- Moyenne
- Bas
| Type: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.EmailTemplateUrgency |
| Valeurs acceptées: | Low, Medium, High |
| Position: | Named |
| Valeur par défaut: | Medium |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
| Type: | System.Management.Automation.SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
None.
Vous ne pouvez pas diriger l’entrée vers cette applet de commande.
Sorties
None.
Cette applet de commande ne génère aucune sortie.