az communication email

注意

此參考是 Azure CLI 通訊延伸模組的一部分（2.59.0 版或更高版本）。 擴充功能會在您第一次執行 az communication email 命令時自動安裝。 深入了解擴充功能。

管理通訊電子郵件。

命令

名稱	Description	類型	狀態
az communication email create	建立新的 EmailService 或更新現有的 EmailService。	副檔名	GA
az communication email delete	刪除以刪除 EmailService。	副檔名	GA
az communication email domain	管理通訊電子郵件網域。	副檔名	GA
az communication email domain cancel-verification	取消 DNS 記錄的驗證。	副檔名	GA
az communication email domain create	在父 EmailService 資源下建立新的 Domains 資源，或更新現有的網域資源。	副檔名	GA
az communication email domain delete	刪除以刪除網域資源。	副檔名	GA
az communication email domain initiate-verification	起始 DNS 記錄的驗證。	副檔名	GA
az communication email domain list	列出在父 EmailServices 資源下列出所有網域資源的要求。	副檔名	GA
az communication email domain sender-username	管理通訊電子郵件網域發件者-用戶名稱。	副檔名	GA
az communication email domain sender-username create	在父網域資源下建立新的 SenderUsername 資源，或更新現有的 SenderUsername 資源。	副檔名	GA
az communication email domain sender-username delete	刪除以刪除 SenderUsernames 資源。	副檔名	GA
az communication email domain sender-username list	列出網域資源的所有有效寄件者用戶名稱。	副檔名	GA
az communication email domain sender-username show	取得網域資源的有效寄件者用戶名稱。	副檔名	GA
az communication email domain sender-username update	在父網域資源下更新新的 SenderUsername 資源，或更新現有的 SenderUsername 資源。	副檔名	GA
az communication email domain show	取得網域資源及其屬性。	副檔名	GA
az communication email domain update	在父 EmailService 資源下更新新的網域資源，或更新現有的網域資源。	副檔名	GA
az communication email domain wait	將 CLI 置於等候狀態，直到符合條件為止。	副檔名	GA
az communication email list	列出列出訂用帳戶中所有資源的要求。	副檔名	GA
az communication email send	傳送電子郵件並取得最終狀態。	副檔名	GA
az communication email show	取得 EmailService 及其屬性。	副檔名	GA
az communication email update	更新新的 EmailService 或更新現有的 EmailService。	副檔名	GA
az communication email wait	將 CLI 置於等候狀態，直到符合條件為止。	副檔名	GA

az communication email create

建立新的 EmailService 或更新現有的 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]

範例

使用標籤建立電子郵件資源

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

必要參數

--data-location

電子郵件服務儲存待用數據的位置。

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

EmailService 資源的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--location -l

未指定資源所在的地理位置，將會使用資源群組的位置。

預設值: Global

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--tags

資源標籤。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az communication email delete

刪除以刪除 EmailService。

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

範例

刪除電子郵件資源

az communication email delete -n ResourceName -g ResourceGroup

選擇性參數

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

EmailService 資源的名稱。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--yes -y

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az communication email list

列出列出訂用帳戶中所有資源的要求。

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

範例

從訂用帳戶取得所有資源

az communication email list --subscription SubscriptionId

從資源群組取得所有資源

az communication email list -g ResourceGroup

選擇性參數

--max-items

命令輸出中要傳回的項目總數。 如果可用的專案總數超過指定的值，則會在命令的輸出中提供令牌。 若要繼續分頁，請在後續命令的自變數中 --next-token 提供令牌值。

--next-token

標記，指定要開始分頁的位置。 這是先前截斷回應中的令牌值。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az communication email send

傳送電子郵件並取得最終狀態。

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

範例

從現有網域傳送電子郵件

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

必要參數

--sender

來自已驗證網域的發件者電子郵件位址。

--subject

電子郵件訊息的主旨。

選擇性參數

--attachment-types

以相同順序排列的電子郵件附件類型清單。 每個附件都需要。 已知值為：avi、bmp、doc、docm、docx、gif、jpeg、mp3、one、pdf、png、ppsm、ppsx、ppt、pptm、pptx、pub、rpmsg、rtf、tif、txt、vsd、wav、wma、xlsb、xlsm 和 xlsx。

--attachments

電子郵件附件清單。 選擇性。

--bcc

盲目碳複製電子郵件位址。

--cc

副本電子郵件位址。

--connection-string

通訊 連接字串。 環境變數：AZURE_COMMUNICATION_CONNECTION_STRING。

--disable-tracking

指出是否應針對此特定要求停用用戶參與追蹤。 只有在控制平面中已啟用資源層級的用戶參與追蹤設定時，才適用這項設定。 選擇性。

接受的值: false, true

預設值: False

--html

電子郵件訊息的 Html 版本。 選擇性。

--importance

電子郵件的重要性類型。 已知值為：高、一般和低。 預設值為一般。 選擇性。

接受的值: high, low, normal

預設值: normal

--reply-to

回覆電子郵件地址。 選擇性。

--text

電子郵件訊息的純文字版本。 選擇性。

--to

如果有多個電子郵件位址，請以逗號分隔。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az communication email show

取得 EmailService 及其屬性。

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

範例

取得電子郵件服務的屬性

az communication email show -n ResourceName -g ResourceGroup

選擇性參數

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

EmailService 資源的名稱。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az communication email update

更新新的 EmailService 或更新現有的 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]

範例

使用標籤更新電子郵件資源

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

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。 範例：--add property.listProperty <key=value、string 或 JSON 字串>。

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

EmailService 資源的名稱。

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--remove

從清單中移除屬性或專案。 範例：--remove property.list OR --remove 屬性ToRemove。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--set

指定要設定的屬性路徑和值，以更新物件。 範例：--set property1.property2=。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--tags

資源標籤。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az communication email wait

將 CLI 置於等候狀態，直到符合條件為止。

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

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False

--custom

等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False

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

EmailService 資源的名稱。

--exists

等候資源存在。

預設值: False

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--interval

輪詢間隔以秒為單位。

預設值: 30

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--timeout

以秒為單位的等候上限。

預設值: 3600

--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。