Share via

Set-CMAlertSubscription

  • Referência
Módulo:
ConfigurationManager

Altera as propriedades de uma assinatura 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

O cmdlet Set-CMAlertSubscription altera as propriedades de um objeto de assinatura de alerta no Configuration Manager. Você pode alterar o nome de uma assinatura de alerta, o endereço de email do destinatário de uma notificação de alerta, a ID Windows local e a ID do alerta. Você também pode alterar a associação de escopo de segurança de uma assinatura de alerta adicionando-a ou removendo-a de um escopo de segurança especificado.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Alterar as propriedades de uma assinatura de alerta por ID de assinatura

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

Esse comando altera o nome, o endereço de email, Windows ID da localidade e a ID de alerta de uma assinatura de alerta que tem a ID 16777217.

Exemplo 2: Alterar as propriedades de uma assinatura de alerta pelo nome da assinatura

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 email, Windows ID da localidade e a ID de alerta de uma assinatura de alerta chamada Subscription01.

Exemplo 3: Alterar as propriedades de uma assinatura de alerta usando 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 assinatura de alerta que tem a ID 16777310 e, em seguida, armazena o objeto na variável $SubObj de segurança.

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

Exemplo 4: Adicionar uma assinatura de alerta a um escopo de segurança

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

Este comando adiciona a assinatura de alerta chamada Subscription01 ao escopo de segurança chamado Test.

Exemplo 5: Remover uma assinatura de alerta de um escopo de segurança

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

Este comando remove a assinatura de alerta chamada Subscription01 do escopo de segurança chamado Test.

Parâmetros

-AddEmailAddress

Type:String[]
Aliases:AddEmailAddresses
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AlertId

Especifica uma matriz de IDs de alerta para assinaturas.

Type:Int32[]
Aliases:AlertIds
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EmailAddress

Especifica um endereço de email onde você deseja enviar uma notificação de alerta. Você pode separar vários endereços de email usando um ponto e vírgula.

Type:String[]
Aliases:EmailAddresses
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifica o identificador de um objeto subscription.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-LocaleId

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome de um objeto de assinatura de alerta.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Especifica um novo nome para um objeto de assinatura de alerta.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object