Dela via


Set-CMAlertSubscription

SYNOPSIS

Ändrar egenskaperna för en aviseringsprenumeration.

SYNTAX

SetByValueMandatory (standard)

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

Cmdleten Set-CMAlertSubscription ändrar egenskaperna för ett objekt för aviseringsprenumeration i Konfigurationshanteraren. Du kan ändra namnet på en aviseringsprenumeration, e-postadressen till mottagaren av ett aviseringsmeddelande, Windows språk-ID och aviserings-ID. Du kan också ändra medlemskap i säkerhetsomfattningen för en aviseringsprenumeration genom att lägga till den i eller ta bort den från en angiven säkerhetsomfattning.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Ändra egenskaperna för en aviseringsprenumeration efter prenumerations-ID

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

Det här kommandot ändrar namn, e-postadress, Windows språk-ID och aviserings-ID för en aviseringsprenumeration som har ID:t 16777217.

Exempel 2: Ändra egenskaperna för en aviseringsprenumeration efter prenumerationsnamn

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

Det här kommandot ändrar namn, e-postadress, Windows språk-ID och aviserings-ID för en aviseringsprenumeration med namnet Subscription01.

Exempel 3: Ändra egenskaperna för en aviseringsprenumeration med hjälp av utdata från en annan cmdlet som indata

PS XYZ:\> $SubObj = Get-CMAlertSubscription -Id "16777310"
PS XYZ:\> Set-CMAlertSubscription -AlertSubscription $SubObj -NewName "Subscription02" -EmailAddress "patti.fuller@contoso.com" -LocaleId 3081 -AlertIds 16777240

Det första kommandot hämtar ett prenumerationsobjekt för aviseringar som har ID 16777310 och lagrar sedan objektet i $SubObj variabeln.

Det andra kommandot ändrar egenskaperna för aviseringsprenumerationsobjektet, inklusive prenumerationsnamn, e-postmottagare, språk-ID och aviserings-ID för aviseringsmeddelandet som lagras i $SubObj variabeln.

Exempel 4: Lägga till en aviseringsprenumeration i en säkerhetsomfattning

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

Det här kommandot lägger till aviseringsprenumerationen med namnet Subscription01 i säkerhetsomfattningen med namnet Test.

Exempel 5: Ta bort en aviseringsprenumeration från en säkerhetsomfattning

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

Det här kommandot tar bort aviseringsprenumerationen med namnet Subscription01 från säkerhetsomfattningen med namnet Test.

PARAMETERS

-AddEmailAddress

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

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

-AlertId

Anger en matris med aviserings-ID:er för prenumerationer.

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

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EmailAddress

Anger en e-postadress där du vill skicka ett aviseringsmeddelande. Du kan avgränsa flera e-postadresser med semikolon.

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

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Anger identifieraren för ett prenumerationsobjekt.

Type: String
Parameter Sets: SetById
Aliases:

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

-InputObject

Anger ett objekt för aviseringsmeddelanden i Konfigurationshanteraren.

Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:

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

-LocaleId

Anger ett språk för aviseringsmeddelanden. Mer information och en lista över språkidentifierare finns i Bilaga A: Produktbeteende.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Name

Anger namnet på ett objekt för en aviseringsprenumeration.

Type: String
Parameter Sets: SetByName
Aliases:

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

-NewName

Anger ett nytt namn för ett objekt för en aviseringsprenumeration.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar denna cmdlet kanske inte några utdata.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-RemoveEmailAddress

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

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

New-CMAlertSubscription

Get-CMAlertSubscription

Remove-CMAlertSubscription

Set-CMSecurityScope