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