az security contact

此命令群組處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

檢視您的安全性聯繫人。

命令

名稱	Description	類型	狀態
az security contact create	建立安全性聯繫人。	核心	預覽
az security contact delete	刪除訂用帳戶的安全性聯繫人設定。	核心	預覽
az security contact list	列出訂用帳戶的所有安全性聯繫人組態。	核心	預覽
az security contact show	取得訂用帳戶的預設安全性聯繫人設定。	核心	預覽
az security contact update	更新訂用帳戶的安全性聯繫人設定。	核心	預覽

az security contact create

預覽

命令群組 『az security contact』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

建立安全性聯繫人。

az security contact create --name
                           [--alert-notifications]
                           [--emails]
                           [--notifications-by-role]
                           [--phone]

範例

建立安全性聯繫人。

az security contact create -n 'default' --emails 'john@contoso.com;jane@contoso.com' --phone '214-275-4038' --notifications-by-role '{"state":"On","roles":["Owner"]}' --alert-notifications '{"state":"On","minimalSeverity":"Low"}'

必要參數

--name --security-contact-name -n

安全性聯繫人對象的名稱。

選擇性參數

--alert-notifications

定義是否傳送有關新安全性警示的電子郵件通知支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--emails

電子郵件地址清單，這些電子郵件位址會透過此安全性聯繫人中定義的設定，從 Microsoft Defender for Cloud 取得通知。

--notifications-by-role

定義是否要將適用於雲端Microsoft Defender 的電子郵件通知傳送給訂用帳戶上具有特定 RBAC 角色的人員。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--phone

安全性聯繫人的電話號碼。

全域參數

--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 security contact delete

預覽

命令群組 『az security contact』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

刪除訂用帳戶的安全性聯繫人設定。

az security contact delete [--ids]
                           [--name]
                           [--subscription]
                           [--yes]

範例

刪除安全性聯繫人。

az security contact delete -n "default"

選擇性參數

--ids

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

--name --security-contact-name -n

安全性聯繫人對象的名稱。

--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 security contact list

預覽

命令群組 『az security contact』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

列出訂用帳戶的所有安全性聯繫人組態。

az security contact list [--max-items]
                         [--next-token]

範例

取得所有安全性聯繫人。

az security contact list

選擇性參數

--max-items

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

--next-token

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

全域參數

--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 security contact show

預覽

命令群組 『az security contact』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

取得訂用帳戶的預設安全性聯繫人設定。

az security contact show [--ids]
                         [--name]
                         [--subscription]

範例

取得安全性聯繫人。

az security contact show -n "default1"

選擇性參數

--ids

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

--name --security-contact-name -n

安全性聯繫人對象的名稱。

--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 security contact update

預覽

命令群組 『az security contact』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

更新訂用帳戶的安全性聯繫人設定。

az security contact update [--add]
                           [--alert-notifications]
                           [--emails]
                           [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                           [--ids]
                           [--name]
                           [--notifications-by-role]
                           [--phone]
                           [--remove]
                           [--set]
                           [--subscription]

範例

更新安全性聯繫人。

az security contact update -n 'default' --emails 'john1@contoso.com;jane@contoso.com' --phone '214-275-4038' --notifications-by-role '{"state":"On","roles":["Owner"]}' --alert-notifications '{"state":"On","minimalSeverity":"Low"}'

選擇性參數

--add

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

--alert-notifications

定義是否傳送有關新安全性警示的電子郵件通知支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--emails

電子郵件地址清單，這些電子郵件位址會透過此安全性聯繫人中定義的設定，從 Microsoft Defender for Cloud 取得通知。

--force-string

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

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

--ids

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

--name --security-contact-name -n

安全性聯繫人對象的名稱。

--notifications-by-role

定義是否要將適用於雲端Microsoft Defender 的電子郵件通知傳送給訂用帳戶上具有特定 RBAC 角色的人員。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--phone

安全性聯繫人的電話號碼。

--remove

從清單中移除屬性或專案。 範例： --remove property.list <indexToRemove> 或 --remove propertyToRemove。

--set

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

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