Freigeben über

Set-CMAlertSubscription

  • Referenz
Modul:
ConfigurationManager

Ändert die Eigenschaften eines Warnungsabonnements.

Syntax

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

Beschreibung

Das Cmdlet Set-CMAlertSubscription ändert die Eigenschaften eines Warnungsabonnementobjekts in Configuration Manager. Sie können den Namen eines Warnungsabonnements, die E-Mail-Adresse des Empfängers einer Warnungsbenachrichtigung, die Windows-Gebietsschema-ID und die Warnungs-ID ändern. Sie können auch die Mitgliedschaft im Sicherheitsbereich eines Warnungsabonnements ändern, indem Sie sie einem angegebenen Sicherheitsbereich hinzufügen oder daraus entfernen.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Ändern der Eigenschaften eines Warnungsabonnements nach Abonnement-ID

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

Dieser Befehl ändert den Namen, die E-Mail-Adresse, die Windows-Gebietsschema-ID und die Warnungs-ID eines Warnungsabonnements, das die ID 16777217 hat.

Beispiel 2: Ändern der Eigenschaften eines Warnungsabonnements nach Abonnementname

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

Dieser Befehl ändert den Namen, die E-Mail-Adresse, die Windows-Gebietsschema-ID und die Warnungs-ID eines Warnungsabonnements namens Subscription01.

Beispiel 3: Ändern der Eigenschaften eines Warnungsabonnements mithilfe der Ausgabe eines anderen Cmdlets als Eingabe

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

Der erste Befehl ruft ein Warnungsabonnementobjekt ab, das über die ID 16777310 verfügt, und speichert das Objekt dann in der variablen $SubObj.

Der zweite Befehl ändert die Eigenschaften des Warnungsabonnementobjekts, einschließlich Abonnementname, E-Mail-Empfänger, Gebietsschema-ID und Warnungs-ID für die in der $SubObj-Variable gespeicherte Warnungsbenachrichtigung.

Beispiel 4: Hinzufügen eines Warnungsabonnements zu einem Sicherheitsbereich

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

Mit diesem Befehl wird das Warnungsabonnement Subscription01 dem Sicherheitsbereich Test hinzugefügt.

Beispiel 5: Entfernen eines Warnungsabonnements aus einem Sicherheitsbereich

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

Dieser Befehl entfernt das Warnungsabonnement mit dem Namen Subscription01 aus dem Sicherheitsbereich Test.

Parameter

-AddEmailAddress

Typ:String[]
Aliase:AddEmailAddresses
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AlertId

Gibt ein Array von Warnungs-IDs für Abonnements an.

Typ:Int32[]
Aliase:AlertIds
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EmailAddress

Gibt eine E-Mail-Adresse an, an die Sie eine Warnungsbenachrichtigung senden möchten. Sie können mehrere E-Mail-Adressen mithilfe eines Semikolons trennen.

Typ:String[]
Aliase:EmailAddresses
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Gibt den Bezeichner für ein Abonnementobjekt an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein Warnungsbenachrichtigungsobjekt in Configuration Manager an.

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-LocaleId

Gibt ein Gebietsschema für Warnmeldungen an. Weitere Informationen und eine Liste der Gebietsschemabezeichner finden Sie unter Anhang A: Produktverhalten.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines Warnungsabonnementobjekts an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NewName

Gibt einen neuen Namen für ein Warnungsabonnementobjekt an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveEmailAddress

Typ:String[]
Aliase:RemoveEmailAddresses
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object