Teilen über


az communication email

Hinweis

Diese Referenz ist Teil der Kommunikationserweiterung für die Azure CLI (Version 2.59.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie ein az Kommunikations-E-Mail Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

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

Verwalten von Kommunikations-E-Mails.

Befehle

Name Beschreibung Typ Status
az communication email create

Erstellen Sie einen neuen EmailService, oder aktualisieren Sie einen vorhandenen EmailService.

Erweiterung Vorschau
az communication email delete

Löschen, um einen EmailService zu löschen.

Erweiterung Vorschau
az communication email domain

Kommunikations-E-Mail-Domäne verwalten.

Erweiterung Vorschau
az communication email domain cancel-verification

Abbrechen der Überprüfung des DNS-Eintrags.

Erweiterung Vorschau
az communication email domain create

Erstellen Sie eine neue Domänenressource unter der übergeordneten EmailService-Ressource, oder aktualisieren Sie eine vorhandene Domänenressource.

Erweiterung Vorschau
az communication email domain delete

Löschen, um eine Domänenressource zu löschen.

Erweiterung Vorschau
az communication email domain initiate-verification

Überprüfung des DNS-Eintrags initiieren.

Erweiterung Vorschau
az communication email domain list

Auflisten von Anforderungen zum Auflisten aller Domänenressourcen unter der übergeordneten EmailServices-Ressource.

Erweiterung Vorschau
az communication email domain sender-username

Verwalten des Absenderbenutzernamens der Kommunikations-E-Mail-Domäne.

Erweiterung Vorschau
az communication email domain sender-username create

Erstellen Sie eine neue SenderUsername-Ressource unter der übergeordneten Domänenressource, oder aktualisieren Sie eine vorhandene SenderUsername-Ressource.

Erweiterung Vorschau
az communication email domain sender-username delete

Löschen, um eine SenderUsernames-Ressource zu löschen.

Erweiterung Vorschau
az communication email domain sender-username list

Listet alle gültigen Absenderbenutzernamen für eine Domänenressource auf.

Erweiterung Vorschau
az communication email domain sender-username show

Abrufen eines gültigen Absenderbenutzernamens für eine Domänenressource.

Erweiterung Vorschau
az communication email domain sender-username update

Aktualisieren Sie eine neue SenderUsername-Ressource unter der übergeordneten Domänenressource, oder aktualisieren Sie eine vorhandene SenderUsername-Ressource.

Erweiterung Vorschau
az communication email domain show

Rufen Sie die Domänenressource und die zugehörigen Eigenschaften ab.

Erweiterung Vorschau
az communication email domain update

Aktualisieren Sie eine neue Domänenressource unter der übergeordneten EmailService-Ressource, oder aktualisieren Sie eine vorhandene Domänenressource.

Erweiterung Vorschau
az communication email domain wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung erfüllt ist.

Erweiterung Vorschau
az communication email list

Auflisten von Anforderungen zum Auflisten aller Ressourcen in einem Abonnement.

Erweiterung Vorschau
az communication email send

Senden Sie eine E-Mail, und erhalten Sie den endgültigen Status.

Erweiterung Vorschau
az communication email show

Rufen Sie den EmailService und dessen Eigenschaften ab.

Erweiterung Vorschau
az communication email status

Befehle zum Abrufen des Status von E-Mails, die zuvor mithilfe des Azure Communication Services-E-Mail-Diensts gesendet wurden.

Erweiterung Vorschau
az communication email status get

Abrufen des Status einer zuvor gesendeten E-Mail.

Erweiterung Vorschau
az communication email update

Aktualisieren Sie einen neuen EmailService oder aktualisieren Sie einen vorhandenen EmailService.

Erweiterung Vorschau
az communication email wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung erfüllt ist.

Erweiterung Vorschau

az communication email create

Vorschau

Befehlsgruppe "Kommunikations-E-Mail" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellen Sie einen neuen EmailService, oder aktualisieren Sie einen vorhandenen EmailService.

az communication email create --data-location
                              --email-service-name
                              --resource-group
                              [--location]
                              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                              [--tags]

Beispiele

Erstellen einer E-Mail-Ressource mit Tags

az communication email create -n ResourceName -g ResourceGroup --location global --data-location unitedstates --tags "{tag:tag}"

Erforderliche Parameter

--data-location

Der Ort, an dem der E-Mail-Dienst ruhende Daten speichert.

--email-service-name --name -n

Der Name der EmailService-Ressource.

--resource-group -g

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

Optionale Parameter

--location -l

Der geografische Standort, an dem sich die Ressource befindet, wenn nicht angegeben, wird der Standort der Ressourcengruppe verwendet.

Standardwert: Global
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--tags

Ressourcentags. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az communication email delete

Vorschau

Befehlsgruppe "Kommunikations-E-Mail" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Löschen, um einen EmailService zu löschen.

az communication email delete [--email-service-name]
                              [--ids]
                              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                              [--resource-group]
                              [--subscription]
                              [--yes]

Beispiele

Löschen einer E-Mail-Ressource

az communication email delete -n ResourceName -g ResourceGroup

Optionale Parameter

--email-service-name --name -n

Der Name der EmailService-Ressource.

--ids

Mindestens eine 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.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--yes -y

Zur Bestätigung nicht auffordern.

Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az communication email list

Vorschau

Befehlsgruppe "Kommunikations-E-Mail" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Auflisten von Anforderungen zum Auflisten aller Ressourcen in einem Abonnement.

az communication email list [--max-items]
                            [--next-token]
                            [--resource-group]

Beispiele

Abrufen aller Ressourcen aus einem Abonnement

az communication email list --subscription SubscriptionId

Abrufen aller Ressourcen aus einer Ressourcengruppe

az communication email list -g ResourceGroup

Optionale Parameter

--max-items

Die Gesamtanzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Wenn die Gesamtanzahl der verfügbaren Elemente größer als der angegebene Wert ist, wird ein Token in der Ausgabe des Befehls bereitgestellt. Um die Paginierung fortzusetzen, geben Sie den Tokenwert in --next-token Argument eines nachfolgenden Befehls an.

--next-token

Token, das angibt, wo die Paginierung beginnen soll. Dies ist der Tokenwert aus einer zuvor abgeschnittenen Antwort.

--resource-group -g

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az communication email send

Vorschau

Befehlsgruppe "Kommunikations-E-Mail" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Senden Sie eine E-Mail, und erhalten Sie den endgültigen Status.

az communication email send --sender
                            --subject
                            [--attachment-types]
                            [--attachments]
                            [--bcc]
                            [--cc]
                            [--connection-string]
                            [--disable-tracking {false, true}]
                            [--html]
                            [--importance {high, low, normal}]
                            [--inline-attachments]
                            [--reply-to]
                            [--text]
                            [--to]
                            [--wait-until {0, 1, completed, started}]

Beispiele

Senden einer E-Mail aus einer vorhandenen Domäne

az communication email send --sender "NoReply@contoso.com" --subject "Contoso Update" --to "user1@user1-domain.com" "user2@user2-domain.com" --text "Hello valued client. There is an update."

Erforderliche Parameter

--sender

Absender-E-Mail-Adresse aus einer überprüften Domäne.

--subject

Der Betreff der E-Mail-Nachricht.

Optionale Parameter

--attachment-types

Liste der E-Mail-Anlagentypen und Inlineanlagentypen in derselben Reihenfolge von Anlagen gefolgt von Inlineanlagen. Erforderlich für jede Anlage. Bekannte Werte für Anlagen sind: avi, bmp, doc, docm, docx, gif, jpeg, mp3, one, pdf, png, ppsm, ppsx, ppt, pptm, pptx, pub, rpmsg, rtf, tif, txt, vsd, wav, wma, xls, xlsb, xlsm und xlsx.

--attachments

Liste der E-Mail-Anlagen. Wahlfrei.

--bcc

Blindkopie-E-Mail-Adressen.

--cc

E-Mail-Adressen der Kopie.

--connection-string

Kommunikationsverbindungszeichenfolge. Umgebungsvariable: AZURE_COMMUNICATION_CONNECTION_STRING.

--disable-tracking

Gibt an, ob die Nachverfolgung des Benutzereinsatzes für diese bestimmte Anforderung deaktiviert werden soll. Dies gilt nur, wenn die Einstellung zur Überwachung der Benutzerbindung auf Ressourcenebene bereits in der Steuerungsebene aktiviert war. Wahlfrei.

Zulässige Werte: false, true
Standardwert: False
--html

HTML-Version der E-Mail-Nachricht. Wahlfrei.

--importance

Der Wichtigkeitstyp für die E-Mail. Bekannte Werte sind: „Hoch“, „Normal“ und „Niedrig“. Der Standardwert ist „Normal“. Wahlfrei.

Zulässige Werte: high, low, normal
Standardwert: normal
--inline-attachments

Liste der Inlineanlagen. Wahlfrei. Format: FileLocation/ContentId-Beispiel: "ImageName.png/image".

--reply-to

Antwort-an-E-Mail-Adresse. Wahlfrei.

--text

Nur-Text-Version der E-Mail-Nachricht. Wahlfrei.

--to

Recepients E-Mail-Adressen getrennt, wenn mehrere.

--wait-until

Gibt an, ob gewartet werden soll, bis der Servervorgang gestartet oder abgeschlossen ist. Akzeptierte Werte sind: gestartet, abgeschlossen, 1, 0.

Zulässige Werte: 0, 1, completed, started
Standardwert: completed
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az communication email show

Vorschau

Befehlsgruppe "Kommunikations-E-Mail" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Rufen Sie den EmailService und dessen Eigenschaften ab.

az communication email show [--email-service-name]
                            [--ids]
                            [--resource-group]
                            [--subscription]

Beispiele

Abrufen der Eigenschaften eines E-Mail-Diensts

az communication email show -n ResourceName -g ResourceGroup

Optionale Parameter

--email-service-name --name -n

Der Name der EmailService-Ressource.

--ids

Mindestens eine 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.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az communication email update

Vorschau

Befehlsgruppe "Kommunikations-E-Mail" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Aktualisieren Sie einen neuen EmailService oder aktualisieren Sie einen vorhandenen EmailService.

az communication email update [--add]
                              [--email-service-name]
                              [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                              [--ids]
                              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                              [--remove]
                              [--resource-group]
                              [--set]
                              [--subscription]
                              [--tags]

Beispiele

Aktualisieren einer E-Mail-Ressource mit Tags

az communication email update -n ResourceName -g ResourceGroup --tags "{tag:tag}"

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>.

--email-service-name --name -n

Der Name der EmailService-Ressource.

--force-string

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

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--ids

Mindestens eine 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.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--remove

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

--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>.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--tags

Ressourcentags. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az communication email wait

Vorschau

Befehlsgruppe "Kommunikations-E-Mail" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung erfüllt ist.

az communication email wait [--created]
                            [--custom]
                            [--deleted]
                            [--email-service-name]
                            [--exists]
                            [--ids]
                            [--interval]
                            [--resource-group]
                            [--subscription]
                            [--timeout]
                            [--updated]

Optionale Parameter

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Standardwert: False
--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False
--email-service-name --name -n

Der Name der EmailService-Ressource.

--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--ids

Mindestens eine 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.

--interval

Abrufintervall in Sekunden.

Standardwert: 30
--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.