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 изменяет свойства объекта подписки на оповещения в Configuration Manager. Вы можете изменить имя подписки на оповещения, адрес электронной почты получателя уведомления об оповещении, идентификатор языкового стандарта Windows и идентификатор оповещения. Вы также можете изменить членство в области безопасности подписки на оповещения, добавив или удалив ее из указанной области безопасности.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Изменение свойств подписки на оповещения по идентификатору подписки
PS XYZ:\> Set-CMAlertSubscription -Id "16777217" -NewName "Subscription02" -EmailAddress "evan.narvaez@contoso.com" -LocaleId 2057 -AlertIds 16777240Эта команда изменяет имя, адрес электронной почты, идентификатор языкового стандарта Windows и идентификатор оповещения подписки на оповещения с идентификатором 16777217.
Пример 2. Изменение свойств подписки на оповещения по имени подписки
PS XYZ:\> Set-CMAlertSubscription -Name "Subscription01" -NewName "Subscription02" -EmailAddress "elisa.daugherty@contoso.com" -LocaleId 2057 -AlertIds 16777240Эта команда изменяет имя, адрес электронной почты, идентификатор локали Windows и идентификатор оповещения подписки на оповещения с именем Subscription01.
Пример 3. Изменение свойств подписки на оповещения с помощью выходных данных другого командлета в качестве входных данных
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"Эта команда удаляет подписку на оповещения с именем Subscription01 из области безопасности с именем Test.
Параметры
-AddEmailAddress
| Тип: | String[] |
| Aliases: | AddEmailAddresses |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AlertId
Задает массив идентификаторов оповещений для подписок.
| Тип: | Int32[] |
| Aliases: | AlertIds |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-EmailAddress
Указывает адрес электронной почты, на который нужно отправить уведомление об оповещении. Вы можете разделить несколько адресов электронной почты с помощью точки с запятой.
| Тип: | String[] |
| Aliases: | EmailAddresses |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Id
Указывает идентификатор объекта подписки.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InputObject
Указывает объект уведомления об оповещении в Configuration Manager.
| Тип: | IResultObject |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-LocaleId
Задает языковой стандарт для сообщений оповещений. Дополнительные сведения и список идентификаторов языкового стандарта см. в приложении A. Поведение продукта.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Name
Указывает имя объекта подписки на оповещения.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-NewName
Задает новое имя объекта подписки на оповещения.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PassThru
Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RemoveEmailAddress
| Тип: | String[] |
| Aliases: | RemoveEmailAddresses |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
System.Object