Partilhar via


Set-CMAlertSubscription

SYNOPSIS

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

SYNTAX

SetByValueMandatory (Padrão)

Set-CMAlertSubscription [-AddEmailAddress <String[]>] [-AlertId <Int32[]>] [-EmailAddress <String[]>]
 -InputObject <IResultObject> [-LocaleId <Int32>] [-NewName <String>] [-PassThru]
 [-RemoveEmailAddress <String[]>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SetById

Set-CMAlertSubscription [-AddEmailAddress <String[]>] [-AlertId <Int32[]>] [-EmailAddress <String[]>]
 -Id <String> [-LocaleId <Int32>] [-NewName <String>] [-PassThru] [-RemoveEmailAddress <String[]>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetByName

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 Gestor de Configuração. 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 Windows iD local e o ID de alerta. Também pode alterar a subscrição de âmbito de segurança de uma subscrição de alerta adicionando-a ou removendo-a de um âmbito de segurança especificado.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

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, endereço de e-mail, Windows ID local e alerta iD de uma subscrição de alerta que tem o ID 16777217.

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

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

Este comando altera o nome, endereço de e-mail, Windows ID local e alerta ID de uma subscrição de alerta chamada Subscrição01.

Exemplo 3: Alterar as propriedades de uma subscrição de alerta utilizando 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 recebe 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 de subscrição, o destinatário do e-mail, o ID local e o ID de 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 Subscrição01 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 Subscrição01 do âmbito de segurança denominado Teste.

PARAMETERS

-AddEmailAddress

Type: String[]
Parameter Sets: (All)
Aliases: AddEmailAddresses

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

-AlertaId

Especifica uma série de IDs de alerta para subscrições.

Type: Int32[]
Parameter Sets: (All)
Aliases: AlertIds

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

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EmailAddress

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

Type: String[]
Parameter Sets: (All)
Aliases: EmailAddresses

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

-ForceWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

- ID

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

Type: String
Parameter Sets: SetById
Aliases:

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

-InputObject

Especifica um objeto de notificação de alerta no Gestor de Configuração.

Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-LocaleId

Especifica um local para mensagens de alerta. Para obter mais informações e uma lista de identificadores locais, consulte o apêndice A: Comportamento do produto.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Name

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

Type: String
Parameter Sets: SetByName
Aliases:

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

-Novo Nome

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

Type: String
Parameter Sets: (All)
Aliases:

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

- PassThru

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Remover O Endereço DeMail

Type: String[]
Parameter Sets: (All)
Aliases: RemoveEmailAddresses

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Sistema.Objeto

NOTAS

Nova subscrição de CMAlertSubscription

Get-CMAlertSubscription

Remoção-CMAlertSubscription

Set-CMSecurityScope