Delen via


Set-CMAlertSubscription

SYNOPSIS

Wijzigt de eigenschappen van een waarschuwingsabonnement.

SYNTAX

SetByValueMandatory (standaard)

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

De cmdlet Set-CMAlertSubscription wijzigt de eigenschappen van een waarschuwingsabonnementobject in Configuration Manager. U kunt de naam van een waarschuwingsabonnement, het e-mailadres van de ontvanger van een waarschuwingsmelding, Windows land-id en de waarschuwings-id wijzigen. U kunt ook het lidmaatschap van het beveiligingsbereik van een waarschuwingsabonnement wijzigen door het toe te voegen aan of te verwijderen uit een opgegeven beveiligingsbereik.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: de eigenschappen van een waarschuwingsabonnement wijzigen op abonnements-id

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

Met deze opdracht worden de naam, het e-mailadres, de Windows-id en de waarschuwings-id van een waarschuwingsabonnement met de id 16777217.

Voorbeeld 2: de eigenschappen van een waarschuwingsabonnement wijzigen op abonnementsnaam

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

Met deze opdracht worden de naam, het e-mailadres, Windows de id van de lokale omgeving en de waarschuwings-id van een waarschuwingsabonnement met de naam Subscription01 gewijzigd.

Voorbeeld 3: de eigenschappen van een waarschuwingsabonnement wijzigen met behulp van de uitvoer van een andere cmdlet als invoer

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

Met de eerste opdracht wordt een waarschuwingsabonnementsobject met de id 16777310 en wordt het object vervolgens op de $SubObj op slaat.

Met de tweede opdracht worden de eigenschappen van het object waarschuwingsabonnement gewijzigd, waaronder de abonnementsnaam, de ontvanger van het e-mailadres, de land-id en de waarschuwings-id, voor de waarschuwingsmelding die is opgeslagen in de variabele $SubObj waarschuwing.

Voorbeeld 4: Een waarschuwingsabonnement toevoegen aan een beveiligingsbereik

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

Met deze opdracht wordt het waarschuwingsabonnement met de naam Subscription01 toegevoegd aan het beveiligingsbereik met de naam Test.

Voorbeeld 5: Een waarschuwingsabonnement verwijderen uit een beveiligingsbereik

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

Met deze opdracht wordt het waarschuwingsabonnement met de naam Subscription01 verwijderd uit het beveiligingsbereik met de naam 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

Hiermee geeft u een matrix met waarschuwings-ID's voor abonnementen op.

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

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EmailAddress

Hiermee geeft u een e-mailadres op waar u een waarschuwingsmelding wilt verzenden. U kunt meerdere e-mailadressen scheiden met behulp van een puntkomma.

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

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Hiermee geeft u de id voor een abonnementsobject op.

Type: String
Parameter Sets: SetById
Aliases:

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

-InputObject

Hiermee geeft u een waarschuwingsmeldingsobject in Configuration Manager.

Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:

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

-LocaleId

Hiermee geeft u een locale voor waarschuwingsberichten. Zie bijlage A: productgedragvoor meer informatie en een lijst met id's voor de lokale omgeving.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Name

Hiermee geeft u de naam van een abonnementsobject waarschuwing.

Type: String
Parameter Sets: SetByName
Aliases:

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

-NewName

Hiermee geeft u een nieuwe naam voor een abonnementsobject waarschuwing.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Voeg deze parameter toe om een object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.

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

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

New-CMAlertSubscription

Get-CMAlertSubscription

Remove-CMAlertSubscription

Set-CMSecurityScope