共用方式為


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

Description

Set-CMAlertSubscription Cmdlet 會變更 Configuration Manager 中警示訂用帳戶對象的屬性。 您可以變更警示訂閱的名稱、警示通知收件者的電子郵件位址、Windows 地區設定識別碼和警示標識符。 您也可以將警示訂用帳戶新增至警示訂用帳戶,或從指定的安全性範圍中移除警示訂用帳戶的安全性範圍成員資格。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>。 如需詳細資訊,請 參閱開始使用

範例

範例 1:依訂用帳戶標識碼變更警示訂用帳戶的屬性

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

此命令會變更具有標識碼16777217之警示訂用帳戶的名稱、電子郵件位址、Windows 地區設定標識符和警示標識符。

範例 2:依訂用帳戶名稱變更警示訂用帳戶的屬性

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

此命令會變更名為 Subscription01 之警示訂閱的名稱、電子郵件位址、Windows 地區設定標識符和警示標識符。

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

第一個命令會取得標識碼16777310的警示訂用帳戶對象,然後將物件儲存在$SubObj變數中。

第二個命令會針對儲存在 $SubObj 變數中的警示通知,變更警示訂用帳戶對象的屬性,包括訂用帳戶名稱、電子郵件收件者、地區設定標識碼和警示標識符。

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

指定訂用帳戶的警示標識碼數組。

類型: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