Compartir a través de

Set-CMAlertSubscription

  • Referencia
Módulo:
ConfigurationManager

Cambia las propiedades de una suscripción de alerta.

Sintaxis

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 identificador de configuración regional de Windows y el identificador de alerta. También puede cambiar la pertenencia al ámbito de seguridad de una suscripción de alerta agregándola o quitándola de un ámbito de seguridad especificado.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Cambio de 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, el identificador de configuración regional de Windows y el identificador de alerta de una suscripción de alerta que tiene el identificador 16777217.

Ejemplo 2: Cambio de 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, el identificador de configuración regional de Windows 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 la salida 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.

Ejemplo 4: Adición de 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: Eliminación de 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

-AddEmailAddress

Tipo:String[]
Alias:AddEmailAddresses
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AlertId

Especifica una matriz de identificadores de alerta para las suscripciones.

Tipo:Int32[]
Alias:AlertIds
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EmailAddress

Especifica una dirección de correo electrónico donde desea enviar una notificación de alerta. Puede separar varias direcciones de correo electrónico mediante un punto y coma.

Tipo:String[]
Alias:EmailAddresses
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

Especifica el identificador de un objeto de suscripción.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifica un objeto de notificación de alerta en Configuration Manager.

Tipo:IResultObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre de un objeto de suscripción de alerta.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NewName

Especifica un nuevo nombre para un objeto de suscripción de alerta.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, este cmdlet no puede generar ninguna salida.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoveEmailAddress

Tipo:String[]
Alias:RemoveEmailAddresses
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object