Partager via

New-SCSMSubscription

  • Référence
Module:
System.Center.Service.Manager

Crée un abonnement dans Service Manager.

Syntaxe

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

Description

La cmdlet New-SCSMSubscription crée un abonnement dans Service Manager.

Exemples

Exemple 1 : Créer un abonnement

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.

Exemple 2 : Créer un abonnement de notification par e-mail

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 , où l’emplacement a changé.

Paramètres

-Class

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

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

-Condition

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

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

-Criteria

Spécifie les critères XML utilisés par l’abonnement. Si le paramètre filtre et le paramètre Critères de sont spécifiés, cette applet de commande utilise uniquement Critères.

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

-Description

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

-DisplayName

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

-Enable

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

-GroupQueue

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

-ManagementPack

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

-PassThru

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

-Recipient

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

-SCSession

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

-Template

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

-WhatIf

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

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.