Set-CMAlertSubscription
Cambia las propiedades de una suscripción de alerta.
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
El cmdlet Set-CMAlertSubscription cambia las propiedades de un objeto de suscripción de alerta en Configuration Manager. Puede cambiar el nombre de una suscripción de alerta, la dirección de correo electrónico del destinatario de una notificación de alerta, el Windows de configuración regional y el identificador de alerta. También puede cambiar la pertenencia al ámbito de seguridad de una suscripción de alerta agregándole o quitándole de un ámbito de seguridad especificado.
Nota
Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>
. Para obtener más información, vea getting started.
Ejemplos
Ejemplo 1: Cambiar las propiedades de una suscripción de alerta por identificador de suscripción
PS XYZ:\> Set-CMAlertSubscription -Id "16777217" -NewName "Subscription02" -EmailAddress "evan.narvaez@contoso.com" -LocaleId 2057 -AlertIds 16777240
Este comando cambia el nombre, la dirección de correo electrónico, Windows de configuración regional y el identificador de alerta de una suscripción de alerta que tiene el identificador 16777217.
Ejemplo 2: Cambiar las propiedades de una suscripción de alerta por nombre de suscripción
PS XYZ:\> Set-CMAlertSubscription -Name "Subscription01" -NewName "Subscription02" -EmailAddress "elisa.daugherty@contoso.com" -LocaleId 2057 -AlertIds 16777240
Este comando cambia el nombre, la dirección de correo electrónico, Windows de configuración regional y el identificador de alerta de una suscripción de alerta denominada Subscription01.
Ejemplo 3: Cambiar las propiedades de una suscripción de alerta mediante el resultado de otro cmdlet como entrada
PS XYZ:\> $SubObj = Get-CMAlertSubscription -Id "16777310"
PS XYZ:\> Set-CMAlertSubscription -AlertSubscription $SubObj -NewName "Subscription02" -EmailAddress "patti.fuller@contoso.com" -LocaleId 3081 -AlertIds 16777240
El primer comando obtiene un objeto de suscripción de alerta que tiene el identificador 16777310 y, a continuación, almacena el objeto en la variable $SubObj.
El segundo comando cambia las propiedades del objeto de suscripción de alerta, que incluyen el nombre de la suscripción, el destinatario del correo electrónico, el identificador de configuración regional y el identificador de alerta, para la notificación de alerta almacenada en la variable $SubObj alerta.
Ejemplo 4: Agregar una suscripción de alerta a un ámbito de seguridad
PS XYZ:\> Set-CMAlertSubscription -SecurityScopeAction AddMembership -SecurityScopeName "Test" -Name "Subscription01"
Este comando agrega la suscripción de alerta denominada Subscription01 al ámbito de seguridad denominado Test.
Ejemplo 5: Quitar una suscripción de alerta de un ámbito de seguridad
PS XYZ:\> Set-CMAlertSubscription -SecurityScopeAction RemoveMembership -SecurityScopeName "Test" -Name "Subscription01"
Este comando quita la suscripción de alerta denominada Subscription01 del ámbito de seguridad denominado Test.
Parámetros
- Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddEmailAddress
Type: | String[] |
Aliases: | AddEmailAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertId
Especifica una matriz de los IDs de alerta para las suscripciones.
Type: | Int32[] |
Aliases: | AlertIds |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EmailAddress
Especifica una dirección de correo electrónico a la que desea enviar una notificación de alerta. Puede separar varias direcciones de correo electrónico mediante un punto y coma.
Type: | String[] |
Aliases: | EmailAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifica el identificador de un objeto de suscripción.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifica un objeto de notificación de alerta en Configuration Manager.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LocaleID
Especifica una configuración regional para los mensajes de alerta. Para obtener más información y una lista de identificadores de configuración regional, vea Apéndice A: Comportamiento del producto.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica el nombre de un objeto de suscripción de alerta.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
Especifica un nuevo nombre para un objeto de suscripción de alerta.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, es posible que este cmdlet no genere ningún resultado.
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
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
System.Object