az monitor alert-processing-rule

Hinweis

Diese Referenz ist Teil der AlertsManagement-Erweiterung für die Azure CLI (Version 2.45.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az Monitor-Befehl zur Warnungsverarbeitungsregel ausführen. Weitere Informationen zu Erweiterungen

Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Verwalten sie die Warnungsverarbeitungsregel mit warnungsverwaltung.

Befehle

Name	Beschreibung	Typ	Status
az monitor alert-processing-rule create	Erstellen einer Warnungsverarbeitungsregel.	Erweiterung	Vorschau
az monitor alert-processing-rule delete	Löschen einer Warnungsverarbeitungsregel.	Erweiterung	Vorschau
az monitor alert-processing-rule list	Auflisten aller Warnungsverarbeitungsregeln in einem Abonnement oder einer Ressourcengruppe.	Erweiterung	Vorschau
az monitor alert-processing-rule show	Rufen Sie eine Warnungsverarbeitungsregel ab.	Erweiterung	Vorschau
az monitor alert-processing-rule update	Aktivieren, Deaktivieren oder Aktualisieren von Tags für eine Warnungsverarbeitungsregel.	Erweiterung	Vorschau

az monitor alert-processing-rule create

Vorschau

Die Befehlsgruppe "Überwachen der Regel zur Warnverarbeitung" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellen einer Warnungsverarbeitungsregel.

az monitor alert-processing-rule create --name
                                        --resource-group
                                        --rule-type {AddActionGroups, RemoveAllActionGroups}
                                        --scopes
                                        [--action-groups]
                                        [--description]
                                        [--enabled {false, true}]
                                        [--filter-alert-context]
                                        [--filter-alert-rule-description]
                                        [--filter-alert-rule-id]
                                        [--filter-alert-rule-name]
                                        [--filter-monitor-condition]
                                        [--filter-monitor-service]
                                        [--filter-resource-group]
                                        [--filter-resource-type]
                                        [--filter-severity]
                                        [--filter-signal-type]
                                        [--filter-target-resource]
                                        [--schedule-end-datetime]
                                        [--schedule-recurrence]
                                        [--schedule-recurrence-2]
                                        [--schedule-recurrence-2-end-time]
                                        [--schedule-recurrence-2-start-time]
                                        [--schedule-recurrence-2-type {Daily, Monthly, Weekly}]
                                        [--schedule-recurrence-end-time]
                                        [--schedule-recurrence-start-time]
                                        [--schedule-recurrence-type {Daily, Monthly, Weekly}]
                                        [--schedule-start-datetime]
                                        [--schedule-time-zone]
                                        [--tags]

Beispiele

Erstellen oder Aktualisieren einer Regel, die allen Warnungen in einem Abonnement eine Aktionsgruppe hinzufügt

az monitor alert-processing-rule create \
--name 'AddActionGroupToSubscription' \
--rule-type AddActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--action-groups "/subscriptions/MySubscriptionId/resourcegroups/MyResourceGroup1/providers/microsoft.insights/actiongroups/ActionGroup1" \
--enabled true \
--resource-group alertscorrelationrg \
--description "Add ActionGroup1 to all alerts in the subscription"

Erstellen oder Aktualisieren einer Regel, die allen Sev0- und Sev1-Warnungen in zwei Ressourcengruppen zwei Aktionsgruppen hinzufügt

az monitor alert-processing-rule create \
--name 'AddActionGroupsBySeverity' \
--rule-type AddActionGroups \
--action-groups "/subscriptions/MySubscriptionId/resourcegroups/MyResourceGroup1/providers/microsoft.insights/actiongroups/MyActionGroupId1" "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup2/providers/microsoft.insights/actionGroups/MyActionGroup2" \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--filter-severity Equals Sev0 Sev1 \
--description "Add AGId1 and AGId2 to all Sev0 and Sev1 alerts in these resourceGroups"

Erstellen oder Aktualisieren einer Regel, die alle Aktionsgruppen aus Warnungen auf einer bestimmten VM während eines einmaligen Standard Tenance-Fensters entfernt (1800-2000 zu einem bestimmten Datum, Pacific Standard Time)

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsMaintenanceWindow' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1/providers/Microsoft.Compute/virtualMachines/VMName" \
--resource-group alertscorrelationrg \
--schedule-start-datetime '2022-01-02 18:00:00' \
--schedule-end-datetime '2022-01-02 20:00:00' \
--schedule-time-zone 'Pacific Standard Time' \
--description "Removes all ActionGroups from all Alerts on VMName during the maintenance window"

Erstellen oder Aktualisieren einer Regel, die alle Aktionsgruppen aus allen Warnungen in einem Abonnement entfernt, die aus einer bestimmten Warnungsregel stammt

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsSpecificAlertRule' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--filter-alert-rule-id Equals "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1/providers/microsoft.insights/activityLogAlerts/RuleName" \
--description "Removes all ActionGroups from all Alerts that fire on above AlertRule"

Erstellen oder Aktualisieren einer Regel, die alle Aktionsgruppen aus allen Warnungen auf einem beliebigen virtuellen Computer in zwei Ressourcengruppen während eines wiederkehrenden Standard tenance-Fensters entfernt (2200-0400 alle Sa und Sun, India Standard Time)

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsRecurringMaintenance' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1" "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup2" \
--resource-group alertscorrelationrg \
--filter-resource-type Equals "microsoft.compute/virtualmachines" \
--schedule-time-zone "India Standard Time" \
--schedule-recurrence-type Weekly \
--schedule-recurrence-start-time "22:00:00" \
--schedule-recurrence-end-time "04:00:00" \
--schedule-recurrence Sunday Saturday \
--description "Remove all ActionGroups from all Virtual machine Alerts during the recurring maintenance"

Erstellen oder Aktualisieren einer Regel, die alle Aktionsgruppen außerhalb der Geschäftszeiten entfernt (Mo-Fr 09:00-17:00, Eastern Standard Time)

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsOutsideBusinessHours' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--schedule-time-zone "Eastern Standard Time" \
--schedule-recurrence-type Daily \
--schedule-recurrence-start-time "17:00:00" \
--schedule-recurrence-end-time "09:00:00" \
--schedule-recurrence-2-type Weekly \
--schedule-recurrence-2 Saturday Sunday \
--description "Remove all ActionGroups outside business hours"

Erforderliche Parameter

--name -n

Name der Warnungsverarbeitungsregel.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--rule-type

Geben Sie den Typ der Warnungsverarbeitungsregel an.

Zulässige Werte: AddActionGroups, RemoveAllActionGroups

--scopes

Liste der Ressourcen-IDs (durch Leerzeichen getrennt) für den Bereich. Die Regel gilt für Warnungen, die für Ressourcen innerhalb dieses Bereichs ausgelöst wurden.

Optionale Parameter

--action-groups

Liste der hinzuzufügenden Ressourcen-IDs (durch Leerzeichen getrennt) von Aktionsgruppen. Eine Verwendung dieses Arguments erfordert, dass der Regeltyp "AddActionGroups" ist.

--description

Beschreibung der Warnungsverarbeitungsregel.

--enabled

Geben Sie an, ob die angegebene Warnungsverarbeitungsregel aktiviert oder deaktiviert ist (Standard ist aktiviert).

Zulässige Werte: false, true

--filter-alert-context

Filtern von Warnungen nach Warnungskontext (Nutzlast).

Das Filterformat ist der Ort, an dem operator: einer von <"Equals", "NotEquals", "Contains", "DoesNotContain> Values": Liste der Werte, die für eine bestimmte Bedingung übereinstimmen sollen.

--filter-alert-rule-description

Filtern sie Warnungen nach der Beschreibung der Warnungsregel.

--filter-alert-rule-id

Filtern sie Warnungen nach Warnungs-ID.

--filter-alert-rule-name

Filtern sie Warnungen nach dem Namen der Warnungsregel.

--filter-monitor-condition

Filtern sie Warnungen nach Überwachung der Bedingung.

--filter-monitor-service

Filtert Warnungen nach Überwachungsdienst.

--filter-resource-group

Filtert Warnungen nach Ressourcengruppe.

--filter-resource-type

Filtert Warnungen nach Ressourcentyp.

--filter-severity

Filtern Sie Warnungen nach Schweregrad <Sev0, Sev1, Sev2, Sev3, Sev4>.

--filter-signal-type

Filtern sie Warnungen nach Signaltyp.

--filter-target-resource

Filtern sie Warnungen nach Ressource.

--schedule-end-datetime

Enddatum für die Regel. Format: 'JJJJ-MM-DD hh:mm:ss'.

--schedule-recurrence

Liste der Serienmusterwerte.

--schedule-recurrence: Liste der Serienmusterwerte (durch Leerzeichen getrennt). Für einen wöchentlichen Serientyp sind zulässige Werte Sonntag bis Samstag. Bei einem monatlichen Serientyp sind zulässige Werte 1 bis 31 (Tage des Monats).

--schedule-recurrence-2

Liste der Serienmusterwerte für das zweite Serienmuster.

--schedule-recurrence-2 : Liste der Serienmusterwerte (durch Leerzeichen getrennt). Für einen wöchentlichen Serientyp sind zulässige Werte Sonntag bis Samstag. Bei einem monatlichen Serientyp sind zulässige Werte 1 bis 31 (Tage des Monats).

--schedule-recurrence-2-end-time

Endzeit für jede Serie. Format: hh:mm:ss.

--schedule-recurrence-2-start-time

Startzeit für jede Serie. Format: hh:mm:ss.

--schedule-recurrence-2-type

Gibt an, wann die Verarbeitungsregel angewendet werden soll. Standardeinstellung für "Immer".

Zulässige Werte: Daily, Monthly, Weekly

--schedule-recurrence-end-time

Endzeit für jede Serie. Format: 'hh:mm:ss'.

--schedule-recurrence-start-time

Startzeit für jede Serie. Format: 'hh:mm:ss'.

--schedule-recurrence-type

Gibt an, wann die Verarbeitungsregel angewendet werden soll.

Zulässige Werte: Daily, Monthly, Weekly

--schedule-start-datetime

Startdatum für die Regel. Format: 'JJJJ-MM-DD hh:mm:ss'.

--schedule-time-zone

Zeitzone planen.

Standardwert: UTC

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc

Standardwert: json

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor alert-processing-rule delete

Vorschau

Die Befehlsgruppe "Überwachen der Regel zur Warnverarbeitung" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Löschen einer Warnungsverarbeitungsregel.

az monitor alert-processing-rule delete [--ids]
                                        [--name]
                                        [--resource-group]
                                        [--subscription]
                                        [--yes]

Beispiele

Löschen einer Warnungsverarbeitungsregel.

az monitor alert-processing-rule delete \
--resource-group myResourceGroup \
--name myRuleName

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Name der Warnungsverarbeitungsregel.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc

Standardwert: json

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor alert-processing-rule list

Vorschau

Die Befehlsgruppe "Überwachen der Regel zur Warnverarbeitung" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Auflisten aller Warnungsverarbeitungsregeln in einem Abonnement oder einer Ressourcengruppe.

az monitor alert-processing-rule list [--resource-group]

Beispiele

Auflisten aller Warnungsverarbeitungsregeln im aktuellen Abonnement

az monitor alert-processing-rule list

Auflisten aller Warnungsverarbeitungsregeln in einer Ressourcengruppe

az monitor alert-processing-rule list \
--resource-group myResourceGroup

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc

Standardwert: json

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor alert-processing-rule show

Vorschau

Die Befehlsgruppe "Überwachen der Regel zur Warnverarbeitung" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Rufen Sie eine Warnungsverarbeitungsregel ab.

az monitor alert-processing-rule show [--ids]
                                      [--name]
                                      [--resource-group]
                                      [--subscription]

Beispiele

Abrufen einer Warnungsverarbeitungsregel anhand des Namens

az monitor alert-processing-rule show \
--name myRuleName \
--resource-group myRuleNameResourceGroup

Abrufen der Regel zur Verarbeitung von Warnungen nach IDs

az monitor alert-processing-rule show \
--ids ruleId1 ruleId2

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Name der Warnungsverarbeitungsregel.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc

Standardwert: json

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor alert-processing-rule update

Vorschau

Die Befehlsgruppe "Überwachen der Regel zur Warnverarbeitung" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Aktivieren, Deaktivieren oder Aktualisieren von Tags für eine Warnungsverarbeitungsregel.

az monitor alert-processing-rule update [--add]
                                        [--enabled {false, true}]
                                        [--force-string]
                                        [--ids]
                                        [--name]
                                        [--remove]
                                        [--resource-group]
                                        [--set]
                                        [--subscription]
                                        [--tags]

Beispiele

PatchAlertProcessingRule

az monitor alert-processing-rule update \
--name "WeeklySuppression" \
--enabled false \
--tags key1="value1" key2="value2" --resource-group "alertscorrelationrg"

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Standardwert: []

--enabled

Geben Sie an, ob die angegebene Verarbeitungsregel aktiviert oder deaktiviert ist (Werte sind True und False).

Zulässige Werte: false, true

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Standardwert: False

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Name der Warnungsverarbeitungsregel.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Standardwert: []

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Standardwert: []

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc

Standardwert: json

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.