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.