Set-CMAlertSubscription

  • Referência
Módulo:
ConfigurationManager

Altera as propriedades de uma subscrição de alerta.

Sintaxe

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

O cmdlet Set-CMAlertSubscription altera as propriedades de um objeto de subscrição de alerta no Configuration Manager. Pode alterar o nome de uma subscrição de alerta, o endereço de e-mail do destinatário de uma notificação de alerta, o ID de região do Windows e o ID do alerta. Também pode alterar a associação ao âmbito de segurança de uma subscrição de alerta ao adicioná-la ou removê-la de um âmbito de segurança especificado.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Alterar as propriedades de uma subscrição de alerta por ID de subscrição

PS XYZ:\> Set-CMAlertSubscription -Id "16777217" -NewName "Subscription02" -EmailAddress "evan.narvaez@contoso.com" -LocaleId 2057 -AlertIds 16777240

Este comando altera o nome, o endereço de e-mail, o ID de região do Windows e o ID de alerta de uma subscrição de alerta que tem o ID 16777217.

Exemplo 2: Alterar as propriedades de uma subscrição de alerta pelo nome da subscrição

PS XYZ:\> Set-CMAlertSubscription -Name "Subscription01" -NewName "Subscription02" -EmailAddress "elisa.daugherty@contoso.com" -LocaleId 2057 -AlertIds 16777240

Este comando altera o nome, o endereço de e-mail, o ID de região do Windows e o ID de alerta de uma subscrição de alerta denominada Subscription01.

Exemplo 3: alterar as propriedades de uma subscrição de alerta com a saída de outro 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

O primeiro comando obtém um objeto de subscrição de alerta que tem o ID 16777310 e, em seguida, armazena o objeto na variável $SubObj.

O segundo comando altera as propriedades do objeto de subscrição de alerta, que incluem o nome da subscrição, o destinatário do e-mail, o ID da região e o ID do alerta, para a notificação de alerta armazenada na variável $SubObj.

Exemplo 4: Adicionar uma subscrição de alerta a um âmbito de segurança

PS XYZ:\> Set-CMAlertSubscription -SecurityScopeAction AddMembership -SecurityScopeName "Test" -Name "Subscription01"

Este comando adiciona a subscrição de alerta denominada Subscription01 ao âmbito de segurança denominado Teste.

Exemplo 5: Remover uma subscrição de alerta de um âmbito de segurança

PS XYZ:\> Set-CMAlertSubscription -SecurityScopeAction RemoveMembership -SecurityScopeName "Test" -Name "Subscription01"

Este comando remove a subscrição de alerta denominada Subscription01 do âmbito de segurança denominado Teste.

Parâmetros

-AddEmailAddress

Tipo:String[]
Aliases:AddEmailAddresses
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AlertId

Especifica uma matriz de IDs de alerta para subscrições.

Tipo:Int32[]
Aliases:AlertIds
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EmailAddress

Especifica um endereço de e-mail para o qual pretende enviar uma notificação de alerta. Pode separar vários endereços de e-mail com um ponto e vírgula.

Tipo:String[]
Aliases:EmailAddresses
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica o identificador de um objeto de subscrição.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica um objeto de notificação de alerta no Configuration Manager.

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LocaleId

Especifica uma região para mensagens de alerta. Para obter mais informações e uma lista de identificadores de região, veja Apêndice A: Comportamento do Produto.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome de um objeto de subscrição de alerta.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NewName

Especifica um novo nome para um objeto de subscrição de alerta.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveEmailAddress

Tipo:String[]
Aliases:RemoveEmailAddresses
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object