本頁面由 Cloud Translation API 翻譯而成。

Exchange 擴充功能套件

整合版本：8.0

設定整合功能，以便與 Exchange 搭配使用

設定步驟會因整合設定的郵件伺服器而異。

以下是 Microsoft 365 和地端 Exchange 的設定說明 (從 2016 年版本開始，不支援舊版)。

設定整合功能，以便與 Microsoft 365 搭配使用

這項整合功能會使用 PowerShell 指令碼執行作業。您需要在 Google Security Operations 伺服器或使用 Exchange Extension Pack 整合的 Google SecOps 遠端代理程式上安裝 PowerShell 套件。

以下範例說明如何為 CentOS7 設定 PowerShell：

安裝 PowerShell 套件。

> curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/microsoft.repo
> sudo yum install -y powershell

開啟 PowerShell 解譯器，然後安裝 Exchange Online PowerShell V3 和 WSMan 模組：

> pwsh
> Install-Module -Name ExchangeOnlineManagement -RequiredVersion 3.5.0 -Force -Scope AllUsers
> Install-Module -Name PSWSMan
> Install-WSMan
> exit

前往 https://github.com/jborean93/omi/releases，取得 openssl 1.1 的 libmi.so 和 libpsrpclient.so 檔案。將最新版 glibc-1.1.tar.gz 下載到 CentOS 主機。
解壓縮下載的 tar 封存檔：
```
> tar -xzvf glibc-1.1.tar.gz
```
覆寫 /opt/microsoft/powershell/7 目錄中的現有 libmi.so 和 libpsrpclient.so 檔案。

設定帳戶

在 Exchange 系統管理中心，將用於整合的帳戶新增至「探索管理」管理員角色。

指派使用者權限

將「法規遵循資料管理員」角色指派給使用者。

設定整合功能，以便與內部部署的 Exchange 搭配使用

以下操作說明適用於 Exchange 2016，不支援舊版。

這項整合功能會使用 PowerShell 指令碼執行作業。您需要在 Google SecOps 伺服器或使用 Exchange Extension Pack 整合的 Google SecOps 遠端代理程式上，安裝 PowerShell 套件。

以下範例說明如何為 CentOS7 設定 PowerShell：

安裝 PowerShell 套件。

> curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/microsoft.repo
> sudo yum install -y powershell

安裝 gssapi 套件。

如要從 Google SecOps Linux 伺服器或遠端代理程式，透過 PowerShell 工作階段向執行 Exchange 的 Windows 伺服器進行驗證，就必須使用 gssapi 套件。

以下是 CentOS 7 的 gssapi 安裝範例：
```
> sudo yum install -y gssntlmssp
```
在執行 Exchange 的 Windows 伺服器上啟用 PowerShell 遠端處理功能，請參閱 Microsoft 文件中的「Enable-PSRemoting」一文。
在 Exchange 中啟用基本驗證。

這項整合功能使用基本驗證，因此您必須在 Exchange 伺服器中明確啟用這項功能。
設定帳戶。

請在 Exchange 管理中心 (EAC) 控制台中，將要用於整合的帳戶新增至「探索管理」管理員角色。如要執行郵件流程規則動作，請為相關使用者新增傳輸規則角色：
- 前往 EAC 並按一下「權限」。
- 選取並開啟「探索管理」。
- 在「角色」部分中，按一下「新增」，然後選取「傳輸規則」。
- 依序點選「新增」->、「確定」和「儲存」。
- 該角色現在會新增至「已指派的角色」部分。權限可能需要一段時間才會複製完成。

在 Google SecOps 中設定 Exchange 擴充功能套件整合

如需在 Google SecOps 中設定整合功能的詳細操作說明，請參閱「設定整合功能」。

整合參數

請使用下列參數設定整合：

參數顯示名稱	類型	預設值	為必填項目	說明
Exchange 內部部署伺服器位址	字串	x.x.x.x	否	要連線的郵件伺服器位址 (主機名稱或 IP)。
Exchange Office365 合規性 URI	字串	https://ps.compliance.protection.outlook.com/powershell-liveid/	否	用於執行法規遵循作業的 Microsoft 365 安全性與法規遵循中心 PowerShell URI。詳情請參閱「連線至 Security Compliance PowerShell」文件。
Exchange Office365 Online Powershell Uri	字串	https://outlook.office365.com/powershell-liveid	否	用來執行 Microsoft 365 管理作業的 Microsoft 365 線上 Powershell URI。詳情請參閱「連線至 Security Compliance PowerShell」文件。
網域	字串	example.com	否	要在郵件伺服器上驗證的網域。
使用者名稱	字串	使用者	否	用於郵件伺服器驗證的使用者名稱。如果是 Microsoft 365，請提供使用者郵件地址做為使用者名稱。
密碼	密碼	不適用	否	用於郵件伺服器驗證的密碼。
Exchange 是否為地端部署？	核取方塊	已取消勾選	否	指定目標郵件伺服器是否為 Exchange On-Prem。
是否為 Office 365 (Exchange Online)？	核取方塊	已取消勾選	否	指定目標郵件伺服器是否為 Microsoft 365 (Exchange Online)。

動作

刪除法規遵循搜尋

說明

刪除法規遵循搜尋，以及與其相關的擷取結果或清除電子郵件工作。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
法規遵循搜尋名稱	字串	不適用	是	要刪除的法規遵循搜尋名稱。名稱不得包含特殊字元。

參數顯示名稱

類型

預設值

為必填項目

說明

法規遵循搜尋名稱

字串

不適用

是

要刪除的法規遵循搜尋名稱。

名稱不得包含特殊字元。

執行時間

這項操作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

N/A

案件總覽

結果類型	值 / 說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果動作成功，系統會刪除法規遵循搜尋和動作 (is_success=true)：「Action successfully executed and compliance search and any associated with it fetch results or purge emails tasks were deleted.」動作應會失敗並停止執行應對手冊：如果目標是地端 Exchange 或 Microsoft 365，但 Google SecOps 伺服器未安裝 PowerShell：「Failed to execute action because powershell is not installed on Google SecOps server! 請參閱設定說明，瞭解如何安裝 PowerShell。Error is {0}".format(exception.stacktrace) 如果目標是內部部署的 Exchange，但 Google SecOps 伺服器未安裝 gssntlmssp OS 套件：「Failed to execute action because gssntlmssp package is not installed on Google SecOps server! 請參閱設定說明，瞭解如何安裝 PowerShell。Error is {0}".format(exception.stacktrace) 如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「無法執行動作！Error is {0}".format(exception.stacktrace)	一般

結果類型

值 / 說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果動作成功，系統會刪除法規遵循搜尋和動作 (is_success=true)：「Action successfully executed and compliance search and any associated with it fetch results or purge emails tasks were deleted.」

動作應會失敗並停止執行應對手冊：

如果目標是地端 Exchange 或 Microsoft 365，但 Google SecOps 伺服器未安裝 PowerShell：「Failed to execute action because powershell is not installed on Google SecOps server! 請參閱設定說明，瞭解如何安裝 PowerShell。Error is {0}".format(exception.stacktrace)

如果目標是內部部署的 Exchange，但 Google SecOps 伺服器未安裝 gssntlmssp OS 套件：「Failed to execute action because gssntlmssp package is not installed on Google SecOps server! 請參閱設定說明，瞭解如何安裝 PowerShell。Error is {0}".format(exception.stacktrace)

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「無法執行動作！Error is {0}".format(exception.stacktrace)

一般

擷取法規遵循搜尋結果

說明

擷取已完成的法規遵循搜尋結果。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
法規遵循搜尋名稱	字串	不適用	是	法規遵循搜尋的名稱。名稱不得包含特殊字元。
要傳回的電子郵件數量上限	整數	不適用	否	指定動作可傳回的電子郵件數量。
動作完成後是否要移除法規遵循搜尋？	核取方塊	已勾選	否	指定動作完成後，是否應從 Exchange 伺服器移除搜尋動作和任何相關的擷取或清除工作。
建立案件總覽輸出資料表？	核取方塊	已勾選	否	指定動作是否應建立案件總覽輸出資料表。如果「要傳回的電子郵件數量上限」參數設為較大的數字，建議取消勾選這個選項，以提升動作成效。

執行時間

這項操作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

[
  {
    "Location": "test@example.com",
    "Sender": "James Bond",
    "Subject": "search test",
    "Type": "Email",
    "Size": "61772",
    "Received Time": "3/12/2021 9:43:59 AM",
    "Data Link": "data/All/FLDR5402c62d-7730-4c93-8f34-6bxxxxxxxxxx/BATCH0000/MSG192bc965-18c9-4c06-8834-2cxxxxxxxxxx.eml",
    "Name": "test"
  },
  {
    "Location": "test@example.com",
    "Sender": "James Bond",
    "Subject": "search test 2",
    "Type": "Email",
    "Size": "60881",
    "Received Time": "3/12/2021 9:43:59 AM",
    "Data Link": "data/All/FLDR5402c62d-7730-4c93-8f34-6bxxxxxxxxxx/BATCH0000/MSG9eefda9c-b1b5-46f0-8a54-bdxxxxxxxxxx.eml",
    "Name": "test"
  }
]

案件總覽

結果類型	值 / 說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果動作成功且已建立法規遵循動作 (is_success=true)：「動作已成功執行，且已建立擷取法規遵循搜尋結果的工作」動作完成後：「已成功擷取『{0}』的法規遵循搜尋結果」。format(compliance search name) 如果動作無法根據提供的名稱找到法規遵循搜尋 (is_success=false)：「Action was not able to find compliance search {0}」。format(compliance_search_name) 如果動作因其他非重大錯誤而失敗 (is_success=false)：「動作因發生錯誤而未順利完成。Errors information: {0}".format(error.stacktrace) 動作應會失敗並停止執行應對手冊：如果目標是 Exchange On-Prem 或 Microsoft 365，但 Google SecOps 伺服器上未安裝 PowerShell：「Failed to execute action because powershell is not installed on Google SecOps server! 請參閱設定說明，瞭解如何安裝 PowerShell。Error is {0}".format(exception.stacktrace) 如果目標是內部部署的 Exchange，但 Google SecOps 伺服器未安裝 gssntlmssp OS 套件：「Failed to execute action because gssntlmssp package is not installed on Google SecOps server! 請參閱設定說明，瞭解如何安裝 PowerShell。Error is {0}".format(exception.stacktrace) 如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「無法執行動作！Error is {0}".format(exception.stacktrace)	一般
資料表	表格標題：法規遵循搜尋動作結果資料表資料欄：接收時間寄件者收件者主旨	一般

結果類型

值 / 說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果動作成功且已建立法規遵循動作 (is_success=true)：「動作已成功執行，且已建立擷取法規遵循搜尋結果的工作」

動作完成後：「已成功擷取『{0}』的法規遵循搜尋結果」。format(compliance search name)

如果動作無法根據提供的名稱找到法規遵循搜尋 (is_success=false)：「Action was not able to find compliance search {0}」。format(compliance_search_name)

如果動作因其他非重大錯誤而失敗 (is_success=false)：「動作因發生錯誤而未順利完成。Errors information: {0}".format(error.stacktrace)

動作應會失敗並停止執行應對手冊：

如果目標是 Exchange On-Prem 或 Microsoft 365，但 Google SecOps 伺服器上未安裝 PowerShell：「Failed to execute action because powershell is not installed on Google SecOps server! 請參閱設定說明，瞭解如何安裝 PowerShell。Error is {0}".format(exception.stacktrace)

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「無法執行動作！Error is {0}".format(exception.stacktrace)

一般

資料表

表格標題：法規遵循搜尋動作結果

資料表資料欄：

接收時間
寄件者
收件者
主旨

一般

乒乓

說明

使用 Google Security Operations Marketplace 分頁中整合設定頁面提供的參數，測試與 Exchange 或 Microsoft 365 伺服器的連線。

參數

不適用

執行時間

這項操作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

N/A

案件總覽

結果類型	值 / 說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功：「已使用提供的連線參數，成功連線至 Exchange 或 Microsoft 365 伺服器！」動作應會失敗並停止執行應對手冊：如果沒有勾選任何核取方塊 (Microsoft 365/Exchange 內部部署)：「請指定要連線的郵件伺服器類型 - Exchange 內部部署或 Microsoft 365」如果兩個核取方塊都已勾選 (Microsoft 365/內部部署 Exchange)：「一次只能支援一種郵件伺服器類型。請指定要連線的郵件伺服器類型 - Exchange 內部部署或 Microsoft 365」如果目標是 Exchange On-Prem 或 Microsoft 365，但 Google SecOps 伺服器上未安裝 PowerShell：「Failed to execute action because powershell is not installed on Google SecOps server! 請參閱設定說明，瞭解如何安裝 PowerShell。Error is {0}".format(exception.stacktrace) 如果目標是內部部署的 Exchange，但 Google SecOps 伺服器未安裝 gssntlmssp OS 套件：「Failed to execute action because gssntlmssp package is not installed on Google SecOps server! 請參閱設定說明，瞭解如何安裝 PowerShell。Error is {0}".format(exception.stacktrace) 如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「無法執行動作！Error is {0}".format(exception.stacktrace)	一般

結果類型

值 / 說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功：「已使用提供的連線參數，成功連線至 Exchange 或 Microsoft 365 伺服器！」

動作應會失敗並停止執行應對手冊：

如果沒有勾選任何核取方塊 (Microsoft 365/Exchange 內部部署)：「請指定要連線的郵件伺服器類型 - Exchange 內部部署或 Microsoft 365」

如果兩個核取方塊都已勾選 (Microsoft 365/內部部署 Exchange)：「一次只能支援一種郵件伺服器類型。請指定要連線的郵件伺服器類型 - Exchange 內部部署或 Microsoft 365」

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「無法執行動作！Error is {0}".format(exception.stacktrace)

一般

清除法規遵循搜尋結果

說明

清除法規遵循搜尋功能找到的電子郵件。

參數

參數顯示名稱

類型

預設值

為必填項目

說明

法規遵循搜尋名稱

字串

不適用

是

法規遵循搜尋的名稱。

名稱不得包含特殊字元。

要對已刪除的電子郵件執行 HardDelete 嗎？

核取方塊

已取消勾選

否

指定是否應執行 HardDelete。

這個選項僅適用於 Microsoft 365，並會將電子郵件標示為從信箱永久移除。

動作完成後是否要移除法規遵循搜尋？

核取方塊

已勾選

否

指定動作完成後，是否應從 Exchange 伺服器移除搜尋動作和任何相關的擷取或清除工作。

執行時間

這項操作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

{
  "Item count": "5",
  "Purge Type": "SoftDelete"
}

案件總覽

結果類型	值 / 說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果動作成功且已建立法規遵循動作 (is_success=true)：「Action was executed successfully and task to purge emails found with the compliance search is created」(動作已順利執行，且已建立工作，可清除法規遵循搜尋找到的電子郵件) 完成這項操作後：「已成功清除『{0}』的法規遵循搜尋結果」。format(compliance search name) 如果動作無法根據提供的名稱找到法規遵循搜尋 (is_success=false)：「Action was not able to find compliance search {0}」。format(compliance_search_name) 如果動作未傳回任何結果：「法規遵循搜尋『{0}』未傳回任何結果。請更新搜尋結果，或編輯法規遵循搜尋查詢並再次執行搜尋。".format(compliance search name) 動作應會失敗並停止執行應對手冊：如果目標是地端 Exchange 或 Microsoft 365，但 Google SecOps 伺服器未安裝 PowerShell：「Failed to execute action because powershell is not installed on Google SecOps server! 請參閱設定說明，瞭解如何安裝 PowerShell。Error is {0}".format(exception.stacktrace) 如果目標是內部部署的 Exchange，但 Google SecOps 伺服器未安裝 gssntlmssp OS 套件：「Failed to execute action because gssntlmssp package is not installed on Google SecOps server! 請參閱設定說明，瞭解如何安裝 PowerShell。Error is {0}".format(exception.stacktrace) 如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「無法執行動作！Error is {0}".format(exception.stacktrace)	一般

結果類型

值 / 說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果動作成功且已建立法規遵循動作 (is_success=true)：「Action was executed successfully and task to purge emails found with the compliance search is created」(動作已順利執行，且已建立工作，可清除法規遵循搜尋找到的電子郵件)

完成這項操作後：「已成功清除『{0}』的法規遵循搜尋結果」。format(compliance search name)

如果動作無法根據提供的名稱找到法規遵循搜尋 (is_success=false)：「Action was not able to find compliance search {0}」。format(compliance_search_name)

如果動作未傳回任何結果：「法規遵循搜尋『{0}』未傳回任何結果。請更新搜尋結果，或編輯法規遵循搜尋查詢並再次執行搜尋。".format(compliance search name)

動作應會失敗並停止執行應對手冊：

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「無法執行動作！Error is {0}".format(exception.stacktrace)

一般

執行法規遵循搜尋

說明

根據提供的搜尋條件執行 Exchange 合規性搜尋。如果勾選「擷取法規遵循搜尋結果」核取方塊，這項動作會傳回搜尋結果，與「擷取法規遵循搜尋結果」動作類似。

Exchange 法規遵循搜尋提供快速機制，可在多個信箱中搜尋，對於擁有 1000 個以上信箱的大型機構而言，這項功能非常實用。

如果勾選「擷取法規遵循搜尋結果？」核取方塊，系統最多會顯示 200 個元素，但實際搜尋結果可能包含更多發現項目。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
法規遵循搜尋名稱	字串	不適用	是	法規遵循搜尋的名稱。名稱不得包含特殊字元。
主旨篩選器	字串	不適用	否	篩選條件，指定要搜尋電子郵件的主旨。
寄件者篩選器	字串	不適用	否	篩選條件：指定必要電子郵件的寄件者。
收件者篩選器	字串	不適用	否	篩選條件：指定應接收必要電子郵件的對象。
運算子	DDL	且	是	用來從上述條件建構查詢的運算子。
時間範圍 (小時)	字串	不適用	否	以小時為單位的時間間隔，用於搜尋電子郵件。
搜尋電子郵件的位置	字串	不適用	是	要搜尋電子郵件的位置，可以是下列其中一種：以半形逗號分隔的信箱清單通訊群組或已啟用郵件功能的安全性群組 All - for all mailboxes in organization
擷取法規遵循搜尋結果？	核取方塊	已取消勾選	否	指定動作是否應立即擷取法規遵循搜尋結果。最多顯示 200 個元素，但實際搜尋結果可能包含更多發現項目。
要傳回的電子郵件數量上限	整數	不適用	否	指定動作可傳回的電子郵件數量。
建立案件總覽輸出資料表？	核取方塊	已勾選	否	指定動作是否應建立案件總覽輸出資料表。如果「要傳回的電子郵件數量上限」參數設為較大的數字，建議取消勾選這個選項，以提升動作成效。
進階查詢	字串	不適用	否	請提供要執行法規遵循搜尋的查詢，而非主旨、寄件者或收件者篩選器。詳情請參閱「關鍵字查詢語言 (KQL) 語法參考資料」和「Exchange 搜尋服務編列索引的郵件屬性」文件。

執行時間

這項操作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

{
  "Name": "test",
  "RunBy": "James Bond",
  "JobEndTime": "2021-03-18T12:42:49.92",
  "Status": "Completed"
}

案件總覽

結果類型	值 / 說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果動作成功且已建立法規遵循項目 (is_success=true)：「動作已成功執行，並已建立法規遵循項目搜尋」動作完成搜尋後：「Compliance Search {0} successfully completed」(「法規遵循搜尋『{0}』已順利完成」).format(法規遵循搜尋名稱) 如果已勾選擷取法規遵循搜尋結果的核取方塊：「已成功擷取『{0}』的法規遵循搜尋結果」。format(法規遵循搜尋名稱) 如果已勾選擷取法規遵循搜尋結果的核取方塊，但動作未傳回任何結果：「法規遵循搜尋『{0}』未傳回任何結果。請更新搜尋結果，或編輯法規遵循搜尋查詢並再次執行搜尋。".format(compliance search name) 動作應會失敗並停止執行應對手冊：如果目標是 Exchange On-Prem 或 Microsoft 365，但 Google SecOps 伺服器上未安裝 PowerShell：「Failed to execute action because powershell is not installed on Google SecOps server! 請參閱設定說明，瞭解如何安裝 PowerShell。Error is {0}".format(exception.stacktrace) 如果目標是內部部署的 Exchange，但 Google SecOps 伺服器未安裝 gssntlmssp OS 套件：「Failed to execute action because gssntlmssp package is not installed on Google SecOps server! 請參閱設定說明，瞭解如何安裝 PowerShell。Error is {0}".format(exception.stacktrace) 如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「無法執行動作！Error is {0}".format(exception.stacktrace)	一般

結果類型

值 / 說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果動作成功且已建立法規遵循項目 (is_success=true)：「動作已成功執行，並已建立法規遵循項目搜尋」

動作完成搜尋後：「Compliance Search {0} successfully completed」(「法規遵循搜尋『{0}』已順利完成」).format(法規遵循搜尋名稱)

如果已勾選擷取法規遵循搜尋結果的核取方塊：「已成功擷取『{0}』的法規遵循搜尋結果」。format(法規遵循搜尋名稱)

如果已勾選擷取法規遵循搜尋結果的核取方塊，但動作未傳回任何結果：「法規遵循搜尋『{0}』未傳回任何結果。請更新搜尋結果，或編輯法規遵循搜尋查詢並再次執行搜尋。".format(compliance search name)

動作應會失敗並停止執行應對手冊：

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「無法執行動作！Error is {0}".format(exception.stacktrace)

一般

將網域新增至 Exchange-Siemplify 郵件流程規則

說明

這項動作會將網域清單做為參數，並建立新規則，從 Exchange 伺服器篩選網域。您可以使用規則參數，在參數中修改要採取的動作。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
網域	字串	不適用	否	在以逗號分隔的清單中，指定要新增至規則的網域。
要新增網域的規則	DDL	Siemplify - Domains List - Permanently Delete	是	指定要將網域新增至哪個規則。如果規則不存在，動作會在缺少規則的位置建立規則。

參數顯示名稱

類型

預設值

為必填項目

說明

網域

字串

不適用

否

在以逗號分隔的清單中，指定要新增至規則的網域。

要新增網域的規則

DDL

Siemplify - Domains List - Permanently Delete

是

指定要將網域新增至哪個規則。

如果規則不存在，動作會在缺少規則的位置建立規則。

執行時間

這項操作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

{
  "success": [
    "test1.com",
    "test2.com"
  ],
  "already_available": [
    "test3.com"
  ],
  "invalid": [
    "invalid"
  ]
}

案件總覽

結果類型	值 / 說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功 (規則已相應更新，輸入內容正確)：「已將下列輸入內容新增至相應規則：網域： successfull_domains 已更新規則： Rules_updated_names_list 如果至少有一項輸入內容不正確 (參數中的電子郵件地址無效、實體名稱中的郵件無效)：「無法將下列輸入內容新增至規則：」+ Unsuccessful_email_addresses 動作應失敗並停止執行應對手冊：如果系統回報錯誤：「Error performing "Add Domains to Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)	一般

結果類型

值 / 說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功 (規則已相應更新，輸入內容正確)：「已將下列輸入內容新增至相應規則：
網域：
successfull_domains

已更新規則：
Rules_updated_names_list

如果至少有一項輸入內容不正確 (參數中的電子郵件地址無效、實體名稱中的郵件無效)：「無法將下列輸入內容新增至規則：」+
Unsuccessful_email_addresses

動作應失敗並停止執行應對手冊：

如果系統回報錯誤：「Error performing "Add Domains to Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)

一般

將寄件者新增至 Exchange-Siemplify 郵件流程規則

說明

這項動作會取得電子郵件地址清單做為參數，或使用電子郵件規則運算式處理使用者實體 (如果未提供參數)，並可建立新規則，篩除來自 Exchange 伺服器的寄件者。您可以使用規則參數，在參數中修改動作。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
電子郵件地址	字串	不適用	否	在以半形逗號分隔的清單中，指定要新增至規則的電子郵件地址。如未提供任何參數，動作會使用使用者實體。
要將寄件者新增至哪個規則	DDL	Siemplify - Senders List - Permanently Delete	是	指定要將寄件者新增至哪個規則。如果規則不存在，動作會在缺少規則的位置建立規則。
是否也應將寄件者的網域新增至對應的網域清單規則？	核取方塊	已取消勾選	否	指定動作是否應自動擷取所提供電子郵件地址的網域，並將這些網域新增至相應的網域規則 (網域的規則動作相同)。

參數顯示名稱

類型

預設值

為必填項目

說明

電子郵件地址

字串

不適用

否

在以半形逗號分隔的清單中，指定要新增至規則的電子郵件地址。

如未提供任何參數，動作會使用使用者實體。

要將寄件者新增至哪個規則

DDL

Siemplify - Senders List - Permanently Delete

是

指定要將寄件者新增至哪個規則。

如果規則不存在，動作會在缺少規則的位置建立規則。

是否也應將寄件者的網域新增至對應的網域清單規則？

核取方塊

已取消勾選

否

指定動作是否應自動擷取所提供電子郵件地址的網域，並將這些網域新增至相應的網域規則 (網域的規則動作相同)。

執行時間

如果電子郵件的 regex 對使用者實體有效，且未提供任何參數，這項動作就會對使用者實體生效。

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

{
  "success": [
    "test1@example.com",
    "test2@example.com"
  ],
  "already_available": [
    "test3@example.com"
  ],
  "invalid": [
    "invalid"
  ]
}

案件總覽

結果類型	值 / 說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功 (規則已相應更新，輸入內容正確)：「已將下列輸入內容新增至相應規則：電子郵件地址：」+ Successful_email_addresses+ 「網域：」+ successfull_domains+ 「更新的規則：」+ rules_updated_names_list 如果至少有一項輸入內容不正確 (參數中的電子郵件地址無效、實體名稱中的電子郵件地址無效)：「無法將下列輸入內容新增至規則：」+ Unsuccessful_email_addresses 動作應失敗並停止執行應對手冊：如果系統回報錯誤：「Error performing "Add Senders to Exchange-Siemplify Mail Flow Rule" action : {0}".format(exception.stacktrace)	一般

結果類型

值 / 說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功 (規則已相應更新，輸入內容正確)：「已將下列輸入內容新增至相應規則：
電子郵件地址：」+
Successful_email_addresses+
「網域：」+
successfull_domains+

「更新的規則：」+
rules_updated_names_list

如果至少有一項輸入內容不正確 (參數中的電子郵件地址無效、實體名稱中的電子郵件地址無效)：「無法將下列輸入內容新增至規則：」+
Unsuccessful_email_addresses

動作應失敗並停止執行應對手冊：

如果系統回報錯誤：「Error performing "Add Senders to Exchange-Siemplify Mail Flow Rule" action : {0}".format(exception.stacktrace)

一般

刪除 Exchange-Siemplify 郵件流程規則

說明

這個動作會將規則名稱做為參數，然後刪除該規則。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
要刪除的規則名稱	DDL	Siemplify - Senders List - Permanently Delete 可能的值： Siemplify - Senders List - Permanently Delete Siemplify - Domains List - Permanently Delete 所有可用的 Exchange-Siemplify 郵件流程規則	是	指定要徹底刪除的規則名稱。

參數顯示名稱

類型

預設值

為必填項目

說明

要刪除的規則名稱

DDL

Siemplify - Senders List - Permanently Delete

可能的值：

Siemplify - Senders List - Permanently Delete
Siemplify - Domains List - Permanently Delete
所有可用的 Exchange-Siemplify 郵件流程規則

是

指定要徹底刪除的規則名稱。

執行時間

這項操作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

N/A

案件總覽

結果類型	值 / 說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：已成功刪除規則：「已成功刪除下列規則：」succesful_rule_names 如果 Exchange 中找不到規則：「無法刪除下列規則：『unseccessful_rule_names』，因為 Exchange 中找不到這些規則。請確認您已選擇適當的規則名稱，然後再試一次。」如果 Exchange 中沒有找到任何規則：「Could not delete any of the provided rule names, since they were not found in Exchange. 請確認您已選擇適當的規則名稱，然後再試一次。」動作應失敗並停止執行應對手冊：如果系統回報錯誤：「Error performing "Delete Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)	一般

結果類型

值 / 說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

已成功刪除規則：「已成功刪除下列規則：」succesful_rule_names

如果 Exchange 中找不到規則：「無法刪除下列規則：『unseccessful_rule_names』，因為 Exchange 中找不到這些規則。請確認您已選擇適當的規則名稱，然後再試一次。」

如果 Exchange 中沒有找到任何規則：「Could not delete any of the provided rule names, since they were not found in Exchange. 請確認您已選擇適當的規則名稱，然後再試一次。」

動作應失敗並停止執行應對手冊：

如果系統回報錯誤：「Error performing "Delete Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)

一般

列出 Exchange-Siemplify 郵件流程規則

說明

這個動作會將規則名稱做為參數並列出。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
要列出的規則名稱	DDL	Siemplify - Senders List - Permanently Delete 可能的值： Siemplify - Senders List - Permanently Delete Siemplify - Domains List - Permanently Delete 所有可用的 Exchange-Siemplify 郵件流程規則	是	指定要列出的規則名稱。

參數顯示名稱

類型

預設值

為必填項目

說明

要列出的規則名稱

DDL

Siemplify - Senders List - Permanently Delete

可能的值：

Siemplify - Senders List - Permanently Delete
Siemplify - Domains List - Permanently Delete
所有可用的 Exchange-Siemplify 郵件流程規則

是

指定要列出的規則名稱。

執行時間

這項操作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

[
  {
    "Priority": 0,
    "ManuallyModified": false,
    "Description": "If the message:\r\n\tIs received from 'test@example1.com' or 'test@example2.com'\r\nTake the following actions:\r\n\tDelete the message without notifying the recipient or sender\r\n",
    "Conditions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.FromPredicate"
    ],
    "Actions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.DeleteMessageAction"
    ],
    "State": "Enabled",
    "Mode": "Enforce",
    "FromAddressContainsWords": null,
    "Identity": "Siemplify - Senders List - Permanently Delete",
    "Name": "Siemplify - Senders List - Permanently Delete",
    "DistinguishedName": "CN=Siemplify - Senders List - Permanently Delete,CN=TransportVersioned,CN=Rules,CN=Transport Settings,CN=mwc,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=exlab,DC=local",
    "IsValid": true,
    "From": [
      "test@example1.com",
      "test@example2.com"
    ],
    "Guid": "xxxxx426-b665-41f9-82e0-0f1fd63xxxxx",
    "ImmutableId": "xxxxx426-b665-41f9-82e0-0f1fd63xxxxx",
    "WhenChanged": "/Date(1621952909000)/",
    "ExchangeVersion": "0.1 (8.0.535.0)",
    "OrganizationId": "",
    "ObjectState": "Unchanged"
  },
  {
    "Priority": 1,
    "ManuallyModified": false,
    "Description": "If the message:\r\n\tIncludes these words in the sender's address: 'example1.com' or 'example2.com'\r\nTake the following actions:\r\n\tDelete the message without notifying the recipient or sender\r\n",
    "Conditions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.FromAddressContainsPredicate"
    ],
    "Actions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.DeleteMessageAction"
    ],
    "State": "Enabled",
    "Mode": "Enforce",
    "FromAddressContainsWords": [
      "example1.com",
      "example2.com"
    ],
    "Identity": "Siemplify - Domains List - Permanently Delete",
    "Name": "Siemplify - Domains List - Permanently Delete",
    "DistinguishedName": "CN=Siemplify - Domains List - Permanently Delete,CN=TransportVersioned,CN=Rules,CN=Transport Settings,CN=mwc,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=exlab,DC=local",
    "IsValid": true,
    "From": null,
    "Guid": "xxxxx697-e143-41aa-8dee-b783a78xxxxx",
    "ImmutableId": "xxxxx697-e143-41aa-8dee-b783a78xxxxx",
    "WhenChanged": "/Date(1621952960000)/",
    "ExchangeVersion": "0.1 (8.0.535.0)",
    "OrganizationId": "",
    "ObjectState": "Unchanged"
  }
]

案件總覽

結果類型	值 / 說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：成功找到規則：「已成功列出下列規則：」succesful_rule_names 如果 Exchange 中找不到規則：「無法列出下列規則：『』+unseccessful_rule_names+，因為系統在 Exchange 中找不到這些規則。請確認您已選擇適當的規則名稱，然後再試一次。」如果 Exchange 中找不到任何規則：「由於在 Exchange 中找不到您提供的規則名稱，因此無法列出任何規則。請確認您已選擇適當的規則名稱，然後再試一次。」動作應會失敗並停止執行應對手冊：如果系統回報錯誤：「Error performing "List Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)	一般

結果類型

值 / 說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

成功找到規則：「已成功列出下列規則：」succesful_rule_names

如果 Exchange 中找不到規則：「無法列出下列規則：『』+unseccessful_rule_names+，因為系統在 Exchange 中找不到這些規則。請確認您已選擇適當的規則名稱，然後再試一次。」

如果 Exchange 中找不到任何規則：「由於在 Exchange 中找不到您提供的規則名稱，因此無法列出任何規則。請確認您已選擇適當的規則名稱，然後再試一次。」

動作應會失敗並停止執行應對手冊：

如果系統回報錯誤：「Error performing "List Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)

一般

從 Exchange-Siemplify 郵件流程規則中移除網域

說明

這項動作會將網域清單做為參數，並從現有規則中移除提供的網域。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
網域	字串	不適用	否	以半形逗號分隔的清單指定要從規則中移除的網域。如果未提供任何參數，動作會與實體搭配運作。
要從中移除網域的規則	DDL	Siemplify - Domains List - Permanently Delete	是	指定要移除網域的規則。如果規則不存在，系統不會採取任何動作。
從所有可用規則中移除網域	核取方塊	已取消勾選	否	指定動作是否應在所有 Google SecOps 郵件流程規則中尋找提供的網域。

參數顯示名稱

類型

預設值

為必填項目

說明

網域

字串

不適用

否

以半形逗號分隔的清單指定要從規則中移除的網域。

如果未提供任何參數，動作會與實體搭配運作。

要從中移除網域的規則

DDL

Siemplify - Domains List - Permanently Delete

是

指定要移除網域的規則。

如果規則不存在，系統不會採取任何動作。

從所有可用規則中移除網域

核取方塊

已取消勾選

否

指定動作是否應在所有 Google SecOps 郵件流程規則中尋找提供的網域。

執行時間

這項操作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

{
  "success": [
    "test1.com",
    "test2.com"
  ],
  "didn't_exist": [
    "test3.com"
  ],
  "invalid": [
    "invalid"
  ]
}

案件總覽

結果類型	值 / 說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功 (規則已相應更新，輸入內容正確無誤)：「已從相應規則中移除下列輸入內容：」網域： successfull_domains 已更新規則： Rules_updated_names_list 動作應失敗並停止執行應對手冊：如果系統回報錯誤：「Error performing "Remove Domains from Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)	一般

結果類型

值 / 說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功 (規則已相應更新，輸入內容正確無誤)：「已從相應規則中移除下列輸入內容：」
網域：
successfull_domains

已更新規則：
Rules_updated_names_list

動作應失敗並停止執行應對手冊：

如果系統回報錯誤：「Error performing "Remove Domains from Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)

一般

從 Exchange-Siemplify 郵件流程規則中移除寄件者

說明

這項動作會取得寄件者清單做為參數，或對使用者實體執行動作 (如果未提供參數)，並可從現有規則中移除提供的寄件者。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
寄件者	字串	不適用	否	以半形逗號分隔的清單指定要從規則中移除的寄件者。如果未提供任何參數，動作會與實體搭配運作。
要移除寄件者的規則	DDL	Siemplify 寄件者清單 - 永久刪除	是	指定要從中移除寄件者的規則。如果規則不存在，系統不會採取任何動作。
是否也應從對應的網域清單規則中移除寄件者的網域？	核取方塊	已取消勾選	否	指定動作是否應自動取得所提供電子郵件地址的網域，並從對應的網域規則中移除這些網域 (網域的規則動作相同)。

參數顯示名稱

類型

預設值

為必填項目

說明

寄件者

字串

不適用

否

以半形逗號分隔的清單指定要從規則中移除的寄件者。

如果未提供任何參數，動作會與實體搭配運作。

要移除寄件者的規則

DDL

Siemplify 寄件者清單 - 永久刪除

是

指定要從中移除寄件者的規則。

如果規則不存在，系統不會採取任何動作。

是否也應從對應的網域清單規則中移除寄件者的網域？

核取方塊

已取消勾選

否

指定動作是否應自動取得所提供電子郵件地址的網域，並從對應的網域規則中移除這些網域 (網域的規則動作相同)。

執行時間

這項操作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

{
  "success": [
    "test1@example.com",
    "test2@example.com"
  ],
  "didn't_exist": [
    "test3@example.com"
  ],
  "invalid": [
    "invalid"
  ]
}

案件總覽

結果類型	值 / 說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功 (規則會相應更新，輸入內容正確無誤)：訊息：「已從相應規則中移除下列輸入內容：」寄件者： successfull_senders 已更新規則： rules_updated_names_list 如果至少有一項輸入內容不正確 (參數中的電子郵件地址無效、實體名稱中的電子郵件地址無效)：「無法將下列輸入內容新增至規則：」+ Unsuccessful_email_addresses 動作應失敗並停止執行應對手冊：如果系統回報錯誤：「Error performing "Remove Senders from Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)	一般

結果類型

值 / 說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功 (規則會相應更新，輸入內容正確無誤)：訊息：「已從相應規則中移除下列輸入內容：」
寄件者：
successfull_senders

已更新規則：
rules_updated_names_list

動作應失敗並停止執行應對手冊：

如果系統回報錯誤：「Error performing "Remove Senders from Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)

一般

還有其他問題嗎？向社群成員和 Google SecOps 專業人員尋求答案。