Set-CMAlertSubscription
變更警示訂閱的屬性。
Syntax
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
CMAlertSubscription 指令程式會變更 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
第一個命令會取得 ID 為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
Type: | String[] |
Aliases: | AddEmailAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EmailAddress
指定您要傳送警示通知的電子郵件地址。 您可以使用分號來分隔多個電子郵件地址。
Type: | String[] |
Aliases: | EmailAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
這個參數會處理萬用字元,而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
指定 Configuration Manager 中的警示通知物件。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LocaleId
指定提醒訊息的地區設定。 如需詳細資訊及地區識別碼的清單,請參閱 附錄 a:產品行為。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
指定警示訂閱物件的新名稱。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
新增此參數可傳回代表您正在使用之專案的物件。 根據預設,此 Cmdlet 可能不會產生任何輸出。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveEmailAddress
Type: | String[] |
Aliases: | RemoveEmailAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-名稱
指定警示訂閱物件的名稱。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-為 alertid
指定訂閱的警示 IDs 陣列。
Type: | Int32[] |
Aliases: | AlertIds |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-識別碼
指定訂閱物件的識別碼。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
ConfigurationManagement IResultObject
輸出
系統.物件