New-SCSMSubscription
Crée un abonnement dans Service Manager.
New-SCSMSubscription
-Class <ManagementPackClass>
[-Condition <Condition>]
[-Description <String>]
[-Criteria <String>]
[-GroupQueue <String[]>]
[-ManagementPack <ManagementPack>]
-DisplayName <String>
-Recipient <EnterpriseManagementObject[]>
-Template <EmailTemplate>
[-PassThru]
[-Enable <Boolean>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
La cmdlet New-SCSMSubscription crée un abonnement dans Service Manager.
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"
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
PS C:\> $PrinterTemplate = Get-SCSMEmailTemplate -DisplayName "Printer Email Template"
PS C:\> $UserClass = Get-SCSMClass -Name "Microsoft.AD.User"
PS C:\> $Recipient = Get-SCSMClassInstance -Class $UserClass -Filter 'UserName -like "%Administrator"'
PS C:\> New-SCSMSubscription -Class $PrinterClass -DisplayName "Printer update subscription" -Recipient $Recipient -Template $PrinterTemplate -Condition Updated
La 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 des valeurs pour la langue et l’encodage dans les variables $Language et $Encoding.
La sixième commande crée un modèle d’e-mail qui s’applique lorsqu’une modification se produit sur une imprimante. La commande utilise des valeurs qui ont été créées dans les cinq premières commandes.
La septième commande obtient le modèle d’e-mail nommé Printer Email Template à l’aide de l’applet de commande Get-SCSMEmailTemplate, puis le stocke dans la variable $PrinterTemplate.
La huitième commande obtient la classe nommée Microsoft.AD.User à l’aide de Get-SCSMClass, puis la stocke dans la variable $UserClass.
La neuvième commande obtient une instance de la classe dans $UserClass qui a un nom qui correspond à un filtre spécifié à l’aide de l’applet de commande Get-SCSMClassInstance. La commande stocke cette instance dans la variable $Recipient.
La commande finale crée un abonnement qui utilise le modèle de messagerie, créé précédemment dans l’exemple, qui envoie un e-mail à l’administrateur chaque fois qu’une imprimante est mise à jour.
PS C:\>$Criteria = @'
>> <Criteria>
>> <Expression>
>> <SimpleExpression>
>> <ValueExpression>
>> <Property State="Pre">$Context/Property[Type='Windows!Microsoft.AD.Printer']/Location$</Property>
>> </ValueExpression>
>> <Operator>NotEqual</Operator>
>> <ValueExpression>
>> <Property State="Post">$Context/Property[Type='Windows!Microsoft.AD.Printer']/Location$</Property>
>> </ValueExpression>
>> </SimpleExpression>
>> </Expression>
>> </Criteria>
>> @'
PS C:\> $Recipient = Get-SCSMClassInstance -DisplayName "System.User" -Filter "Name -like 'domain admins'"
PS C:\> $Class = Get-SCSMClass -Displayname "Microsoft.AD.Printer"
PS C:\> $Template = Get-SCSMEmailTemplate -Displayname "StandardEmailTemplate"
PS C:\> New-SCSMSubscription -Class <ManagementPackClass> -DisplayName "A printer subscription" -Recipient $Recipient -Template $Template -Condition Updated -Criteria $Criteria -Description "Changes in the printer location will cause email to be sent"
La première commande crée un critère pour l’abonnement et la stocke dans la variable $Criteria.
La deuxième commande obtient une instance de classe pour la classe nommée System.User qui a un nom qui correspond à un filtre spécifié à l’aide de l’applet de commande Get-SCSMClassInstance. La commande stocke cette instance dans la variable $Recipient.
La troisième commande obtient la classe nommée Microsoft.AD.Printer à l’aide de Get-SCSMClass, puis la stocke dans la variable $Class.
La quatrième commande obtient le modèle de messagerie nommé StandardEmailTemplate à l’aide de Get-SCSMEmailTemplate, puis la stocke dans la variable $Template.
La commande finale crée un abonnement de notification par e-mail configuré pour envoyer un e-mail aux administrateurs de domaine.
L’abonnement est basé sur les modifications apportées à la classe d’imprimante
Spécifie le nom de la classe cible par l’abonnement. Le nom spécifié doit référencer la même classe que celle référencée par le modèle de messagerie spécifié.
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 |
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 Credential doit avoir des 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 |
Spécifie la condition dans laquelle l’abonnement s’exécute. Les valeurs valides sont les suivantes :
- Créé
- Actualisé
- Supprimé
Type: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.Condition |
Valeurs acceptées: | Created, Updated |
Position: | Named |
Valeur par défaut: | Updated |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
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 |
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 avoir 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 |
Spécifie les critères XML utilisés par l’abonnement.
Si le paramètre filtre
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 |
Décrit l’abonnement.
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 |
Spécifie le nom complet de l’abonnement.
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 |
Indique si cette applet de commande active l’abonnement.
Type: | System.Boolean |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
Spécifie un groupe ou une file d’attente pour définir une limite sur le nombre d’objets suivis par l’abonnement.
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 |
Spécifie le nom du pack d’administration dans lequel cette applet de commande stocke l’abonnement.
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 |
Indique que cette applet de commande retourne l’abonnement qu’elle crée. Vous pouvez transmettre 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 |
Spécifie la liste des utilisateurs auxquels cet abonnement envoie un e-mail.
Type: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
Spécifie un objet qui représente la session sur un serveur d’administration 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 |
Spécifie le nom d’un modèle d’e-mail.
Type: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.EmailTemplate |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.
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 |
None.
Vous ne pouvez pas diriger l’entrée vers cette applet de commande.
None.
Cette applet de commande ne génère aucune sortie.