Set-CMAlertSubscription

更改警报订阅的属性。

语法

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

说明

Set-CMAlertSubscription cmdlet 更改 Configuration Manager 中警报订阅对象的属性。 可以更改警报订阅的名称、警报通知收件人的电子邮件地址、Windows 区域设置 ID 和警报 ID。 还可以更改警报订阅的安全范围成员身份,方法是将警报订阅添加到指定安全范围或将其从其中删除。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门

示例

示例 1:按订阅 ID 更改警报订阅的属性

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

此命令更改 ID 为16777217的警报订阅的名称、电子邮件地址、Windows 区域设置 ID 和警报 ID。

示例 2:按订阅名称更改警报订阅的属性

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

此命令更改名为 Subscription01 的警报订阅的名称、电子邮件地址、Windows 区域设置 ID 和警报 ID。

示例 3:使用另一个 cmdlet 的输出作为输入来更改警报订阅的属性

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

第一个命令获取具有 id 16777310的警报订阅对象,然后将该对象存储在 $SubObj 变量中。

第二个命令更改警报订阅对象的属性,其中包括存储在 $SubObj 变量中的警报通知的订阅名称、电子邮件收件人、区域设置 ID 和警报 ID。

示例 4:将警报订阅添加到安全范围

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

此命令将名为 Subscription01 的警报订阅添加到名为 Test 的安全作用域。

示例 5:从安全范围中删除警报订阅

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

此命令从名为 Test 的安全作用域中删除名为 Subscription01 的警报订阅。

参数

-AddEmailAddress

类型:String[]
别名:AddEmailAddresses
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AlertId

指定订阅的警报 ID 数组。

类型:Int32[]
别名:AlertIds
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EmailAddress

指定要在其中发送警报通知的电子邮件地址。 可以使用分号分隔多个电子邮件地址。

类型:String[]
别名:EmailAddresses
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Id

指定订阅对象的标识符。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-InputObject

在 Configuration Manager 中指定警报通知对象。

类型:IResultObject
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-LocaleId

指定警报消息的区域设置。 有关详细信息和区域设置标识符列表,请参阅 附录 A:产品行为

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

指定警报订阅对象的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-NewName

指定警报订阅对象的新名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PassThru

添加此参数可返回一个对象,该对象表示正在使用的项。 默认情况下,此 cmdlet 可能不会生成任何输出。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RemoveEmailAddress

类型:String[]
别名:RemoveEmailAddresses
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object