Partager via

Set-CMAlertSubscription

  • Référence
Module:
ConfigurationManager

Modifie les propriétés d’un abonnement d’alerte.

Syntaxe

Set-CMAlertSubscription
   [-AddEmailAddress <String[]>]
   [-AlertId <Int32[]>]
   [-EmailAddress <String[]>]
   -InputObject <IResultObject>
   [-LocaleId <Int32>]
   [-NewName <String>]
   [-PassThru]
   [-RemoveEmailAddress <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAlertSubscription
   [-AddEmailAddress <String[]>]
   [-AlertId <Int32[]>]
   [-EmailAddress <String[]>]
   -Id <String>
   [-LocaleId <Int32>]
   [-NewName <String>]
   [-PassThru]
   [-RemoveEmailAddress <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAlertSubscription
   [-AddEmailAddress <String[]>]
   [-AlertId <Int32[]>]
   [-EmailAddress <String[]>]
   [-LocaleId <Int32>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveEmailAddress <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-CMAlertSubscription modifie les propriétés d’un objet d’abonnement d’alerte dans Configuration Manager. Vous pouvez modifier le nom d’un abonnement d’alerte, l’adresse e-mail du destinataire d’une notification d’alerte, l’ID des paramètres régionaux Windows et l’ID d’alerte. Vous pouvez également modifier l’appartenance à l’étendue de sécurité d’un abonnement d’alerte en l’ajoutant ou en le supprimant d’une étendue de sécurité spécifiée.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Modifier les propriétés d’un abonnement d’alerte par ID d’abonnement

PS XYZ:\> Set-CMAlertSubscription -Id "16777217" -NewName "Subscription02" -EmailAddress "evan.narvaez@contoso.com" -LocaleId 2057 -AlertIds 16777240

Cette commande modifie le nom, l’adresse e-mail, l’ID de paramètres régionaux Windows et l’ID d’alerte d’un abonnement d’alerte qui a l’ID 16777217.

Exemple 2 : Modifier les propriétés d’un abonnement d’alerte par nom d’abonnement

PS XYZ:\> Set-CMAlertSubscription -Name "Subscription01" -NewName "Subscription02" -EmailAddress "elisa.daugherty@contoso.com" -LocaleId 2057 -AlertIds 16777240

Cette commande modifie le nom, l’adresse e-mail, l’ID des paramètres régionaux Windows et l’ID d’alerte d’un abonnement d’alerte nommé Subscription01.

Exemple 3 : Modifier les propriétés d’un abonnement d’alerte en utilisant la sortie d’une autre applet de commande comme entrée

PS XYZ:\> $SubObj = Get-CMAlertSubscription -Id "16777310"
PS XYZ:\> Set-CMAlertSubscription -AlertSubscription $SubObj -NewName "Subscription02" -EmailAddress "patti.fuller@contoso.com" -LocaleId 3081 -AlertIds 16777240

La première commande obtient un objet d’abonnement d’alerte qui a l’ID 16777310, puis stocke l’objet dans la variable $SubObj.

La deuxième commande modifie les propriétés de l’objet d’abonnement d’alerte, qui incluent le nom de l’abonnement, le destinataire de l’e-mail, l’ID de paramètres régionaux et l’ID d’alerte, pour la notification d’alerte stockée dans la variable $SubObj.

Exemple 4 : Ajouter un abonnement d’alerte à une étendue de sécurité

PS XYZ:\> Set-CMAlertSubscription -SecurityScopeAction AddMembership -SecurityScopeName "Test" -Name "Subscription01"

Cette commande ajoute l’abonnement d’alerte nommé Subscription01 à l’étendue de sécurité nommée Test.

Exemple 5 : Supprimer un abonnement d’alerte d’une étendue de sécurité

PS XYZ:\> Set-CMAlertSubscription -SecurityScopeAction RemoveMembership -SecurityScopeName "Test" -Name "Subscription01"

Cette commande supprime l’abonnement d’alerte nommé Subscription01 de l’étendue de sécurité nommée Test.

Paramètres

-AddEmailAddress

Type:String[]
Alias:AddEmailAddresses
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AlertId

Spécifie un tableau d’ID d’alerte pour les abonnements.

Type:Int32[]
Alias:AlertIds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

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

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

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

-EmailAddress

Spécifie une adresse e-mail à laquelle vous souhaitez envoyer une notification d’alerte. Vous pouvez séparer plusieurs adresses e-mail à l’aide d’un point-virgule.

Type:String[]
Alias:EmailAddresses
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

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

-Id

Spécifie l’identificateur d’un objet d’abonnement.

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

-InputObject

Spécifie un objet de notification d’alerte dans Configuration Manager.

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LocaleId

Spécifie des paramètres régionaux pour les messages d’alerte. Pour plus d’informations et pour obtenir la liste des identificateurs de paramètres régionaux, consultez Annexe A : Comportement du produit.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom d’un objet d’abonnement d’alerte.

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

-NewName

Spécifie un nouveau nom pour un objet d’abonnement d’alerte.

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

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

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

-RemoveEmailAddress

Type:String[]
Alias:RemoveEmailAddresses
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object