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.