共用方式為


IA-Connect JML

IA-Connect 是一個機器人流程自動化“RPA”平台,它將 RPA 功能從雲添加到本地虛擬機或通過 Citrix 或 Microsoft 遠程桌面“RDS”連接。 這是用於自動化 Joiner、Mover、Leaver 流程的模塊。

此連接器適用於以下產品和區域:

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 (DoD)
Power Apps 進階 除下列區域外的所有 Power Apps 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人​​
名稱 創世紀實驗室
URL https://www.ultima.com/ultima-labs
Email IAConnect@ultima.com
連接器中繼資料
Publisher 創世紀商業
網站 https://www.ultima.com/ultima-labs
隱私策略 https://www.ultima.com/privacy-policy
類別 IT運營;生產力

IA-Connect 是一個機器人流程自動化 (RPA) 平台,可將 RPA 功能從 Power Automate 雲端流程新增至內部部署虛擬機器,或透過 Citrix 或 Microsoft 遠端桌面 (RDS) 連線。 IA-Connect 連接器提供超過 800 個動作,可讓您直接從 Power Automate 雲端流程自動化每種類型的內部部署應用程式。 所有 IA-Connect 動作都可以直接從 Power Automate 雲端流程取得,從而在雲端型應用程式和內部部署應用程式之間輕鬆整合,並能夠在 RPA 流程中利用現有的 Power Automate 條件、迴圈、動態內容、運算式和例外狀況處理。 利用 IA-Connect Connectors 還可以從 Flow 執行歷史記錄中提供完整的執行歷史記錄和可審計性,同時也無需使用單獨的應用程式/控制台/工作室來開發 RPA 流程。

先決條件

若要使用任何 IA-Connect 連接器,您必須安裝 IA-Connect 軟體。 這是 30 天的免費測試,之後您將需要 IA-Connect 許可證。

IA-Connect 軟體由兩個主要組件組成:

  • IA-Connect Orchestrator,這是 Azure WebApp,您將在自己的 Azure 租用戶中裝載。 這會處理 RPA 流程到一或多個內部部署或雲端虛擬機器的路由和安全性。

  • IA-Connect 代理程式和導向器,安裝在可存取您要自動化軟體的虛擬機器上。 此外,IA-Connect 代理程式可以在 Citrix 或 Microsoft 遠端桌面服務 (RDS) 工作階段內執行,其中 RPA 命令會透過虛擬通道傳遞到遠端工作階段中以執行。 IA-Connect 代理程式可以從網路共用執行,而且不需要安裝。

可用的 IA-Connect 連接器

可用的 IA-Connect 連接器包括:

  • IA-Connect 動態程式碼
  • IA-Connect 爪哇
  • IA-Connect JML
  • IA-Connect 大型主機
  • IA-Connect Microsoft辦公室
  • IA-Connect SAP GUI
  • IA-Connect 場
  • IA-Connect 使用者介面
  • IA-Connect 網頁瀏覽器

如何取得認證

為了獲得您的許可證並開始您的 30 天免費試用,請在我們的網站上提交請求 (https://www.ultima.com/IA-Connect/Power-Automate)。

收到試用請求後,我們將透過提供的電子郵件地址與您聯繫,以協助設定 IA-Connect 軟體並為您提供試用授權。 這是一個功能齊全的試用版,可讓您在試用期內測試自己環境中所有 9 個 IA-Connect Connector 的 800 個動作中的任何一個。

開始使用連接器

提交 IA-Connect 試用請求後,您將能夠下載包含 IA-Connect 軟件以及涵蓋安裝和設置的文件的 ZIP 文件。 我們還將根據需要與您聯繫,在安裝過程中提供支援和指導。

Support

在試用期間,您可以聯絡 Ultima Labs (IAConnect@ultima.com) 尋求支援和協助。

購買 IA-Connect 許可證後,您將收到支持代幣,這些代幣可以兌換 Ultima 位於英國的技術服務中心 (TSC) 的定制培訓或支持。

已知問題、常見錯誤和常見問題

我們的知識庫包含許多文章,涵蓋任何已知問題、使用 IA-Connect 連接器時可能發生的常見錯誤以及常見問題。 這可在 IA-Connect 試 https://support.ultima.com/ultimalabs 用期間和購買 IA-Connect 許可證時訪問,並提供訪問這些資源的帳戶。

正在建立連線

連接器支援下列驗證類型:

預設值 建立連線的參數。 所有區域 不可共享

預設

適用:所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
API 金鑰 securestring 此 API 的 API 金鑰
IA-Connect Orchestrator 位址 字串 指定不含 HTTP(S) 元件的 IA-Connect Orchestrator 位址

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

Active Directory 群組是否存在

傳回指定的 Active Directory 群組是否存在。

Azure AD 使用者是否指派給系統管理員角色

傳回 Azure Active Directory 使用者是否已指派給 Azure Active Directory 系統管理員角色。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

Microsoft Exchange Online 信箱是否存在

傳回指定的 Microsoft Exchange Online 或 Office 365 (遠端) 信箱是否存在。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。

Microsoft Exchange 信箱是否存在

傳回指定的 Exchange 信箱是否存在。

Office 365 信箱是否有封存

報告 Microsoft Exchange Online 中的現有信箱是否有封存信箱。 如果信箱不存在,則會引發例外狀況。

中斷與 Active Directory 的連線

如果您已使用動作 [使用認證開啟 Active Directory PowerShell 執行空間] 來執行 Active Directory PowerShell 命令作為替代使用者帳戶或替代網域,則此動作會將 IA-Connect 代理程式傳回執行 Active Directory 動作的預設行為,作為 IA-Connect 代理程式執行的使用者帳戶。

中斷與 Azure AD 的連線

中斷 IA-Connect 與 Azure Active Directory 的連線 (也稱為 Microsoft Entra ID、Azure AD 或 AAD)。 在重新連線之前,您將無法再次發出 Azure AD 動作。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以最初用來連線的模組為準。

中斷與 Microsoft Exchange 的連線

中斷 IA-Connect 與Microsoft Exchange 伺服器的連線 (使用動作「連線至 Microsoft Exchange」連線)。 在重新連線之前,您將無法再次發出 Microsoft Exchange PowerShell 動作。

中斷與 Office 365 的連線

使用 Office 365 PowerShell 模組中斷 IA-Connect 與 Office 365 的連線 (使用動作 [連線到 Office 365] 連線) 。 在重新連線之前,您將無法再次發出 Office 365 PowerShell 動作。

使用憑證連線到 Azure AD

將 IA-Connect 連線到 Azure Active Directory (也稱為 Microsoft Entra ID、Azure AD 或 AAD)。 此動作 (或「使用認證連線到 Azure AD」) 必須先發出,才能執行任何其他 Azure AD 動作。 此動作需要在 Azure AD 中設定具有憑證的 Azure 服務主體和 Azure AD 應用程式註冊,才能運作,但優點是不需要 MFA (2FA)。 此動作會使用 Azure AD v2 或 Microsoft Graph PowerShell 模組。

使用憑證連線到 Office 365

使用 Office 365 PowerShell 模組將 IA-Connect 連線到 Office 365。 此動作 (或「使用認證連線到 Office 365」) 必須先發出,才能執行任何其他 Office 365 動作。 此動作需要使用 Azure AD 應用程式註冊憑證,並在 Azure AD 中設定正確的角色,才能運作,但優點是不需要 MFA (2FA)。

使用認證連線到 Active Directory

可讓您指定執行 Active Directory PowerShell 命令時要使用的替代帳戶。 這會影響在此動作之後發出的所有 Active Directory 命令。 如果您不使用此動作,則所有 Active Directory PowerShell 命令都會以 IA-Connect 代理程式執行時使用的使用者帳戶身分執行。

使用認證連線到 Azure AD

將 IA-Connect 連線到 Azure Active Directory (也稱為 Microsoft Entra ID、Azure AD 或 AAD)。 在執行任何其他 Azure AD 動作之前,必須先發出此動作 (或「使用憑證連線到 Azure AD」。 此動作需要不使用 MFA (2FA) 的帳戶,或者您需要使用 UI 自動化模組來自動化 2FA 元件 (即一次性密碼驗證快顯視窗)。 或者,使用動作 [使用憑證連線到 Azure AD]。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組。

使用認證連線到 Office 365

使用 Office 365 PowerShell 模組將 IA-Connect 連線到 Office 365。 此動作 (或「使用憑證連線到 Office 365」) 必須先發出,才能執行任何其他 Office 365 動作。 此動作需要不需要 MFA (2FA) 的帳戶,或者您需要使用 UI 自動化模組來自動化 2FA 元件 (即一次性密碼驗證快顯視窗)。 或者,使用動作 [使用憑證連線到 Office 365]。

修改 Active Directory 一般使用者屬性

修改 Active Directory 使用者的通用屬性。 您只能將值指派給屬性,而不能將其設定為空白。 若要將屬性設定為空白,請使用動作 '修改 Active Directory 使用者字串屬性'。

修改 Active Directory 使用者主資料夾

設定 Active Directory 使用者的主資料夾/目錄/磁碟機。

修改 Active Directory 使用者字串屬性

修改 Active Directory 使用者的個別字串屬性。 這可讓您修改非常具體的使用者設定,包括自訂屬性。 您也可以將個別使用者屬性設定為空白。

修改 Active Directory 使用者布林屬性

修改 Active Directory 使用者的個別布林值 (true/false) 屬性。 這可讓您修改非常具體的使用者設定,包括自訂屬性。

修改 Azure AD 使用者屬性

修改 Azure Active Directory 使用者的通用屬性。 您只能將值指派給屬性,而不能將其設定為空白,因為空白值會解譯為保持值不變的意圖。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

修改 Microsoft Exchange Online 信箱電子郵件地址

修改現有 Microsoft Exchange Online 或 Office 365 (遠端) 信箱上的電子郵件地址。 您可以新增、移除及取代主要電子郵件地址和別名電子郵件地址。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。

修改 Microsoft Exchange 信箱電子郵件地址

修改 Microsoft Exchange 信箱上的電子郵件地址。 您可以新增、移除及取代主要電子郵件地址和別名電子郵件地址。

停用 Active Directory 使用者帳戶

停用 Active Directory 使用者帳戶。 如果停用使用者帳戶,則使用者無法登入。

停用 Azure AD 使用者

停用 Azure Active Directory 使用者。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

停用使用者的 Microsoft Exchange Online 信箱

停用現有的 Microsoft Exchange Online 或 Office 365 (遠端) 信箱。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。

停用使用者的 Microsoft Exchange 信箱

停用現有的 Microsoft Exchange 信箱。

取得 Active Directory 使用者

傳回指定 Active Directory 使用者的屬性。 您可以依身分識別 (尋找單一使用者) 或使用篩選器 (尋找一或多個使用者) 進行搜尋。

取得 Active Directory 使用者群組成員資格

傳回指定使用者所屬的 Active Directory 群組清單,減去主要群組 (通常是「網域使用者」) ,因為技術上它不是成員資格。 此動作僅適用於使用者帳戶,您無法使用此動作來查詢群組或電腦的群組成員資格。

取得 Active Directory 網域資訊

擷取 Active Directory 網域的相關資訊。

取得 Active Directory 群組

傳回指定 Active Directory 群組或群組的屬性。 您可以依身分 (尋找單一群組) 或使用篩選器 (尋找一或多個群組) 進行搜尋。

取得 Active Directory 群組成員

傳回 Active Directory 群組的成員清單。

取得 Azure AD 使用者

傳回 Azure Active Directory 中使用者的詳細數據 (也稱為 Microsoft Entra ID、Azure AD 或 AAD)。 您可以依物件 ID 或使用篩選器進行搜尋。 物件標識碼搜尋應該傳回 0 或 1 個結果。 篩選搜尋可能會傳回 0 個或多個結果。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

取得 Azure AD 使用者授權

擷取指派給 Azure AD 使用者的授權 (SKU) 清單。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

取得 Azure AD 使用者授權服務方案

擷取指派給指定 Azure AD 使用者授權 (SKU) 的授權方案清單。 例如:如果使用者已指派FLOW_FREE授權,這將允許您檢視他們已佈建至該授權的服務方案。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

取得 Azure AD 使用者系統管理員角色指派

傳回指定使用者指派給的 Azure Active Directory 系統管理員角色清單。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

取得 Azure AD 使用者群組成員資格

傳回指定使用者所屬的 Azure Active Directory 群組清單。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

取得 Azure AD 授權 SKU

傳回已連線 Azure AD 訂閱的 Azure Active Directory 授權庫存單位 (SKU) 清單。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

取得 Azure AD 群組

傳回 Azure Active Directory 中群組的詳細數據 (也稱為 Microsoft Entra ID、Azure AD 或 AAD)。 您可以依物件 ID 或使用篩選器進行搜尋。 物件標識碼搜尋應該傳回 0 或 1 個結果。 篩選搜尋可能會傳回 0 個或多個結果。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

取得 Azure AD 群組成員

傳回 Azure Active Directory 群組的成員清單。 成員可以是使用者、群組、裝置或服務主體/企業應用程式。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

取得 Microsoft Exchange 通訊群組成員

擷取 Microsoft Exchange 通訊群組成員清單。

取得 Office 365 信箱

傳回指定 Microsoft Exchange Online 或 Office 365 信箱的屬性。

取得 Office 365 通訊群組

傳回指定 Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組的屬性。 您可以依身分或使用篩選器進行搜尋。 身分識別搜尋應該會傳回 0 或 1 個結果。 篩選搜尋可能會傳回 0 個或多個結果。

取得 Office 365 通訊群組成員

擷取 Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組成員清單。

取得下一個可用的帳戶名稱

根據 Active Directory 和 Exchange 帳戶名稱命名格式的詳細數據,提供下一個可用備用帳戶名稱的詳細數據。 用來決定要為指定使用者建立的 Active Directory 和 Exchange 帳戶。 此操作不會創建任何帳戶,它會提供有關名稱可用性的信息。

啟用 Active Directory 使用者帳戶

啟用 Active Directory 使用者帳戶。 如果帳戶未停用,則此命令不會執行任何動作。

啟用 Azure AD 使用者

啟用 Azure Active Directory 使用者。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

執行 Active Directory DirSync

在 Active Directory (內部部署) 和 Azure Active Directory (雲端) 之間執行同步處理。 此命令必須發出給具有「DirSync」角色的伺服器(即執行同步的電腦)。

執行 Active Directory PowerShell 腳本

在執行 IA-Connect 代理程式之工作階段的 Active Directory 執行空間中執行 PowerShell 指令碼,其中指令碼內容會作為命令的一部分傳遞至 IA-Connect 代理程式。 這是執行您自己的自訂 Active Directory PowerShell 程式碼的建議動作。 此動作也可用來擷取先前執行 PowerShell 指令碼的結果,並以代理程式執行緒的形式執行。

執行 Azure AD PowerShell 指令碼

在執行 IA-Connect 代理程式的工作階段中的 Azure Active Directory (也稱為 Microsoft Entra ID、Azure AD 或 AAD) 執行空間中執行 PowerShell 腳本,其中腳本內容會作為命令的一部分傳遞至 IA-Connect 代理程式。 這是執行您自己的自訂 Azure AD PowerShell 腳本的建議動作。 此動作也可用來擷取先前執行 PowerShell 指令碼的結果,並以代理程式執行緒的形式執行。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組。

執行 Exchange PowerShell 腳本

在執行 IA-Connect 代理程式之工作階段的 Exchange 執行空間中執行 PowerShell 腳本,其中腳本內容會作為命令的一部分傳遞至 IA-Connect 代理程式。 這是執行您自己的自訂 Exchange PowerShell 程式碼的建議動作。 此動作也可用來擷取先前執行 PowerShell 指令碼的結果,並以代理程式執行緒的形式執行。

執行 Office 365 PowerShell 腳本

在執行 IA-Connect 代理程式的工作階段的 Office 365 執行空間中執行 PowerShell 指令碼,其中指令碼內容會作為命令的一部分傳遞至 IA-Connect 代理程式。 這是執行您自己的自訂 Office 365 Exchange Online PowerShell 程式碼的建議動作。 此動作也可用來擷取先前執行 PowerShell 指令碼的結果,並以代理程式執行緒的形式執行。

將 Active Directory 使用者移至 OU

將 Active Directory 使用者移至現有的 Active Directory 組織單位 (OU)。

將 Active Directory 物件新增至多個群組

將 Active Directory 物件 (通常是使用者、群組或電腦) 新增至多個現有的 Active Directory 群組。 IA-Connect 將物件新增至盡可能多的群組,並報告結果。 如果物件已經是一或多個指定群組的成員,則會算作成功。

將 Azure AD 使用者指派給多個系統管理員角色

將 Azure Active Directory 使用者 (或其他物件) 指派給一或多個現有的 Azure Active Directory 系統管理員角色。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

將 Azure AD 使用者指派給系統管理員角色

將 Azure Active Directory 使用者 (或其他物件) 指派給現有的 Azure Active Directory 系統管理員角色。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

將 Azure AD 使用者新增至多個群組

將 Azure Active Directory 使用者新增至多個現有的 Azure Active Directory 群組,其中群組是由物件識別碼或顯示名稱所指定。 IA-Connect 將使用者新增至盡可能多的群組,並報告結果。 此動作無法修改通訊群組清單或已啟用郵件的安全性群組 - 請改用 Office 365 Exchange Online 動作。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

將 Azure AD 使用者新增至群組

將 Azure Active Directory 使用者新增至現有的 Azure Active Directory 安全性或 M365 群組。 此動作無法修改通訊群組清單或已啟用郵件的安全性群組 - 請改用 Office 365 Exchange Online 動作。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

將 Exchange 設定為檢視整個 Active Directory 樹系

指定在執行 Exchange 動作時,是否搜尋/檢視整個 Active Directory 樹系 (包括子網域)。 如果您有多個連結的網域,則可能需要使用此動作。

將 Microsoft Exchange 信箱權限新增至使用者

將信箱許可權指派給指定的信箱使用者、使用者或安全性群組。

將 Microsoft Exchange 成員新增至通訊群組

將成員 (例如使用者) 新增至 Exchange 通訊群組。 如果成員已在群組中,則不會採取任何動作。

將 Office 365 信箱權限新增至使用者

將 Microsoft Exchange Online 或 Office 365 信箱許可權指派給指定的信箱使用者、使用者或安全性群組。

將 Office 365 成員新增至通訊群組

將成員新增至 Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組。

已連線到 Azure AD

報告 IA-Connect 是否連線到 Azure Active Directory (也稱為 Microsoft Entra ID、Azure AD 或 AAD)。 使用其中一個 [連線到 Azure AD] 動作來連線。

已連線至 Active Directory

報告 IA-Connect 是否連線到 Active Directory。 根據預設,IA-Connect 會使用執行 IA-Connect Agent 的帳戶,自動連線到執行 IA-Connect Agent 的電腦所屬的網域。 使用「使用認證連線到 Active Directory」動作,使用替代認證或連線到替代網域。

已連線至 Microsoft Exchange

報告 IA-Connect 是否連線到Microsoft Exchange 伺服器。 使用動作 [連線到 Microsoft Exchange] 進行連線。

已連線至 Office 365

報告 IA-Connect 是否使用 Office 365 PowerShell 模組連線到 Office 365。 使用動作 [連線到 Office 365] 進行連線。

建立 Microsoft Exchange Online 信箱和使用者帳戶

在內部部署 Active Directory 中建立已啟用郵件的使用者,並在 Microsoft Exchange Online 或 Office 365 中建立相關聯的遠端信箱。 只有在使用者不存在於內部部署 Active Directory 中時,才使用此動作。 如果使用者已存在,請使用動作 '為使用者建立 Microsoft Exchange Online 信箱]。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。

建立 Microsoft Exchange 信箱和使用者帳戶

在內部部署 Active Directory 中建立已啟用郵件的使用者,並在 Microsoft Exchange 中建立相關聯的信箱。 只有在使用者不存在於內部部署 Active Directory 中時,才使用此動作。 如果使用者已存在,請使用動作「為使用者建立 Microsoft Exchange 信箱」。

建立 Office 365 信箱和使用者帳戶

在 Microsoft Exchange Online 中建立信箱,並在 Azure Active Directory/Entra ID 中建立使用者帳戶。 只有在使用者尚未存在於 Azure Active Directory/Entra ID 中時,才使用此動作。 如果使用者已存在,請改為將適當的授權指派給使用者帳戶。

建立 Office 365 共用信箱和使用者帳戶

在 Microsoft Exchange Online 中建立共用信箱,並在 Azure Active Directory/Entra ID 中建立使用者帳戶。 只有在使用者尚未存在於 Azure Active Directory/Entra ID 中時,才使用此動作。 共用信箱 SMTP 位址將以名稱、別名或主要 SMTP 位址為基礎 (取決於提供的輸入)。

建立新的 Azure AD Microsoft 365 群組

建立新的 Azure Active Directory Microsoft 365 群組。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

建立新的 Azure AD 安全性群組

建立新的 Azure Active Directory 安全性群組。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

建立新的 Microsoft Exchange 通訊群組

建立新的 Microsoft Exchange 通訊群組或已啟用郵件的安全性群組。

建立新的 Office 365 通訊群組

建立新的 Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組。

從DN獲取Active Directory域FQDN

效用函數。 給定 Active Directory 使用者的識別名稱 (DN),傳回包含使用者的 Active Directory 網域。

從使用者 DN 取得 Active Directory OU

效用函數。 給定 Active Directory 使用者的辨別名稱 (DN),會傳回使用者所在的組織單位 (OU)。

從多個系統管理員角色中移除 Azure AD 使用者

從一或多個現有的 Azure Active Directory 系統管理員角色中移除 Azure Active Directory 使用者 (或其他物件)。 此動作會逐一查看使用者的角色指派清單,並移除相符的項目,因此如果您指定要移除的不存在角色,則不會觸發錯誤 (因為如果使用者不在該角色中,則不會嘗試任何動作)。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

從多個群組中移除 Active Directory 物件

從多個現有的 Active Directory 群組中移除 Active Directory 物件 (通常是使用者、群組或電腦)。 IA-Connect 會從盡可能多的群組中移除物件,並報告結果。 如果物件不是一或多個指定群組的成員,則會算作成功。

從多個群組中移除 Azure AD 使用者

從多個現有的 Azure Active Directory 群組中移除 Azure Active Directory 使用者,其中群組是由物件識別碼或顯示名稱所指定。 IA-Connect 會從盡可能多的群組中移除使用者,並報告結果。 此動作無法修改通訊群組清單或已啟用郵件的安全性群組 - 請改用 Office 365 Exchange Online 動作。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

從所有系統管理員角色指派中移除 Azure AD 使用者

從指派給 Azure Active Directory 管理員角色的所有 Azure Active Directory 使用者 (或其他物件) 中移除。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

從所有群組中移除 Active Directory 使用者

從 Active Directory 使用者所屬的所有 Active Directory 群組中移除他們。 IA-Connect 會從盡可能多的群組中移除使用者,並報告結果。 此動作僅適用於使用者帳戶,您無法使用此動作來移除群組或電腦的群組成員資格。

從所有群組中移除 Azure AD 使用者

從 Azure Active Directory 使用者所屬的所有 Azure Active Directory 群組中移除他們。 此動作無法修改通訊群組清單或已啟用郵件的安全性群組 - 請改用 Office 365 Exchange Online 動作。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

從所有通訊群組移除 Office 365 信箱

從信箱所屬的所有 Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組中移除信箱。

從系統管理員角色指派中移除 Azure AD 使用者

從現有的 Azure Active Directory 系統管理員角色指派中移除 Azure Active Directory 使用者 (或其他物件)。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

從群組中移除 Azure AD 使用者

從 Azure Active Directory 群組中移除 Azure Active Directory 使用者。 此動作無法修改通訊群組清單或已啟用郵件的安全性群組 - 請改用 Office 365 Exchange Online 動作。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

從通訊群組中移除 Office 365 成員

從 Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組中移除成員。

從通訊群組移除 Microsoft Exchange 成員

從 Exchange 通訊群組移除成員 (例如使用者)。 如果成員不在群組中,則不會採取任何動作。

擷取 Microsoft Exchange Online 信箱詳細資料

傳回指定 Microsoft Exchange Online 或 Office 365 (遠端) 信箱的屬性。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。 您可以依身分或使用篩選器進行搜尋。 身分識別搜尋應該會傳回 0 或 1 個結果。 篩選搜尋可能會傳回 0 個或多個結果。

擷取 Microsoft Exchange Online 信箱電子郵件地址

擷取指派給現有 Microsoft Exchange Online 或 Office 365 (遠端) 信箱之所有電子郵件地址清單。 這包括主要 SMTP 位址、代理電子郵件地址、X.400 位址和 EUM(Exchange 統一通訊)位址。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。

擷取 Microsoft Exchange 信箱詳細資料

傳回指定 Exchange 信箱的屬性。 您可以依身分或使用篩選器進行搜尋。 身分識別搜尋應該會傳回 0 或 1 個結果。 篩選搜尋可能會傳回 0 個或多個結果。

擷取 Microsoft Exchange 信箱通訊群組成員資格

擷取信箱所屬的通訊群組。

擷取 Microsoft Exchange 信箱電子郵件地址

擷取指派給 Microsoft Exchange 信箱的所有電子郵件地址清單。 這包括主要 SMTP 位址、代理電子郵件地址、X.400 位址和 EUM(Exchange 統一通訊)位址。

擷取 Microsoft Exchange 通訊群組詳細數據

擷取 Microsoft Exchange 通訊群組的詳細數據。 您可以依身分或使用篩選器進行搜尋。 身分識別搜尋應該會傳回 0 或 1 個結果。 篩選搜尋可能會傳回 0 個或多個結果。

擷取 Office 365 信箱通訊群組成員資格

擷取 Office 365 或 Exchange Online 信箱所屬的通訊群組或已啟用郵件的安全性群組。

新增 Active Directory OU

建立新的 Active Directory 組織單位 (OU)。

新增 Active Directory 使用者

建立新的 Active Directory 使用者帳戶。

新增 Active Directory 群組

建立新的 Active Directory 群組。

新增 Active Directory 群組成員

將 Active Directory 物件 (通常是使用者、群組或電腦) 新增至現有的 Active Directory 群組。 如果群組和群組成員位於不同的網域中,則需要為群組和成員指定識別名稱 (DN)。

新增 Azure AD 使用者

建立新的 Azure Active Directory 使用者帳戶。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

新增 Microsoft Exchange 信箱權限

將信箱權限指派給 Active Directory 物件 (例如使用者或群組) 。

新增多個 Active Directory 群組成員

將一或多個 Active Directory 物件 (通常是使用者、群組或電腦) 新增至現有的 Active Directory 群組。 IA-Connect 將盡可能多的成員添加到群組中並報告結果。 如果群組和群組成員位於不同的網域中,則需要為群組和成員指定識別名稱 (DN)。 如果某些物件已經是群組的成員,則會算作成功。

是 Azure AD 使用者群組中的使用者

傳回使用者是否為 Azure Active Directory 群組的成員。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

是否已安裝 Azure AD PowerShell 模組

報告 Azure Active Directory 所需的 PowerShell 模組 (也稱為 Microsoft Entra ID、Azure AD 或 AAD) 是否安裝在執行 IA-Connect 代理程式的電腦上。 此動作會檢查 Azure AD v2 和 Microsoft Graph 使用者 PowerShell 模組。

檢查 Active Directory OU 是否存在

報告 Active Directory 組織單位 (OU) 是否存在。

清除 Active Directory 使用者帳戶到期

清除 Active Directory 帳戶的到期日。

為使用者建立 Microsoft Exchange Online 信箱

為內部部署 Active Directory 中尚未有信箱的現有使用者建立 Microsoft Exchange Online 或 Office 365 (遠端) 信箱或封存信箱。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。 您也可以使用此動作來封存現有的遠端信箱。

為使用者建立 Microsoft Exchange 信箱

為尚未有信箱的現有使用者建立 Microsoft Exchange 信箱。

為現有使用者建立 Office 365 封存信箱

在 Microsoft Exchange Online 中為 Azure Active Directory/Entra ID 中的現有使用者建立封存信箱。 使用者必須已經擁有信箱和適當的授權。

移除 Active Directory OU

從 Active Directory 中移除組織單位 (OU)。 如果 OU 中有物件 (例如使用者、群組或電腦),則無法刪除 OU。

移除 Active Directory 使用者

從 Active Directory 中移除使用者。

移除 Active Directory 群組

從 Active Directory 中移除群組。 如果群組中有物件 (例如使用者、群組或電腦),這些物件將在群組刪除過程中移除。

移除 Active Directory 群組成員

從 Active Directory 群組中移除 Active Directory 成員 (使用者、群組或電腦)。

移除 Azure AD 使用者

移除 Azure Active Directory 使用者。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

移除 Azure AD 安全性或 Microsoft 365 群組

移除 Azure Active Directory 安全性群組或 Microsoft 365 群組。 此動作無法移除已啟用郵件的安全性群組或通訊群組清單:請改用 [移除 Office 365 通訊群組] 動作。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

移除 Microsoft Exchange 通訊群組

移除 Microsoft Exchange 通訊群組。

移除 Office 365 通訊群組

移除 Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組。

移除使用者的 Microsoft Exchange 信箱權限

從指定的信箱使用者、使用者或安全性群組移除信箱許可權。

移除使用者的 Office 365 信箱權限

從指定的信箱使用者、使用者或安全性群組移除 Microsoft Exchange Online 或 Office 365 信箱許可權。

移除多個 Active Directory 群組成員

從現有的 Active Directory 群組中移除一或多個 Active Directory 物件 (通常是使用者、群組或電腦)。 IA-Connect 從群組中移除盡可能多的成員,並報告結果。 如果群組和群組成員位於不同的網域中,則需要為群組和成員指定識別名稱 (DN)。 如果某些物件不是群組的成員,則會算作成功。

移除所有 Azure AD 使用者授權

移除指派給使用者的所有 Azure AD 使用者授權 (SKU)。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

等候 Office 365 信箱

等候指定的 Microsoft Exchange Online 或 Office 365 信箱存在。 如果您正在等待 AD 同步或授權設定生效,這很常見。 如果信箱已經存在,動作會立即傳回成功。

複製 Active Directory 使用者屬性

將來源 Active Directory 使用者的指定屬性/屬性設定為目的地 Active Directory 使用者。

複製 Active Directory 使用者群組成員資格

將目的地 Active Directory 使用者新增至第一個使用者所屬的相同 Active Directory 群組,減去主要群組 (通常是「網域使用者」),因為技術上它不是成員資格。

解除鎖定 Active Directory 帳戶

解除鎖定 Active Directory 帳戶。 如果帳戶未鎖定,則此命令不會執行任何動作。

設定 Active Directory 伺服器

設定要用於所有進一步 Active Directory 動作的特定 Active Directory 伺服器。

設定 Active Directory 使用者免於意外刪除

將 Active Directory 帳戶設定為保護 (或不受保護) 以防止意外刪除。 如果您保護帳戶免遭意外刪除,則在移除保護之前,您無法刪除該帳戶。

設定 Active Directory 使用者帳戶到期日期結束日期

設定 Active Directory 使用者帳戶的帳戶到期結束日期。 這是帳戶可用的最後一整天,因此從技術上講,該帳戶會在第二天開始時到期。 IA-Connect 代理程式會察覺到這一點,並在將日期儲存在 Active Directory 中時自動將 1 天新增至提供的輸入日期。

設定 Azure AD 使用者授權

新增或移除 Azure AD 使用者授權 (SKU)。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

設定 Azure AD 使用者的管理員

設定 Azure Active Directory 使用者的管理員。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

設定 Exchange 信箱代表傳送

指定誰可以代表此現有信箱傳送。

設定 Microsoft Exchange Online 信箱上的屬性

設定現有 Microsoft Exchange Online 或 Office 365 (遠端) 信箱的屬性。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。

設定 Microsoft Exchange 信箱上的屬性

設定現有 Microsoft Exchange 信箱的屬性。

設定 Microsoft Exchange 信箱的自動回覆 (不在辦公室)

設定 Microsoft Exchange 信箱的自動回覆 (不在辦公室)。 此動作不適用於 Microsoft Exchange Online 或 Office 365 中的遠端信箱:請改用動作 [設定 Office 365 信箱的自動回覆 (不在辦公室) ]。

設定 Office 365 信箱的屬性

設定 Microsoft Exchange Online 或 Office 365 信箱上的屬性。

設定 Office 365 信箱的自動回覆 (不在辦公室)

設定 Microsoft Exchange Online 或 Office 365 信箱的自動回覆 (不在辦公室)。

連線到 Microsoft Exchange

將 IA-Connect 連線到Microsoft Exchange 伺服器。 在執行任何其他 Exchange 動作之前,必須先發出此動作。 如果您指定使用者名稱和密碼,則所有後續的 Exchange 動作都會以該帳戶執行。 如果您未指定使用者名稱和密碼,則所有後續的 Exchange 動作都會以 IA-Connect 代理程式執行時所用的使用者帳戶身分執行。

連線到預設的 Active Directory 網域

使用 IA-Connect Agent 執行時所用的帳戶 (即預設行為),將 IA-Connect Agent 連線到執行 IA-Connect Agent 的電腦所屬的網域。

連線至 JML 環境

連線至 JML 環境,其中該環境的詳細資料保存在 IA-Connect Orchestrator 中。 這些詳細資料可以包括認證、位址和其他連線設定。 例如,您可以使用此動作連線到 Active Directory、Microsoft Exchange、Azure AD 或 Office 365 Exchange Online。

重設 Active Directory 使用者密碼

使用新密碼重設 Active Directory 使用者的密碼,並選擇性地設定密碼屬性。

重設 Azure AD 使用者密碼

使用新密碼重設 Azure Active Directory 使用者的密碼。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

重設 Azure AD 使用者屬性

將 Azure Active Directory 使用者的通用屬性重設為空白值。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

重設 Microsoft Exchange Online 信箱上的屬性

將現有 Microsoft Exchange Online 或 Office 365 (遠端) 信箱的指定屬性設定為空白。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。

重設 Microsoft Exchange 信箱上的屬性

將現有 Microsoft Exchange 信箱的指定屬性設定為空白。

Active Directory 群組是否存在

傳回指定的 Active Directory 群組是否存在。

參數

名稱 機碼 必要 類型 Description
群組身分
GroupIdentity True string

Active Directory 群組的身分識別。 您可以依識別名稱 (例如 CN=Group1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'Group1') 來指定群組。 您不能使用顯示名稱或群組名稱(儘管群組名稱通常與可以使用的 2K 之前名稱相同)。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
AD 群組存在
ADGroupExists boolean

如果 AD 組存在,則此輸出返回 true,如果 AD 組不存在,則返回 false。

AD 群組 DN
ADGroupDN string

如果AD組存在,則此輸出包含組可分辨名稱(DN)。

Azure AD 使用者是否指派給系統管理員角色

傳回 Azure Active Directory 使用者是否已指派給 Azure Active Directory 系統管理員角色。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
UserObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

角色物件識別碼或顯示名稱
RoleObjectId True string

Azure Active Directory 系統管理員角色的識別碼或顯示名稱。 您可以依顯示名稱 (例如「應用程式開發人員」) 或 ObjectId (例如 UUID/GUID 值) 來指定 AAD 系統管理員角色。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
使用者被指派給角色
UserIsAssignedToRole boolean

使用者是否已指派給 Azure Active Directory 系統管理員角色。

Microsoft Exchange Online 信箱是否存在

傳回指定的 Microsoft Exchange Online 或 Office 365 (遠端) 信箱是否存在。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity string

Microsoft Exchange Online 或 Office 365 (遠端) 信箱的身分識別。 您可以依 Active Directory 物件識別碼、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、DOMAIN\username、電子郵件地址、GUID 或使用者主體名稱 (UPN) 來指定 Microsoft Exchange Online 或 Office 365 (遠端) 信箱。

篩選屬性名稱
FilterPropertyName string

作為依身分識別搜尋的替代方案,請提供要篩選信箱的屬性名稱。 常見的屬性名稱包括:Name、Alias、PrimarySMTPAddress、DisplayName。 如果使用篩選器,您也必須填入「篩選器資源比較」和「篩選器資源值」欄位。

篩選器屬性比較
FilterPropertyComparison string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入比較類型 (例如:如果篩選器屬性名稱為「別名」,則比較可以是「等於」或「類似」)。 如果您想要輸入原始篩選器 (OPATH 格式),請選擇「原始:手動輸入篩選器」的比較類型,然後在「篩選器屬性值」欄位中輸入完整篩選器。

篩選屬性值
FilterPropertyValue string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入篩選器屬性的值 (例如:如果篩選器屬性名稱為 'Alias',則篩選器屬性值可能是 'JohnDoe')。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
信箱存在
MailboxExists boolean

如果 Microsoft Exchange Online 信箱存在,則為 True。 如果 Microsoft Exchange Online 信箱不存在,則為 False。

Microsoft Exchange 信箱是否存在

傳回指定的 Exchange 信箱是否存在。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity string

Microsoft Exchange 信箱的身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

篩選屬性名稱
FilterPropertyName string

作為依身分識別搜尋的替代方案,請提供要篩選信箱的屬性名稱。 常見的屬性名稱包括:Name、Alias、PrimarySMTPAddress、DisplayName、SamAccountName。 如果使用篩選器,您也必須填入「篩選器資源比較」和「篩選器資源值」欄位。

篩選器屬性比較
FilterPropertyComparison string

如果以「篩選器屬性名稱」搜尋,而不是依身分搜尋,請在此處輸入比較類型 (例如:如果篩選器屬性名稱為「別名」,則比較可以是「等於」或「類似」)。 如果您想要輸入原始篩選器 (OPATH 格式),請選擇「原始:手動輸入篩選器」的比較類型,然後在「篩選器屬性值」欄位中輸入完整篩選器。

篩選屬性值
FilterPropertyValue string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入篩選器屬性的值 (例如:如果篩選器屬性名稱為 'Alias',則篩選器屬性值可能是 'JohnDoe')。

收件者類型詳細資料
RecipientTypeDetails string

要搜尋的信箱類型。 如果此欄位留空,則搜尋中將包含所有類型的信箱。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
信箱存在
MailboxExists boolean

如果 Exchange 信箱存在,則為 True。 如果 Exchange 信箱不存在,則為 False。

Office 365 信箱是否有封存

報告 Microsoft Exchange Online 中的現有信箱是否有封存信箱。 如果信箱不存在,則會引發例外狀況。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange Online 或 Office 365 信箱的識別碼。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
信箱有封存
MailboxHasAnArchive boolean

如果信箱有封存,則設為 true。

中斷與 Active Directory 的連線

如果您已使用動作 [使用認證開啟 Active Directory PowerShell 執行空間] 來執行 Active Directory PowerShell 命令作為替代使用者帳戶或替代網域,則此動作會將 IA-Connect 代理程式傳回執行 Active Directory 動作的預設行為,作為 IA-Connect 代理程式執行的使用者帳戶。

參數

名稱 機碼 必要 類型 Description
Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
CloseActiveDirectoryPowerShellRunspaceResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

中斷與 Azure AD 的連線

中斷 IA-Connect 與 Azure Active Directory 的連線 (也稱為 Microsoft Entra ID、Azure AD 或 AAD)。 在重新連線之前,您將無法再次發出 Azure AD 動作。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以最初用來連線的模組為準。

參數

名稱 機碼 必要 類型 Description
Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
CloseAzureADv2PowerShellRunspaceResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

中斷與 Microsoft Exchange 的連線

中斷 IA-Connect 與Microsoft Exchange 伺服器的連線 (使用動作「連線至 Microsoft Exchange」連線)。 在重新連線之前,您將無法再次發出 Microsoft Exchange PowerShell 動作。

參數

名稱 機碼 必要 類型 Description
Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
CloseExchangePowerShellRunspaceResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

中斷與 Office 365 的連線

使用 Office 365 PowerShell 模組中斷 IA-Connect 與 Office 365 的連線 (使用動作 [連線到 Office 365] 連線) 。 在重新連線之前,您將無法再次發出 Office 365 PowerShell 動作。

參數

名稱 機碼 必要 類型 Description
Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
CloseO365PowerShellRunspaceResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

使用憑證連線到 Azure AD

將 IA-Connect 連線到 Azure Active Directory (也稱為 Microsoft Entra ID、Azure AD 或 AAD)。 此動作 (或「使用認證連線到 Azure AD」) 必須先發出,才能執行任何其他 Azure AD 動作。 此動作需要在 Azure AD 中設定具有憑證的 Azure 服務主體和 Azure AD 應用程式註冊,才能運作,但優點是不需要 MFA (2FA)。 此動作會使用 Azure AD v2 或 Microsoft Graph PowerShell 模組。

參數

名稱 機碼 必要 類型 Description
Azure AD 應用程式註冊識別碼
ApplicationId True string

Azure AD 應用程式註冊的應用程式識別碼,其中包含憑證,並在 Azure AD 中具有執行自動化動作所需的角色。 此 Azure AD 應用程式註冊必須先前由系統管理員設定。

憑證指紋
CertificateThumbprint True string

用於驗證的憑證指紋。 此憑證必須先前已建立,並存在於 IA-Connect 執行自動化動作的電腦和 Azure AD 應用程式註冊中。

Azure 租用戶識別碼
TenantId True string

要連線的 Azure 租用戶識別碼。 使用憑證進行驗證時,必須指定此值。

要使用的 API
APIToUse string

用來連線到 Azure AD 的 API。 設定之後,IA-Connect 發出的所有進一步 Azure AD 命令都會使用此 API。 如果設定為自動 (預設值),則會依下列順序掃描並選取已安裝的 PowerShell 模組:Microsoft Graph 使用者 PowerShell 模組、Azure AD v2 PowerShell 模組。 Azure AD v2 PowerShell 模組已於 2024 年 3 月 30 日淘汰,因此建議使用 Microsoft Graph 使用者 PowerShell 模組。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
OpenAzureADv2PowerShellRunspaceWithCertificateResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

使用憑證連線到 Office 365

使用 Office 365 PowerShell 模組將 IA-Connect 連線到 Office 365。 此動作 (或「使用認證連線到 Office 365」) 必須先發出,才能執行任何其他 Office 365 動作。 此動作需要使用 Azure AD 應用程式註冊憑證,並在 Azure AD 中設定正確的角色,才能運作,但優點是不需要 MFA (2FA)。

參數

名稱 機碼 必要 類型 Description
Azure AD 應用程式註冊應用程式識別碼
ApplicationId True string

Azure AD 應用程式註冊的應用程式識別碼,其中包含憑證,並在 Azure AD 中具有執行自動化動作所需的角色。 此 Azure AD 應用程式註冊必須先前由系統管理員設定。

憑證指紋
CertificateThumbprint True string

用於驗證的憑證指紋。 此憑證必須先前已建立,並存在於 IA-Connect 執行自動化動作的電腦和 Azure AD 應用程式註冊中。

組織
Organization True string

要用於驗證的組織。 例如:mytestenvironment.onmicrosoft.com。

交換網址
ExchangeURL string

要連線的 Microsoft Exchange 線上伺服器的選擇性 URL。 只有在您有自訂 URL 時才使用此選項。

連線方式
ConnectionMethod string

應該使用哪種方法來連線到 Microsoft Exchange。 'EXO V1' 是原始的 Microsoft Exchange Online PowerShell,不支援憑證 (,因此無法作為選項) 使用。 'EXO V2' 使用較新的 Microsoft Exchange Online PowerShell v2 模組,該模組在執行 IA-Connect 代理程式的電腦上執行,並且需要安裝 'ExchangeOnlineManagement' v2 PowerShell 模組。

僅在尚未連接的情況下才連接
OnlyConnectIfNotAlreadyConnected boolean

如果設定為 false:此動作一律會連線到 Office 365 Exchange Online,即使 Office 365 Exchange Online 已連線 IA-Connect 也一樣。 如果設定為 true (預設值):如果 IA-Connect 已連線到具有相同設定的 Office 365 Exchange Online,且 Office 365 Exchange Online 連線正在回應,則 IA-Connect 不會執行任何動作,因為連線已建立。

要在本機匯入的命令類型
CommandTypesToImportLocally string

「EXO V2」連線方法 (憑證驗證所需的) 會在本機匯入 Office 365 或 Exchange Online PowerShell 命令。 此選項可讓您選擇應匯入哪些 PowerShell 命令。 將此清單保持在最低限度可減少記憶體使用量和連線時間。 'All'(默認值,為了向後兼容)導入所有 PS 命令。 'IA-Connect only' (建議的選項) 只會匯入 IA-Connect 使用的 PS 指令 (您可以指定其他 PS 指令)。 '指定' 只會匯入您指定的 PS 命令,如果它們依賴於您未指定的 PS 命令,則可能會中斷某些 IA-Connect 操作。

要在本機匯入的其他命令
AdditionalCommandsToImportLocallyCSV string

如果您已選擇匯入「僅限IA-Connect」或「指定」PS 指令,則可以指定要匯入的其他 PS 指令的逗點分隔清單。 例如:「Get-Mailbox,New-Mailbox,New-DistributionGroup」。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
OpenO365PowerShellRunspaceWithCertificateResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

使用認證連線到 Active Directory

可讓您指定執行 Active Directory PowerShell 命令時要使用的替代帳戶。 這會影響在此動作之後發出的所有 Active Directory 命令。 如果您不使用此動作,則所有 Active Directory PowerShell 命令都會以 IA-Connect 代理程式執行時使用的使用者帳戶身分執行。

參數

名稱 機碼 必要 類型 Description
用戶名稱
Username True string

執行 Active Directory 命令時要使用的帳戶使用者名稱。 您可以指定 'DOMAIN\username' (例如 TESTDOMAIN\admin) 或 'username@domainFQDN' (例如 admin@testdomain.local) 格式的使用者名稱。

密碼
Password True password

執行 Active Directory 命令時要使用的帳戶密碼。

遠端電腦
RemoteComputer string

Active Directory 網域控制站 (DC) 或成員伺服器的名稱或完整網域名稱 (FQDN) ,以驗證所有 Active Directory 動作。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。 如果輸入成員伺服器 (而不是網域控制站) ,則該成員伺服器必須安裝 Active Directory PowerShell 模組/RSAT。

使用 SSL
UseSSL boolean

設定為 true 以使用 SSL 連線到遠端 WSMan 端點。

替代 TCP 連接埠
AlternativeTCPPort integer

如果未使用預設 WSMan TCP/5985 (非 SSL) 或 TCP/5986 (SSL),請設定為替代 TCP 連接埠。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
OpenActiveDirectoryPowerShellRunspaceWithCredentialsResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

使用認證連線到 Azure AD

將 IA-Connect 連線到 Azure Active Directory (也稱為 Microsoft Entra ID、Azure AD 或 AAD)。 在執行任何其他 Azure AD 動作之前,必須先發出此動作 (或「使用憑證連線到 Azure AD」。 此動作需要不使用 MFA (2FA) 的帳戶,或者您需要使用 UI 自動化模組來自動化 2FA 元件 (即一次性密碼驗證快顯視窗)。 或者,使用動作 [使用憑證連線到 Azure AD]。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組。

參數

名稱 機碼 必要 類型 Description
用戶名稱
Username True string

執行 Azure AD v2 PowerShell 命令時要使用的帳戶使用者名稱。

密碼
Password True password

執行 Azure AD v2 PowerShell 命令時要使用的帳戶密碼。

Azure 租用戶識別碼
TenantId string

要連線的選擇性 Azure 租用戶識別碼。 如果將其保留空白,則會使用與提供的使用者帳戶相關聯的預設租戶。

要使用的 API
APIToUse string

用來連線到 Azure AD 的 API。 設定之後,IA-Connect 發出的所有進一步 Azure AD 命令都會使用此 API。 如果設定為自動 (預設值),則會依下列順序掃描並選取已安裝的 PowerShell 模組:Microsoft Graph 使用者 PowerShell 模組、Azure AD v2 PowerShell 模組。 Azure AD v2 PowerShell 模組已於 2024 年 3 月 30 日淘汰,因此建議使用 Microsoft Graph 使用者 PowerShell 模組。

驗證範圍
AuthenticationScope string

在此 Azure AD 登入工作階段中執行所有自動化工作所需的權限範圍。 根據預設,IA-Connect 會要求權限範圍,以允許修改使用者、群組和授權指派。 只有在使用 Microsoft Graph 使用者 PowerShell 模組連線時,才會使用此設定。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
OpenAzureADv2PowerShellRunspaceResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

使用認證連線到 Office 365

使用 Office 365 PowerShell 模組將 IA-Connect 連線到 Office 365。 此動作 (或「使用憑證連線到 Office 365」) 必須先發出,才能執行任何其他 Office 365 動作。 此動作需要不需要 MFA (2FA) 的帳戶,或者您需要使用 UI 自動化模組來自動化 2FA 元件 (即一次性密碼驗證快顯視窗)。 或者,使用動作 [使用憑證連線到 Office 365]。

參數

名稱 機碼 必要 類型 Description
用戶名稱
Office365Username True string

執行 Office 365 PowerShell 命令時要使用的帳戶使用者名稱。

密碼
Office365Password True password

執行 Office 365 PowerShell 命令時要使用的帳戶密碼。

交換網址
ExchangeURL string

要連線的 Microsoft Exchange 線上伺服器的選擇性 URL。 只有在您有自訂 URL 時才使用此選項。

連線方式
ConnectionMethod string

應該使用哪種方法來連線到 Microsoft Exchange。 「EXO V1 本機」和「EXO V1 遠端」都使用原始的 Microsoft Exchange Online PowerShell,該 PowerShell 會在執行 IA-Connect 代理程式的電腦上執行,而且不需要任何其他 PowerShell 模組,但最終會被取代。 'EXO V1 local' 會在本機匯入遠端 Exchange 執行空間,並在本機執行命令。 'EXO V1 遠程'直接在遠程 Exchange 運行空間中運行,並且由於安全限制而無法運行通用 PowerShell 腳本。 'EXO V2' 使用較新的 Microsoft Exchange Online PowerShell v2 模組,該模組在執行 IA-Connect 代理程式的電腦上執行,並且需要安裝 'ExchangeOnlineManagement' v2 PowerShell 模組。

僅在尚未連接的情況下才連接
OnlyConnectIfNotAlreadyConnected boolean

如果設定為 false:此動作一律會連線到 Office 365 Exchange Online,即使 Office 365 Exchange Online 已連線 IA-Connect 也一樣。 如果設定為 true (預設值):如果 IA-Connect 已連線到具有相同設定的 Office 365 Exchange Online,且 Office 365 Exchange Online 連線正在回應,則 IA-Connect 不會執行任何動作,因為連線已建立。

要在本機匯入的命令類型
CommandTypesToImportLocally string

「EXO v1 本機」和「EXO V2」連線方法會在本機匯入 Office 365 或 Exchange Online PowerShell 命令。 此選項可讓您選擇應匯入哪些 PowerShell 命令。 將此清單保持在最低限度可減少記憶體使用量和連線時間。 'All'(默認值,為了向後兼容)導入所有 PS 命令。 'IA-Connect only' (建議的選項) 只會匯入 IA-Connect 使用的 PS 指令 (您可以指定其他 PS 指令)。 '指定' 只會匯入您指定的 PS 命令,如果它們依賴於您未指定的 PS 命令,則可能會中斷某些 IA-Connect 操作。

要在本機匯入的其他命令
AdditionalCommandsToImportLocallyCSV string

如果使用 'EXO v1 local' 或 'EXO V2' 連接方法,且您選擇匯入 'IA-Connect only' 或 'Specified' PS 命令,您可以指定要匯入的其他 PS 命令的逗號分隔清單。 例如:「Get-Mailbox,New-Mailbox,New-DistributionGroup」。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
OpenO365PowerShellRunspaceResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

修改 Active Directory 一般使用者屬性

修改 Active Directory 使用者的通用屬性。 您只能將值指派給屬性,而不能將其設定為空白。 若要將屬性設定為空白,請使用動作 '修改 Active Directory 使用者字串屬性'。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity True string

Active Directory 使用者的身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

城市
City string

使用者的「城市」屬性 (在 AD 使用者和電腦的「地址」索引標籤中)。

公司
Company string

使用者的「公司」屬性 (在 AD 使用者和電腦的「組織」索引標籤中)。

國家代碼
Country string

使用者的「國家/地區」屬性 (在 AD 使用者和電腦的「地址」索引標籤中)。 這必須是兩個字元的國家/地區代碼(例如,GB 代表英國,US 代表美國,FR 代表法國,ES 代表西班牙,JP 代表日本)。 這會對應至 Active Directory 架構中的 'c' 屬性。 IA-Connect 不會自動將「國家/地區代碼」對應至「國家/地區字串」和「國家/地區 ISO 3166 值」,因此您必須使用查詢表。

國家/地區字串
CountryString string

使用者「國家/地區」屬性的完整名稱 (在 AD 使用者和電腦的「位址」索引標籤中)。 這是完整的本地化顯示字串(例如「英國」、「美國」、「法國」、「西班牙」或「日本」)。 這會對應至 Active Directory 架構中的 'co' 屬性。 IA-Connect 不會自動將「國家/地區字串」對應至「國家/地區代碼」和「國家/地區 ISO 3166 值」,因此您必須使用查詢表格。

國家 ISO 3166 值
CountryISO3166 string

使用者「國家/地區」屬性的ISO3166代碼 (在 AD 使用者和電腦的「地址」索引標籤中)。 這是一個 3 位數的整數值(例如,英國為 826,美國為 840,法國為 250,西班牙為 724,日本為 392)。 這會對應至 Active Directory 架構中的 'countryCode' 屬性。 IA-Connect 不會自動將「國家/地區 ISO 3166 值」對應至「國家/地區代碼」和「國家/地區字串」,因此您必須使用查詢表格。

部門
Department string

使用者的「部門」屬性 (在 AD 使用者和電腦的「組織」索引標籤中)。

Description
Description string

使用者的「描述」屬性 (在 AD 使用者和電腦的「一般」索引標籤中)。

顯示名稱
DisplayName string

使用者的顯示名稱 (在 AD 使用者和電腦的 [一般] 索引標籤中)。

電子郵件地址
EmailAddress string

使用者的「電子郵件」屬性 (在 AD 使用者和電腦的 [一般] 索引標籤中)。

名字
GivenName string

使用者的名字 (在 AD 使用者和電腦的「一般」索引標籤中)。

家庭電話號碼
HomePhone string

使用者的 [首頁] 電話號碼屬性 (在 AD 使用者和電腦的 [電話] 索引標籤中) 。

首字母
Initials string

使用者的姓名縮寫 (在 AD 使用者和電腦的「一般」索引標籤中)。

IP電話號碼
IPPhone string

使用者的「IP 電話」屬性 (在 AD 使用者和電腦的 [電話] 索引標籤中)。

經理
Manager string

使用者的管理員屬性 (在 AD 使用者和電腦的「組織」索引標籤中)。 您可以指定識別名稱格式 (例如 CN=MrBig、OU=London、DC=mydomain、DC=local)、GUID 格式、SID 或 SAMAccountName (例如 'MrBig') 的管理員。

手機號碼
MobilePhone string

使用者的「行動」電話號碼屬性 (在 AD 使用者和電腦的 [電話] 索引標籤中)。

註釋
Notes string

使用者的「附註」屬性 (在 AD 使用者和電腦的「電話」索引標籤中)。 這會對應至 Active Directory 架構中的 'info' 屬性。

Office
Office string

使用者的 'Office' 屬性 (在 AD 使用者和電腦的 [一般] 索引標籤中)。

電話號碼(辦公室)
OfficePhone string

使用者的 [電話號碼] 屬性 (在 AD 使用者和電腦的 [一般] 索引標籤中)。

郵遞區號/郵遞區號
PostalCode string

使用者的「郵遞區號」屬性 (在 AD 使用者和電腦的「地址」索引標籤中)。

配置文件路徑
ProfilePath string

使用者的「設定檔路徑」屬性 (在 AD 使用者和電腦的「設定檔」索引標籤中)。

登入腳本
ScriptPath string

使用者的「登入指令碼」屬性 (在 AD 使用者和電腦的 [設定檔] 索引標籤中)。

州/省
State string

使用者的「州/省」屬性 (在 AD 使用者和電腦的 [地址] 索引標籤中)。

街道地址
StreetAddress string

使用者的「街道地址」屬性 (在 AD 使用者和電腦的「地址」索引標籤中)。

姓氏
Surname string

使用者的「姓氏」屬性 (在 AD 使用者和電腦的 [一般] 索引標籤中)。

職稱
Title string

使用者的「職稱」屬性 (在 AD 使用者和電腦的 [組織] 索引標籤中)。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectoryModifyADUserPropertiesResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

修改 Active Directory 使用者主資料夾

設定 Active Directory 使用者的主資料夾/目錄/磁碟機。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity True string

Active Directory 使用者的身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

家庭驅動器
HomeDrive string

如果主目錄/資料夾位於網路共用上,請指定將對應到該位置的磁碟機代號。 磁碟機代號通常是 'F' 和 'Z' 之間的單一字元。 如果主目錄/資料夾是本機的,請將此值保留空白。 如果您要將主目錄/資料夾設定為空白,也請將此值保留空白。

主目錄
HomeDirectory string

指定主資料夾/目錄的路徑。 如果您還指定了主驅動器號,則主驅動器將映射到此文件夾/目錄。 如果您要將主目錄/資料夾設定為空白,請將此值設定為空白。

建立資料夾
CreateFolder boolean

如果您想創建主文件夾/目錄(如果不存在),請將其設置為 true。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectorySetADUserHomeFolderByIdentityResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

修改 Active Directory 使用者字串屬性

修改 Active Directory 使用者的個別字串屬性。 這可讓您修改非常具體的使用者設定,包括自訂屬性。 您也可以將個別使用者屬性設定為空白。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity True string

Active Directory 使用者的身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

房產
Property string
價值觀
Value string
AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

取代值
ReplaceValue boolean

設定為 true 以取代值。 設定為 false 以新增值。 如果值已存在,則新增將不起作用 (這只會影響自訂屬性),而 replace 可用來建立新值或取代現有值。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectoryModifyADUserStringPropertyByIdentityResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

修改 Active Directory 使用者布林屬性

修改 Active Directory 使用者的個別布林值 (true/false) 屬性。 這可讓您修改非常具體的使用者設定,包括自訂屬性。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity True string

Active Directory 使用者的身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

屬性名稱
PropertyName True string

要修改的個別使用者屬性名稱。 常見的布林屬性包括:enabled、mTSAllowLogon、msExchHideFromAddressLists。

屬性值
PropertyValue boolean

要指派給指定屬性的 true/false 值。 如果您需要將值設定為 Null,請改用動作 '修改 Active Directory 使用者字串屬性',並使用空白屬性值,並將 '取代值' 設定為 '是'。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectoryModifyADUserBooleanPropertyByIdentityResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

修改 Azure AD 使用者屬性

修改 Azure Active Directory 使用者的通用屬性。 您只能將值指派給屬性,而不能將其設定為空白,因為空白值會解譯為保持值不變的意圖。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
ObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

名字
FirstName string

使用者的名字。

姓氏
LastName string

使用者的姓氏/姓氏。

顯示名稱
DisplayName string

此使用者的完整顯示名稱。

城市
City string

使用者居住的城市名稱,或其辦公室所在的位置。

公司名稱
CompanyName string

使用者工作的公司名稱。

國家或地區
Country string

使用者居住的國家或地區,或其辦公室所在的位置。

部門
Department string

使用者在公司內工作的部門名稱。

傳真號碼
FaxNumber string

使用者的傳真 (傳真) 電話號碼。

職稱
JobTitle string

使用者的職稱。

手機號碼
MobilePhone string

使用者的手機號碼。

Office
Office string

使用者工作的辦公室位置。

電話號碼
PhoneNumber string

使用者的電話號碼。

郵遞區號
PostalCode string

使用者居住的郵遞區號或郵遞區號,或他們工作的辦公室。

首選語言
PreferredLanguage string

使用者的偏好語言。 這通常以兩個字母的語言代碼 (ISO 639-1) 的形式輸入,後面接著破折號,後面接著兩個字母的大寫國家/地區代碼 (ISO 3166)。 例如:en-US、 en-GB、 fr-FR、 ja-JP。

State 或 province
State string

使用者居住的州、省或縣,或其辦公室所在的位置。

街道地址
StreetAddress string

使用者居住的街道地址,或其辦公室街道地址。

使用位置
UsageLocation string

兩個字母的國家代碼 (ISO 3166)。 對於因法律要求而獲指派授權的使用者所必需。 例如:美國 (美國)、日本 (日本)、GB (英國)、法國 (法國)、印度 (印度)。 請參閱 https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes

年齡組
AgeGroup string

使用者的年齡層,用於家長監護目的。

為未成年人提供同意書
ConsentProvidedForMinor string

如果「年齡群組」為「未成年人」,則此欄位可讓您指定是否已為未成年人提供同意,以符合家長監護目的。

郵件暱稱
MailNickName string

使用者的郵件暱稱。

員工 ID
EmployeeId string

員工 ID。您可以使用此功能來區分組織中的每個使用者。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
AzureADv2SetAzureADUserResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

修改 Microsoft Exchange Online 信箱電子郵件地址

修改現有 Microsoft Exchange Online 或 Office 365 (遠端) 信箱上的電子郵件地址。 您可以新增、移除及取代主要電子郵件地址和別名電子郵件地址。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange Online 或 Office 365 (遠端) 信箱的身分識別。 您可以依 Active Directory 物件識別碼、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、DOMAIN\username、電子郵件地址、GUID 或使用者主體名稱 (UPN) 來指定 Microsoft Exchange Online 或 Office 365 (遠端) 信箱。

Alias
Alias string

使用者的 Exchange 別名 (也稱為郵件暱稱)。 如果已啟用電子郵件地址原則,則會用來產生主要SMTP電子郵件地址的名稱元件(例如)。 alias@mydomain.com 如果未啟用電子郵件地址原則,您可能希望改為設定主要 SMTP 位址。 如果您不想變更目前值,請保留空白。

主要 SMTP 位址
PrimarySmtpAddress string

用於收件者的主要回信電子郵件地址。 如果啟用「電子郵件地址原則」,您不太可能設定此設定,因此請改用「別名」(原則會從別名建立主要 SMTP 位址),或停用電子郵件地址原則。 如果您不想變更目前值,請保留空白。

已啟用電子郵件地址原則
EmailAddressPolicyEnabled boolean

如果您想要根據套用至此收件者的電子郵件地址原則自動更新電子郵件地址,請設定為 true。 如果啟用電子郵件地址原則,這通常會影響您設定主要 SMTP 位址的能力。 設定為 false 可停用該功能,讓您完全控制手動設定電子郵件地址。 如果您不想設定此選項,請保留空白(即保留現有值或預設值)。

要新增的電子郵件地址
EmailAddressesToAddList array of string

要指派給信箱的其他 (非主要) 電子郵件地址清單。

取代電子郵件地址
ReplaceEmailAddresses boolean

如果您想要提供的電子郵件地址清單取代所有現有的電子郵件地址 (不包括主要 SMTP 位址),請設定為 true。 如果您要將提供的電子郵件地址清單新增至任何現有地址,請設定為 false。

要移除的電子郵件地址
EmailAddressesToRemoveList array of string

要從信箱中移除的其他 (非主要) 電子郵件地址清單 (如果存在的話)。 只有在「取代電子郵件地址」設為 false 或您未新增任何電子郵件地址時,才有此目的。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
郵箱電子郵件地址
MailboxEmailAddresses array of string

執行修改動作之後的信箱電子郵件地址。 主要 SMTP 電子郵件地址將顯示為 SMTP:emailaddress,次要 (Proxy) SMTP 電子郵件地址將顯示為 smtp:emailaddress,X.400 電子郵件地址將顯示為 x400:address,Exchange 整合通訊 (EUM) 位址將顯示為 eum:address。

修改 Microsoft Exchange 信箱電子郵件地址

修改 Microsoft Exchange 信箱上的電子郵件地址。 您可以新增、移除及取代主要電子郵件地址和別名電子郵件地址。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange 信箱的身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

Alias
Alias string

使用者的 Exchange 別名 (也稱為郵件暱稱)。 如果已啟用電子郵件地址原則,則會用來產生主要SMTP電子郵件地址的名稱元件(例如)。 alias@mydomain.com 如果未啟用電子郵件地址原則,您可能希望改為設定主要 SMTP 位址。 如果您不想變更目前值,請保留空白。

主要 SMTP 位址
PrimarySmtpAddress string

用於收件者的主要回信電子郵件地址。 如果啟用「電子郵件地址原則」,您不太可能設定此設定,因此請改用「別名」(原則會從別名建立主要 SMTP 位址),或停用電子郵件地址原則。 如果您不想變更目前值,請保留空白。

已啟用電子郵件地址原則
EmailAddressPolicyEnabled boolean

如果您想要根據套用至此收件者的電子郵件地址原則自動更新電子郵件地址,請設定為 true。 如果啟用電子郵件地址原則,這通常會影響您設定主要 SMTP 位址的能力。 設定為 false 可停用該功能,讓您完全控制手動設定電子郵件地址。 如果您不想設定此選項,請保留空白(即保留現有值或預設值)。

要新增的電子郵件地址
EmailAddressesToAddList array of string

要指派給信箱的其他 (非主要) 電子郵件地址清單。

取代電子郵件地址
ReplaceEmailAddresses boolean

如果您想要提供的電子郵件地址清單取代所有現有的電子郵件地址 (不包括主要 SMTP 位址),請設定為 true。 如果您要將提供的電子郵件地址清單新增至任何現有地址,請設定為 false。

要移除的電子郵件地址
EmailAddressesToRemoveList array of string

要從信箱中移除的其他 (非主要) 電子郵件地址清單 (如果存在的話)。 只有在「取代電子郵件地址」設為 false 或您未新增任何電子郵件地址時,才有此目的。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
郵箱電子郵件地址
MailboxEmailAddresses array of string

執行修改動作之後的信箱電子郵件地址。 主要 SMTP 電子郵件地址將顯示為 SMTP:emailaddress,次要 (Proxy) SMTP 電子郵件地址將顯示為 smtp:emailaddress,X.400 電子郵件地址將顯示為 x400:address,Exchange 整合通訊 (EUM) 位址將顯示為 eum:address。

停用 Active Directory 使用者帳戶

停用 Active Directory 使用者帳戶。 如果停用使用者帳戶,則使用者無法登入。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity True string

Active Directory 使用者的身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectoryDisableADUserByIdentityResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

停用 Azure AD 使用者

停用 Azure Active Directory 使用者。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
UserObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

撤銷使用者重新整理權杖
RevokeUserRefreshTokens boolean

設定為 true 可撤銷發出給使用者的任何重新整理權杖,這會導致任何開啟的會話停止運作,通常是在一小時內 (當其會話嘗試使用重新整理權杖來保持連線處於作用中時)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
AzureADv2DisableUserResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

停用使用者的 Microsoft Exchange Online 信箱

停用現有的 Microsoft Exchange Online 或 Office 365 (遠端) 信箱。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange Online 或 Office 365 (遠端) 信箱的身分識別。 您可以依 Active Directory 物件識別碼、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、DOMAIN\username、電子郵件地址、GUID 或使用者主體名稱 (UPN) 來指定 Microsoft Exchange Online 或 Office 365 (遠端) 信箱。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
動作結果JSON
PowerShellJSONOutput string

停用信箱動作的輸出,以 JSON 格式。

停用使用者的 Microsoft Exchange 信箱

停用現有的 Microsoft Exchange 信箱。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange 信箱的身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
動作結果JSON
PowerShellJSONOutput string

停用信箱動作的輸出,以 JSON 格式。

取得 Active Directory 使用者

傳回指定 Active Directory 使用者的屬性。 您可以依身分識別 (尋找單一使用者) 或使用篩選器 (尋找一或多個使用者) 進行搜尋。

參數

名稱 機碼 必要 類型 Description
身份
Identity string

Active Directory 使用者的身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

篩選屬性名稱
FilterPropertyName string

作為依身分搜尋的替代方案,請提供要篩選使用者的屬性名稱。 常見的屬性名稱包括:城市、公司、國家/地區、部門、描述、顯示名稱、部門、電子郵件地址、已啟用、givenname、homedirectory、homedrive、homephone、縮寫、經理、辦公室、組織、郵遞區號、profilepath、samaccountname、scriptpath、state、streetaddress、姓氏、title、userprincipalname。 如果將輸入「篩選器屬性比較」設為 Raw 或 LDAP,您可以將此輸入保留空白。

篩選器屬性比較
FilterPropertyComparison string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入比較類型 (例如:如果篩選器屬性名稱為「別名」,則比較可以是「等於」或「類似」)。 如果您想要輸入原始篩選器 (OPATH 格式),請選擇「原始:手動輸入篩選器」的比較類型,然後在「篩選器屬性值」欄位中輸入完整篩選器。 如果您想要輸入 LDAP 篩選器,請選擇「LDAP:輸入 LDAP 篩選器」的比較類型,然後在「篩選器屬性值」欄位中輸入完整篩選器。

篩選屬性值
FilterPropertyValue string

作為依身分搜尋的替代方案,「篩選屬性名稱」的值可依據篩選使用者。

搜尋 OU 基底
SearchOUBase string

要搜尋的最上層組織單位 (OU)。 只有在使用篩選器搜尋時才支援,而不支援依身分識別。 如果未指定,則會搜尋整個網域。 搜尋基底 OU 可以以識別名稱格式 (例如 OU=London、OU=MyUsers、DC=mydomain、DC=local)、GUID 格式或路徑 (例如 MyUsers\London) 指定。

搜尋 OU 基底子樹
SearchOUBaseSubtree boolean

如果設定為 true (預設值) 並提供搜尋 OU 基底,則會搜尋搜尋 OU 基底和所有子 OU。 如果設定為 false 並提供搜尋 OU 基底,則只會搜尋搜尋 OU 基底。 如果未提供搜尋 OU 基底,或您依身分識別搜尋,則不會使用此輸入。

要擷取的內容
Properties string

要擷取的其他使用者屬性的逗號分隔清單。 常見屬性包括:城市、公司、國家/地區、部門、描述、顯示名稱、部門、電子郵件地址、enabled、givenname、homedirectory、homedrive、homephone、縮寫、經理、辦公室、組織、郵遞區號、profilepath、samaccountname、scriptpath、state、streetaddress、姓氏、title、userprincipalname。 如果您將此欄位保留空白,則會傳回一組預設內容。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

要傳回為集合的屬性
PropertiesToReturnAsCollectionJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依名稱) IA-Connect 應該嘗試以集合的形式傳回。 視屬性、其類型和值而定,您也應該考慮使用替代輸入「要序列化的屬性名稱」和「要序列化的屬性類型」(選擇一個)。 此輸入可以 JSON 或 CSV 格式輸入。 例如:若要傳回 EmailAddresses 和 MemberOf 陣列屬性,請輸入 [{“PropertyName”: “EmailAddresses”}、{“PropertyName”: “MemberOf”}] (JSON 資料表格式)、 [“EmailAddresses”、“MemberOf”] (JSON 陣列格式) 或 EmailAddresses,MemberOf (CSV 格式)。

要序列化的屬性名稱
PropertyNamesToSerializeJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依名稱) IA-Connect 應序列化為 JSON,因此它們會傳回為字串類型 (您可以在收到後還原序列化)。 根據屬性、其類型和值,您還應該考慮使用替代輸入 '要傳回為集合的屬性' 和 '要序列化的屬性類型' (選擇一個)。 例如:若要序列化 EmailAddresses 和 MemberOf 屬性,請輸入 [{“PropertyName”: “EmailAddresses”}、{“PropertyName”: “MemberOf”}] (JSON 資料表格式)、 [“EmailAddresses”、“MemberOf”] (JSON 陣列格式) 或 EmailAddresses,MemberOf (CSV 格式)。

要序列化的內容類型
PropertyTypesToSerializeJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依類型) IA-Connect 應序列化為 JSON,因此它們會傳回為字串類型 (收到後可以還原序列化)。 根據屬性、其類型和值,您也應該考慮使用替代輸入「要傳回為集合的屬性」和「要序列化的屬性名稱」(選擇一個)。 此輸入是具有單一 'PropertyType' 欄位的集合。 例如:若要序列化 Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] 類型的任何屬性,請輸入 [{“PropertyType”: “Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]”}] (JSON 資料表格式)、 [“Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]”] (JSON 陣列格式) 或 'Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (CSV 格式)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
搜尋結果JSON
PowerShellJSONOutput string

符合搜尋身分的使用者 (及其要求的屬性) 清單,採用 JSON 格式。

找到的使用者計數
CountOfUsersFound integer

找到符合搜尋身分的使用者數目。 如果依身分識別搜尋,通常為 0 或 1,如果依篩選屬性搜尋,則為 0 或更多。

取得 Active Directory 使用者群組成員資格

傳回指定使用者所屬的 Active Directory 群組清單,減去主要群組 (通常是「網域使用者」) ,因為技術上它不是成員資格。 此動作僅適用於使用者帳戶,您無法使用此動作來查詢群組或電腦的群組成員資格。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity True string

要查詢群組成員資格的使用者。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
群組成員資格 JSON
GroupMembershipJSON string

使用者所屬的 AD 群組清單,採用 JSON 格式。

找到的群組計數
CountOfGroupsFound integer

使用者所屬的 AD 群組數目,減去主要群組 (通常是「網域使用者」) (不計算在內)。

取得 Active Directory 網域資訊

擷取 Active Directory 網域的相關資訊。

參數

名稱 機碼 必要 類型 Description
AD 伺服器
ADServer string

要傳送網域要求的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 然後,網域控制站將取得指定網域的請求資訊。

預先定義的網域身分識別
PredefinedIdentity string

使用者:將擷取目前登入使用者所屬網域的資訊。 電腦:將會擷取電腦 (執行 IA-Connect 會話) 所屬網域的資訊。 手動:在「網域身分」欄位中輸入 Active Directory 網域。 如果此欄位為空白,且「網域身分」欄位有值,則會使用該值。

網域身分識別
Identity string

只有在「預先定義的網域身分識別」設定為「手動」(或空白)時,才會使用此欄位。 要擷取其網域資訊的 Active Directory 網域身分識別。 您可以依識別名稱 (例如 DC=mydomain,DC=local)、GUID、SID、DNS 網域名稱 (例如 mydomain.local) 或 NetBIOS 名稱 (例如 MYDOMAIN) 來指定 Active Directory 網域。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
顯著名稱
DistinguishedName string

網域的識別名稱 (DN)。

DNS 根名稱
DNSRoot string

網域最上層 DNS 根目錄的名稱。

網域模式
DomainMode string

網域的模式或層級 (例如 Windows2003Domain 或 Windows2016Domain)。

網域 SID
DomainSID string

網域的安全性識別碼 (SID)。

樹系
Forest string

Active Directory 樹系的名稱 (最頂層的邏輯容器)。

基礎架構主控者
InfrastructureMaster string

具有基礎結構主機角色的網域控制站 (DC) 名稱。

網域 NetBIOS 名稱
NetBIOSName string

網域的 NetBIOS 名稱 (例如 MYDOMAIN)。

網域 GUID
ObjectGUID string

網域的 GUID。

PDC 模擬器
PDCEmulator string

具有 PDC 模擬器角色的網域控制站 (DC) 名稱。

RID主
RIDMaster string

具有 RID 主要角色的網域控制站 (DC) 名稱。

取得 Active Directory 群組

傳回指定 Active Directory 群組或群組的屬性。 您可以依身分 (尋找單一群組) 或使用篩選器 (尋找一或多個群組) 進行搜尋。

參數

名稱 機碼 必要 類型 Description
身份
Identity string

Active Directory 群組的身分識別。 您可以依識別名稱 (例如 CN=Group1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'Group1') 來指定群組。 您不能使用顯示名稱或群組名稱(儘管群組名稱通常與可以使用的 2K 之前名稱相同)。

篩選屬性名稱
FilterPropertyName string

作為依身分搜尋的替代方案,請提供要篩選群組的屬性名稱。 群組搜尋的常見屬性名稱包括:name、description、samaccountname。

篩選器屬性比較
FilterPropertyComparison string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入比較類型 (例如:如果篩選器屬性名稱為「別名」,則比較可以是「等於」或「類似」)。 如果您想要輸入原始篩選器 (OPATH 格式),請選擇「原始:手動輸入篩選器」的比較類型,然後在「篩選器屬性值」欄位中輸入完整篩選器。 如果您想要輸入 LDAP 篩選器,請選擇「LDAP:輸入 LDAP 篩選器」的比較類型,然後在「篩選器屬性值」欄位中輸入完整篩選器。

篩選屬性值
FilterPropertyValue string

作為依身分搜尋的替代方案,「篩選屬性名稱」的值可依據篩選群組。

搜尋 OU 基底
SearchOUBase string

要搜尋的最上層組織單位 (OU)。 只有在使用篩選器搜尋時才支援,而不支援依身分識別。 如果未指定,則會搜尋整個網域。 OU 可以以識別名稱格式 (例如 OU=London、OU=MyGroups、DC=mydomain、DC=local)、GUID 格式或路徑 (例如 MyGroups\London) 指定。

搜尋 OU 基底子樹
SearchOUBaseSubtree boolean

如果設定為 true (預設值) 並提供搜尋 OU 基底,則會搜尋搜尋 OU 基底和所有子 OU。 如果設定為 false 並提供搜尋 OU 基底,則只會搜尋搜尋 OU 基底。 如果未提供搜尋 OU 基底,或您依身分識別搜尋,則不會使用此輸入。

如果群組不存在,則引發例外狀況
RaiseExceptionIfGroupDoesNotExist boolean

如果設定為 true 且群組不存在,則會引發例外狀況。 如果設定為 false 且群組不存在,則動作會報告成功,但輸出會報告找不到群組。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
搜尋結果JSON
PowerShellJSONOutput string

符合搜尋身分的群組 (及其要求的內容) 清單。

找到的群組計數
CountOfGroupsFound integer

找到符合搜尋身分的群組數目。 身分搜尋的預期值為 0 或 1,或篩選搜尋的任何值。

取得 Active Directory 群組成員

傳回 Active Directory 群組的成員清單。

參數

名稱 機碼 必要 類型 Description
群組身分
GroupIdentity True string

Active Directory 群組的身分識別。 您可以依識別名稱 (例如 CN=Group1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'Group1') 來指定群組。 您不能使用顯示名稱或群組名稱(儘管群組名稱通常與可以使用的 2K 之前名稱相同)。

遞迴
Recursive boolean

如果設定為 false (預設值),則只會傳回群組的直接成員。 如果設定為 true,則會傳回直接成員和成員的成員,基本上會傳回所有層級的所有 AD 成員。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
群組成員JSON
GroupMembersJSON string

AD 群組成員的清單,採用 JSON 格式。

找到的群組成員計數
CountOfGroupMembersFound integer

AD 群組成員的數目。

取得 Azure AD 使用者

傳回 Azure Active Directory 中使用者的詳細數據 (也稱為 Microsoft Entra ID、Azure AD 或 AAD)。 您可以依物件 ID 或使用篩選器進行搜尋。 物件標識碼搜尋應該傳回 0 或 1 個結果。 篩選搜尋可能會傳回 0 個或多個結果。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
ObjectId string

要搜尋的 Azure Active Directory 使用者的物件識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

篩選屬性名稱
FilterPropertyName string

作為依使用者物件識別碼搜尋的替代方案,請提供要篩選使用者的屬性名稱。 常見的屬性名稱為:UserPrincipalName 和 DisplayName。 如果使用篩選器,您也必須填入「篩選器資源比較」和「篩選器資源值」欄位。

篩選器屬性比較
FilterPropertyComparison string

如果依篩選搜尋作為依使用者物件識別碼搜尋的替代方案,請在此處輸入比較類型 (例如:如果篩選屬性名稱為 'UserPrincipalName',則比較可以是 'equals' 或 'starts with')。 如果您想要輸入原始篩選器 (ODATA 3 格式),請選擇「原始:手動輸入篩選器」的比較類型,然後在「篩選器屬性值」欄位中輸入完整篩選器。

篩選屬性值
FilterPropertyValue string

如果依篩選搜尋作為依使用者物件識別碼搜尋的替代方案,請在此處輸入篩選屬性的值 (例如:如果篩選屬性名稱為 'UserPrincipalName',則篩選屬性值可能是 'JohnDoe@mydomain.com')。

沒有結果是例外嗎
NoResultIsAnException boolean

設定為 true,可在找不到使用者時引發例外狀況。 設定為 false ,如果找不到信箱,則只會報告計數 0。 請注意,「false」選項在與非英文語言的身分識別搭配使用時可能無法運作,因此請考慮改用篩選器進行搜尋。

要傳回的屬性
PropertiesToReturn string

要傳回 (擷取) 的使用者屬性的逗號分隔清單。 一般屬性包括:AccountEnabled、City、CompanyName、Country、Department、DisplayName、GivenName、JobTitle、PostalCode、State、StreetAddress、Surname、UserPrincipalName。 如果您將此欄位保留空白,則會擷取一組預設內容。 如果您指定要擷取的內容,則只會擷取這些內容。 如果使用 Azure AD v2 PowerShell 模組,則沒有任何作用。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
搜尋結果JSON
PowerShellJSONOutput string

符合搜尋篩選器的使用者清單,採用 JSON 格式。

找到的使用者計數
CountOfUsersFound integer

找到符合搜尋物件識別碼、UPN 或篩選條件的使用者數目。

取得 Azure AD 使用者授權

擷取指派給 Azure AD 使用者的授權 (SKU) 清單。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
ObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
使用者授權SKU JSON
UserLicenseSKUJSONOutput string

指派給使用者的 Azure AD 授權 SKU 清單,採用 JSON 格式。

找到的使用者授權 SKU 計數
CountOfUserLicenseSKUsFound integer

指派給使用者的 Azure AD 授權 SKU 數目。

取得 Azure AD 使用者授權服務方案

擷取指派給指定 Azure AD 使用者授權 (SKU) 的授權方案清單。 例如:如果使用者已指派FLOW_FREE授權,這將允許您檢視他們已佈建至該授權的服務方案。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
ObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

授權 SKU 零件編號
LicenseSKUPartNumber True string

授權 SKU 的零件編號。 例如:FLOW_FREE或SPE_E3。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
使用者授權 SKU 服務方案 JSON
UserLicenseSKUServicePlansJSONOutput string

指派給指派給使用者之指定 Azure AD 授權 SKU 的服務方案清單,以 JSON 格式。

找到的授權 SKU 服務方案計數
CountOfUserLicenseSKUServicePlansFound integer

指派給指派給使用者之指定授權 SKU 的 Azure AD 服務方案數目。

取得 Azure AD 使用者系統管理員角色指派

傳回指定使用者指派給的 Azure Active Directory 系統管理員角色清單。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
ObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

擷取系統管理員角色名稱
RetrieveAdminRoleNames boolean

如果設定為 true,則 IA-Connect 代理程式除了角色識別碼之外,還會擷取每個角色的名稱。 這需要更長的時間,但提供更可讀的資訊。 如果設定為 false,則 IA-Connect 代理程式將不會擷取角色名稱。

傳回指派標識符
ReturnAssignmentIds boolean

如果設定為 true,IA-Connect 代理程式會擷取每個角色指派的指派識別碼。 只有在您想要對角色指派執行某些自訂動作 (而不是使用內建 IA-Connect 動作) 時,才需要指派識別碼。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
角色指派 JSON
PowerShellJSONOutput string

指派使用者的 Azure AD 系統管理員角色清單,採用 JSON 格式。

找到的角色指派計數
CountOfRoleAssignmentsFound integer

指派給使用者的 Azure AD 系統管理員角色數目。

取得 Azure AD 使用者群組成員資格

傳回指定使用者所屬的 Azure Active Directory 群組清單。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
ObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

要傳回的屬性
PropertiesToReturn string

要傳回 (擷取) 的所有群組屬性的逗號分隔清單 (CSV)。 如果空白 (預設值),IA-Connect 會傳回所有群組屬性。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
群組成員資格 JSON
PowerShellJSONOutput string

使用者所屬的 Azure AD 群組清單,採用 JSON 格式。

找到的群組計數
CountOfGroupsFound integer

使用者所屬的 Azure AD 群組數目。

取得 Azure AD 授權 SKU

傳回已連線 Azure AD 訂閱的 Azure Active Directory 授權庫存單位 (SKU) 清單。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
展開屬性
ExpandProperty string

可展開並包含在輸出中的選用授權內容。 如果您展開 'PrepaidUnits',則輸出中將包含授權資訊,包括已啟用的授權總數。 如果您展開「ServicePlans」,SKU 內的每個個別服務方案都會傳回為個別的輸出明細項目。 您一次只能展開一個屬性。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
授權 SKU JSON
LicenseSKUJSONOutput string

訂閱庫存單位的清單,採用 JSON 格式。

找到的 SKU 計數
CountOfSKUsFound integer

Azure AD 訂閱庫存單位 (SKU) 的數目。

取得 Azure AD 群組

傳回 Azure Active Directory 中群組的詳細數據 (也稱為 Microsoft Entra ID、Azure AD 或 AAD)。 您可以依物件 ID 或使用篩選器進行搜尋。 物件標識碼搜尋應該傳回 0 或 1 個結果。 篩選搜尋可能會傳回 0 個或多個結果。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
群組物件識別碼
ObjectId string

要搜尋的 Azure Active Directory 群組的物件識別碼。 您可以依顯示名稱 (例如「財務使用者」) 或 ObjectId (例如 UUID/GUID 值) 指定群組。

篩選屬性名稱
FilterPropertyName string

作為依群組物件識別碼搜尋的替代方案,請提供要篩選群組的屬性名稱。 常見的群組屬性名稱包括:Description、DisplayName 和 Mail。 如果使用篩選器,您也必須填入「篩選器資源比較」和「篩選器資源值」欄位。

篩選器屬性比較
FilterPropertyComparison string

如果依篩選器搜尋,而不是依群組物件識別碼搜尋,請在此處輸入比較類型 (例如:如果篩選器屬性名稱為 'DisplayName',則比較可以是 '等於'或'開頭為')。 如果您想要輸入原始篩選器 (ODATA 3 格式),請選擇「原始:手動輸入篩選器」的比較類型,然後在「篩選器屬性值」欄位中輸入完整篩選器。

篩選屬性值
FilterPropertyValue string

如果依篩選器搜尋,而不是依群組物件識別碼搜尋,請在此處輸入篩選器屬性的值 (例如:如果篩選器屬性名稱為 'DisplayName',則篩選器屬性值可能是 'London users')。

沒有結果是例外嗎
NoResultIsAnException boolean

設定為 true,可在找不到群組時引發例外狀況。 設定為 false ,如果找不到群組,則只會報告計數 0。 請注意,「false」選項在與非英文語言的身分識別搭配使用時可能無法運作,因此請考慮改用篩選器進行搜尋。

要傳回的屬性
PropertiesToReturn string

要傳回 (擷取) 的所有群組屬性的逗號分隔清單 (CSV)。 如果空白 (預設值),IA-Connect 會傳回一組預設的通用群組屬性。 如果使用 Microsoft Graph 使用者 PowerShell 模組,輸入可讓您限制傳回的屬性或傳回其他屬性。 如果使用 Azure AD v2,輸入只允許您限制傳回的屬性。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
搜尋結果JSON
PowerShellJSONOutput string

符合搜尋物件 ID 或篩選器的群組清單,採用 JSON 格式。

找到的群組計數
CountOfGroupsFound integer

找到符合搜尋物件 ID 或篩選器的群組數目。

取得 Azure AD 群組成員

傳回 Azure Active Directory 群組的成員清單。 成員可以是使用者、群組、裝置或服務主體/企業應用程式。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
群組物件識別碼或 UPN
GroupObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

要傳回的屬性
PropertiesToReturn string

要傳回 (擷取) 的所有成員屬性的逗號分隔清單 (CSV)。 如果空白 (預設值) ,IA-Connect 會傳回 AccountEnabled、DirSyncEnabled、DisplayName、Mail、MailNickName、ObjectId、ObjectType、SecurityEnabled、UserPrincipalName。 輸入 * 以接收所有屬性。

要傳回的成員物件類型
MemberObjectTypesToReturn string

要傳回 (擷取) 的所有成員物件類型的逗點分隔清單 (CSV)。 如果空白 (預設值),IA-Connect 會傳回所有成員物件類型,這些類型可以是下列一或多個:User、Group、Device、ServicePrincipal。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
群組成員JSON
PowerShellJSONOutput string

AD 群組成員的清單,採用 JSON 格式。

找到的群組成員計數
CountOfGroupMembersFound integer

Azure AD 群組成員的數目。

取得 Microsoft Exchange 通訊群組成員

擷取 Microsoft Exchange 通訊群組成員清單。

參數

名稱 機碼 必要 類型 Description
通訊群組身分識別
Identity True string

要搜尋的通訊群組身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=MyGroup、OU=My Groups、DC=mydomain、DC=local)、電子郵件地址或 GUID 來指定通訊群組。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
通訊群組成員
DistributionGroupMembersJSON string

Exchange 通訊群組的成員清單,採用 JSON 格式。

通訊群組成員計數
CountOfDistributionGroupsMembers integer

Microsoft Exchange 通訊群組的成員數目。

取得 Office 365 信箱

傳回指定 Microsoft Exchange Online 或 Office 365 信箱的屬性。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity string

Microsoft Exchange Online 或 Office 365 信箱的識別碼。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

篩選屬性名稱
FilterPropertyName string

作為依身分識別搜尋的替代方案,請提供要篩選信箱的屬性名稱。 常見的屬性名稱包括:Name、Alias、PrimarySMTPAddress、DisplayName、SamAccountName。 如果使用篩選器,您也必須填入「篩選器資源比較」和「篩選器資源值」欄位。

篩選器屬性比較
FilterPropertyComparison string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入比較類型 (例如:如果篩選器屬性名稱為「別名」,則比較可以是「等於」或「類似」)。 如果您想要輸入原始篩選器 (OPATH 格式),請選擇「原始:手動輸入篩選器」的比較類型,然後在「篩選器屬性值」欄位中輸入完整篩選器。

篩選屬性值
FilterPropertyValue string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入篩選器屬性的值 (例如:如果篩選器屬性名稱為 'Alias',則篩選器屬性值可能是 'JohnDoe')。

收件者類型詳細資料
RecipientTypeDetails string

要搜尋的信箱類型。 如果此欄位留空,則搜尋中將包含所有類型的信箱。

沒有結果是例外嗎
NoResultIsAnException boolean

設定為 true,可在找不到信箱時引發例外狀況。 設定為 false ,如果找不到信箱,則只會報告計數 0。 請注意,「false」選項在與非英文語言的身分識別搭配使用時可能無法運作,因此請考慮改用篩選器進行搜尋。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
搜尋結果JSON
PowerShellJSONOutput string

符合搜尋身分識別的信箱 (及其屬性) 清單,採用 JSON 格式。

找到的信箱計數
CountOfMailboxesFound integer

找到符合搜尋身分的信箱數目。 通常 1.

取得 Office 365 通訊群組

傳回指定 Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組的屬性。 您可以依身分或使用篩選器進行搜尋。 身分識別搜尋應該會傳回 0 或 1 個結果。 篩選搜尋可能會傳回 0 個或多個結果。

參數

名稱 機碼 必要 類型 Description
通訊群組身分識別
Identity string

通訊群組或已啟用郵件的安全性群組身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=MyGroup、OU=My Groups、DC=mydomain、DC=local)、電子郵件地址或 GUID 來指定通訊群組。

篩選屬性名稱
FilterPropertyName string

作為依身分識別搜尋的替代方案,請提供屬性名稱以篩選通訊群組。 常見的屬性名稱包括:DisplayName、Name、GroupType、PrimarySMTPAddress。 如果使用篩選器,您也必須填入「篩選器資源比較」和「篩選器資源值」欄位。

篩選器屬性比較
FilterPropertyComparison string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入比較類型 (例如:如果篩選器屬性名稱為「別名」,則比較可以是「等於」或「類似」)。 如果您想要輸入原始篩選器 (OPATH 格式),請選擇「原始:手動輸入篩選器」的比較類型,然後在「篩選器屬性值」欄位中輸入完整篩選器。

篩選屬性值
FilterPropertyValue string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入篩選器屬性的值 (例如:如果篩選器屬性名稱為 'Alias',則篩選器屬性值可能是 'JohnDoe')。

沒有結果是例外嗎
NoResultIsAnException boolean

設定為 true,以在找不到通訊群組時引發例外狀況。 設定為 false,如果找不到通訊群組,則只會報告計數 0。 請注意,「false」選項在與非英文語言的身分識別搭配使用時可能無法運作,因此請考慮改用篩選器進行搜尋。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
搜尋結果JSON
PowerShellJSONOutput string

PowerShell 指令碼的輸出,格式為 JSON。

找到的群組計數
CountOfGroupsFound integer

符合搜尋身分識別的通訊群組或已啟用郵件的安全性群組數目。 通常 1.

取得 Office 365 通訊群組成員

擷取 Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組成員清單。

參數

名稱 機碼 必要 類型 Description
通訊群組身分識別
GroupIdentity True string

要搜尋的通訊群組身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=MyGroup、OU=My Groups、DC=mydomain、DC=local)、電子郵件地址或 GUID 來指定通訊群組。

要擷取的內容
PropertiesToRetrieveJSON string

要擷取的成員屬性清單,採用 JSON 或 CSV 格式。 例如:[“Identity”、“DistinguishedName”] (JSON 陣列格式) 或 “Identity”,“DistinguishedName” (CSV 格式)。 常見的成員屬性包括:Alias、DisplayName、DistinguishedName、Identity、Name、PrimarySMTPAddress、RecipientType 和 SamAccountName。 如果您將此欄位保留空白,則會擷取一組預設內容。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
通訊群組成員
O365DistributionGroupMembersJSON string

Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組成員清單,採用 JSON 格式。

通訊群組成員計數
O365CountOfDistributionGroupsMembers integer

Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組的成員數目。

取得下一個可用的帳戶名稱

根據 Active Directory 和 Exchange 帳戶名稱命名格式的詳細數據,提供下一個可用備用帳戶名稱的詳細數據。 用來決定要為指定使用者建立的 Active Directory 和 Exchange 帳戶。 此操作不會創建任何帳戶,它會提供有關名稱可用性的信息。

參數

名稱 機碼 必要 類型 Description
名字
FirstName string

使用者的名字。 如果使用者的名字未用於建構帳戶名稱,請保留空白 (罕見)。

中間名
MiddleName string

使用者的中間名 (選擇性)。 如果使用者的中間名未用於建構帳戶名稱,請保留空白。

姓氏
LastName string

使用者的姓氏/家庭/姓氏。 如果使用者的姓氏未用於建構帳戶名稱,請保留空白。

欄位 A
FieldA string

用於建構帳戶名稱的附加欄位。 如果不需要其他欄位來建構帳戶名稱,請保留空白。

欄位 B
FieldB string

用於建構帳戶名稱的附加欄位。 如果不需要其他欄位來建構帳戶名稱,請保留空白。

領域 C
FieldC string

用於建構帳戶名稱的附加欄位。 如果不需要其他欄位來建構帳戶名稱,請保留空白。

欄位 D
FieldD string

用於建構帳戶名稱的附加欄位。 如果不需要其他欄位來建構帳戶名稱,請保留空白。

M 起始值
VariableMStartValue integer

(選擇性地)可讓您設定 {M} 變數的初始值,該值可用於屬性格式,以表示隨著每次疊代而增加的變數。

N 個起始值
VariableNStartValue integer

(選擇性地)可讓您設定 {N} 變數的初始值,該值可用於屬性格式,以表示隨著每次疊代而增加的變數。

X 起始值
VariableXStartValue integer

(選擇性地)可讓您設定{X}變數的起始值,該值可用於屬性格式,以表示隨著每次疊代而增加的變數。

嘗試次數上限
MaxAttempts integer

在 IA-Connect 放棄嘗試尋找可用帳戶之前的最大嘗試次數(嘗試不同的值)。

後援會導致重新測試
FallbackCausesRetest boolean

如果設定為 true:如果任何規則的任何可用性檢查都需要回復為不同的格式,測試將從清單頂端重新啟動,以確保所有屬性都使用相同的格式 (例如主要、主要、主要或後援、後援、後援)。 這會讓結果保持同步,而且是建議的值。 只有當您確切地知道自己在做什麼時,才設定為 false。

不使用的號碼列表
NumbersNotToUse string

不用於 M、N 或 X 值的逗號分隔數字列表。例如:「13, 666」。

要從輸入中移除的字元
CharactersToRemoveFromInputs string

包含您要從輸入中移除的所有字元的字串 (例如,如果使用者名稱包含無效字元)。 例如:!@&?^*。

從輸入中移除變音符號
RemoveDiacriticsFromInputs boolean

如果設定為 true,IA-Connect 會嘗試從輸入欄位中移除所有變音符號,並將字元取代為具有相同字元減去變音符號的變音符號。 例如:將「重音 a」替換為「a」。 在沒有直接對應至簡單字元的案例中,會移除字元。 例如:去掉德語升號 S。

從輸入中移除非英數字元
RemoveNonAlphaNumericFromInputs boolean

如果設定為 true,IA-Connect 會從輸入欄位中移除所有非英數字元。

序列 A1
SequenceA1 string

用於 {A1} 變數的逗號分隔字串清單,可在屬性格式中使用,以表示每次嘗試尋找可用帳戶時都會變更的值。 例如:如果您為此值指定 'A,B,C,D,E,F',則格式 '{FirstName}{A1}' 將檢查 {FirstName}A 後跟 {FirstName}B 等的可用性。

房產
PropertyToCheck string

要檢查哪些帳戶屬性是否有可用性

格式
PropertyNameFormat string

此屬性值的格式。 例如:{FirstName}。{LastName} 或 {FirstName first 1}。{姓氏}

格式遞援
PropertyNameFallbackFormat string

此屬性值的後援格式 (如果已採用該值)。 例如:{FirstName}。{姓氏}{NN} 或 {FirstName first 1}。{姓氏}{NN}

格式化第二個後援
PropertyNameFallbackFormat2 string

此屬性值的第二個後援格式(如果已採用值和第一個後援)。 例如:{FirstName}。{姓氏}{NN} 或 {FirstName first 1}。{姓氏}{NN}

值最大長度
PropertyNameMaxLength integer

在必須剪切某些內容之前,此欄位值的最大長度

如果最大長度,則要切割的欄位
PropertyNameMaxLengthFieldToCut string

如果超過此欄位值的最大長度,則應切斷哪個輸入。 例如:如果您想從姓氏/姓氏/姓氏中剪切以縮短屬性值,請選擇 LastName。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
AD 使用者 SAMAccountName
ActiveDirectorySAMAccountName string

可用的 Active Directory 使用者 SAMAccountName (如果它是檢查可用性的其中一個屬性)。

AD 使用者帳戶名稱
ActiveDirectoryAccountName string

可用的 Active Directory 使用者帳戶名稱 (如果它是檢查可用性的其中一個屬性)。

AD 使用者主體名稱
ActiveDirectoryUPN string

可用的 Active Directory 使用者主體名稱 (如果它是檢查可用性的其中一個屬性)。

AD 使用者電子郵件地址
ActiveDirectoryEmailAddress string

可用的 Active Directory 電子郵件地址 (如果它是檢查可用性的其中一個屬性)。

Exchange 信箱電子郵件地址
ExchangeMailboxAddress string

可用的 Exchange 電子郵件信箱位址 (如果它是檢查可用性的其中一個屬性) 。

Exchange 信箱別名
ExchangeMailboxAlias string

可用的 Exchange 信箱別名 (如果它是檢查可用性的其中一個屬性) 。

Exchange 遠端信箱位址
ExchangeRemoteMailboxAddress string

可用的 Exchange 遠端信箱位址 (如果它是檢查可用性的其中一個屬性) 。

Azure AD 使用者主體名稱
AzureADUPN string

可用的 Azure Active Directory 使用者主體名稱 (如果它是檢查可用性的其中一個屬性)。

Office 365 使用者主體名稱
Office365UPN string

可用的 Office 365 使用者主體名稱 (如果它是檢查可用性的其中一個屬性)。

Office 365 信箱電子郵件地址
Office365MailboxEmailAddress string

可用的 Office 365 電子郵件信箱位址 (如果它是檢查可用性的其中一個屬性)。

M 最終值
MValue integer

變數 M 的最終值 (如果已使用)。

N 最終值
NValue integer

變數 N 的最終值 (如果已使用的話)。

X 最終值
XValue integer

變數 X 的最終值 (如果已使用)。

使用的格式索引
FormatIndexUsed integer

用來比對屬性的格式索引。 1 = 主要格式,2 = 後援格式,3 = 第二個後援格式。 這可讓您知道初始格式是否產生可用的帳戶,或 IA-Connect 是否必須回退至其他提供的格式。

啟用 Active Directory 使用者帳戶

啟用 Active Directory 使用者帳戶。 如果帳戶未停用,則此命令不會執行任何動作。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity True string

Active Directory 使用者的身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectoryEnableADUserByIdentityResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

啟用 Azure AD 使用者

啟用 Azure Active Directory 使用者。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
UserObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
AzureADv2EnableUserResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

執行 Active Directory DirSync

在 Active Directory (內部部署) 和 Azure Active Directory (雲端) 之間執行同步處理。 此命令必須發出給具有「DirSync」角色的伺服器(即執行同步的電腦)。

參數

名稱 機碼 必要 類型 Description
原則類型
PolicyType string

要執行的同步類型。 選項包括「差異」來執行自上次同步以來的變更同步(預設選項)和「初始」來執行完整同步(除非您確切知道自己在做什麼,否則不要這樣做)。

電腦名稱
ComputerName string

具有「DirSync」角色的伺服器(即執行同步處理的電腦)。

重試嘗試次數上限
MaxRetryAttempts integer

如果目錄同步收到忙碌或逾時錯誤,它可以暫停並重試。 此輸入指定重試次數上限。 設定為 0 可停用重試。 請注意,如果您將此值設定得太高,則可能會發生 IA-Connect 動作逾時。

重試之間的秒數
SecondsBetweenRetries integer

如果代理程式重試目錄同步,則重試之間應間隔多少秒。 如果設定為小於 1 的值,代理程式會忽略此輸入並使用 1 秒的值。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
DirSync 結果 JSON
PowerShellJSONOutput string

Active Directory 同步處理作業的結果,以 JSON 格式。

執行 Active Directory PowerShell 腳本

在執行 IA-Connect 代理程式之工作階段的 Active Directory 執行空間中執行 PowerShell 指令碼,其中指令碼內容會作為命令的一部分傳遞至 IA-Connect 代理程式。 這是執行您自己的自訂 Active Directory PowerShell 程式碼的建議動作。 此動作也可用來擷取先前執行 PowerShell 指令碼的結果,並以代理程式執行緒的形式執行。

參數

名稱 機碼 必要 類型 Description
PowerShell 腳本內容
PowerShellScriptContents string

要在 Active Directory 執行空間中執行的 PowerShell 指令碼內容。 IA-Connect 將透過直接傳遞到 PowerShell 自動化引擎來執行此腳本 as-is。 實際上不會在磁碟上建立任何 PowerShell 腳本。 或者,您可以在磁碟上執行現有的 PowerShell 腳本,方法是輸入下列內容:return &; 'scriptpath'。 例如:return & 'c:\scripts\ADTestScript.ps1'。

沒有結果是錯誤嗎
IsNoResultAnError boolean

如果 PowerShell 命令未傳回任何資料,這是否表示錯誤?

傳回複式類型
ReturnComplexTypes boolean

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 輸入 'Properties to return as collection'、'Properties names to serialize' 和 'Property types to serialize' 可讓您指定應該傳回哪些「複雜」屬性,以及用來格式化資料的方法 (根據屬性,挑選最有效的一個)。 此輸入可讓您指定應該對任何剩餘屬性執行的動作 (即「複雜」且未明確命名的屬性)。 如果設定為 true,IA-Connect 將嘗試使用 ToString() 傳回資料的字串表示法。 如果設定為 false (預設值),則 IA-Connect 不會傳回屬性。

將布林值傳回為布林值
ReturnBooleanAsBoolean boolean

布林屬性是否應該作為布林值返回? 如果為 false,則會以字串的形式傳回。

傳回數值為十進位
ReturnNumericAsDecimal boolean

Numeric 屬性應該以 Numerics 的形式傳回嗎? 如果為 false,則會以字串的形式傳回。

將返回日期作為日期
ReturnDateAsDate boolean

Date 屬性應該以 Dates 的形式傳回嗎? 如果為 false,則會以字串的形式傳回。

要傳回為集合的屬性
PropertiesToReturnAsCollectionJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依名稱) IA-Connect 應該嘗試以集合的形式傳回。 視屬性、其類型和值而定,您也應該考慮使用替代輸入「要序列化的屬性名稱」和「要序列化的屬性類型」(選擇一個)。 此輸入可以 JSON 或 CSV 格式輸入。 例如:若要傳回 EmailAddresses 和 MemberOf 陣列屬性,請輸入 [{“PropertyName”: “EmailAddresses”}、{“PropertyName”: “MemberOf”}] (JSON 資料表格式)、 [“EmailAddresses”、“MemberOf”] (JSON 陣列格式) 或 EmailAddresses,MemberOf (CSV 格式)。

以執行緒身分執行指令碼
RunScriptAsThread boolean

如果設定為 false (預設值),IA-Connect 代理程式會立即執行 PowerShell 腳本,並在腳本完成時將結果傳回給 Director。 如果執行長或複雜的 PowerShell 腳本,此動作可能會逾時。如果設定為 true,IA-Connect 代理程式會以代理程式執行緒的 PowerShell 指令碼執行,而 IA-Connect 導向器 (或 Orchestrator、PowerShell 模組、Blue Prism) 可以監控此代理程式執行緒的狀態,並等待其完成。 這允許長或複雜的 PowerShell 腳本在沒有逾時的情況下運行。 IA-Connect 代理程式 9.3 和更早版本無法將 PowerShell 指令碼作為代理程式執行緒執行。

擷取執行緒識別碼的輸出資料
RetrieveOutputDataFromThreadId integer

如果您先前以代理程式執行緒身分執行 PowerShell 腳本,並將 [等候執行緒的秒數] 設定為 0,請提供代理程式執行緒識別碼以擷取結果。 此代理程式執行緒識別碼將由先前呼叫此動作提供。 如果您只是執行 PowerShell 指令碼,請設定為 0 (預設值) (,因此不會擷取先前以代理程式執行緒執行的 PowerShell 指令碼的結果)。

等待執行緒的秒數
SecondsToWaitForThread integer

如果「以執行緒身分執行指令碼」設定為 true,則要等待代理程式執行緒完成的秒數。 如果執行 PowerShell 腳本的代理程式執行緒在此時間內尚未完成,則會引發例外狀況。 設定為 0 以略過等候:代理程式會繼續執行 PowerShell 腳本,但也可用於下一個動作。 然後,您可以使用動作 [等候代理程式執行程成功完成] 來等候代理程式執行緒完成,然後重新執行此 [執行 PowerShell 腳本] 動作,並將輸入 [擷取執行緒識別碼的輸出資料] 設定為代理程式執行緒識別碼。

指令碼包含儲存的密碼
ScriptContainsStoredPassword boolean

如果指令碼包含格式為 {IAConnectPassword:StoredPasswordIdentifier} 的 IA-Connect 儲存密碼識別碼,或格式為 {OrchestratorCredential:FriendlyName} 的 IA-Connect Orchestrator 一般認證,則設定為 true。 { } 片語將被指定的密碼替換,轉義並放在單引號中(除非它已經在腳本中放在引號中)。

記錄詳細輸出
LogVerboseOutput boolean

設定為 true,可將任何 PowerShell 詳細輸出記錄到 IA-Connect 記錄中。 這對於偵錯很有用。 若要在腳本中詳細記錄,請使用下列 PowerShell:Write-Verbose 'My message' -Verbose。

要序列化的屬性名稱
PropertyNamesToSerializeJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依名稱) IA-Connect 應序列化為 JSON,因此它們會傳回為字串類型 (您可以在收到後還原序列化)。 根據屬性、其類型和值,您還應該考慮使用替代輸入 '要傳回為集合的屬性' 和 '要序列化的屬性類型' (選擇一個)。 例如:若要序列化 EmailAddresses 和 MemberOf 屬性,請輸入 [{“PropertyName”: “EmailAddresses”}、{“PropertyName”: “MemberOf”}] (JSON 資料表格式)、 [“EmailAddresses”、“MemberOf”] (JSON 陣列格式) 或 EmailAddresses,MemberOf (CSV 格式)。

要序列化的內容類型
PropertyTypesToSerializeJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依類型) IA-Connect 應序列化為 JSON,因此它們會傳回為字串類型 (收到後可以還原序列化)。 根據屬性、其類型和值,您也應該考慮使用替代輸入「要傳回為集合的屬性」和「要序列化的屬性名稱」(選擇一個)。 此輸入是具有單一 'PropertyType' 欄位的集合。 例如:若要序列化 Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] 類型的任何屬性,請輸入 [{“PropertyType”: “Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]”}] (JSON 資料表格式)、 [“Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]”] (JSON 陣列格式) 或 'Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (CSV 格式)。

名稱
Name string

輸入 PowerShell 參數的名稱。 這必須符合 PowerShell 變數命名格式 (,亦即建議避免使用空格或特殊符號)。 PowerShell 變數名稱不區分大小寫。 例如:MyVariable 會導致建立變數$MyVariable。

字串值
StringValue string

要指派給輸入 PowerShell 參數的字串值。 或者,如果您輸入布林值或數值,請使用其他值輸入。

整數值
IntValue integer

要指派給輸入 PowerShell 參數的整數 (整數) 值。 或者,如果您要輸入字串、布林值或數值,請使用其他值輸入。

布林值
BooleanValue boolean

要指派給輸入 PowerShell 參數的布林值 (true 或 false)。 或者,如果您要輸入字串或數值,請使用其他值輸入。

十進位值
DecimalValue double

要指派給輸入 PowerShell 參數的十進位值。 或者,如果您輸入字串、布林值或整數值,請使用其他值輸入。

物件值
ObjectValue object

要指派給輸入 PowerShell 參數的物件值。 這將成為 PowerShell 腳本中的 JSON 序列化字串變數,因此請使用 ConvertFrom-Json 還原序列化為物件。 或者,如果您要輸入字串、布林值或數值,請使用其他值輸入。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
PowerShell 輸出 JSON
PowerShellJSONOutput string

PowerShell 指令碼的輸出,格式為 JSON。

執行緒識別碼
ThreadId integer

如果 PowerShell 指令碼以代理程式執行緒身分執行,則此輸出會保留代理程式執行緒識別碼,可用來監視 PowerShell 指令碼執行,並在指令碼完成時擷取 PowerShell 指令碼結果。

執行 Azure AD PowerShell 指令碼

在執行 IA-Connect 代理程式的工作階段中的 Azure Active Directory (也稱為 Microsoft Entra ID、Azure AD 或 AAD) 執行空間中執行 PowerShell 腳本,其中腳本內容會作為命令的一部分傳遞至 IA-Connect 代理程式。 這是執行您自己的自訂 Azure AD PowerShell 腳本的建議動作。 此動作也可用來擷取先前執行 PowerShell 指令碼的結果,並以代理程式執行緒的形式執行。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組。

參數

名稱 機碼 必要 類型 Description
PowerShell 腳本內容
PowerShellScriptContents string

要在 Azure AD v2 執行空間中執行的 PowerShell 腳本內容。 IA-Connect 將透過直接傳遞到 PowerShell 自動化引擎來執行此腳本 as-is。 實際上不會在磁碟上建立任何 PowerShell 腳本。 或者,您可以在磁碟上執行現有的 PowerShell 腳本,方法是輸入下列內容:return &; 'scriptpath'。 例如:return & 'c:\scripts\AzureADTestScript.ps1'。

沒有結果是錯誤嗎
IsNoResultAnError boolean

如果 PowerShell 命令未傳回任何資料,這是否表示錯誤?

傳回複式類型
ReturnComplexTypes boolean

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 輸入 'Properties to return as collection'、'Properties names to serialize' 和 'Property types to serialize' 可讓您指定應該傳回哪些「複雜」屬性,以及用來格式化資料的方法 (根據屬性,挑選最有效的一個)。 此輸入可讓您指定應該對任何剩餘屬性執行的動作 (即「複雜」且未明確命名的屬性)。 如果設定為 true,IA-Connect 將嘗試使用 ToString() 傳回資料的字串表示法。 如果設定為 false (預設值),則 IA-Connect 不會傳回屬性。

將布林值傳回為布林值
ReturnBooleanAsBoolean boolean

布林屬性是否應該作為布林值返回? 如果為 false,則會以字串的形式傳回。

傳回數值為十進位
ReturnNumericAsDecimal boolean

Numeric 屬性應該以 Numerics 的形式傳回嗎? 如果為 false,則會以字串的形式傳回。

將返回日期作為日期
ReturnDateAsDate boolean

Date 屬性應該以 Dates 的形式傳回嗎? 如果為 false,則會以字串的形式傳回。

要傳回為集合的屬性
PropertiesToReturnAsCollectionJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依名稱) IA-Connect 應該嘗試以集合的形式傳回。 視屬性、其類型和值而定,您也應該考慮使用替代輸入「要序列化的屬性名稱」和「要序列化的屬性類型」(選擇一個)。 此輸入可以 JSON 或 CSV 格式輸入。 例如:若要傳回 EmailAddresses 和 MemberOf 陣列屬性,請輸入 [{“PropertyName”: “EmailAddresses”}、{“PropertyName”: “MemberOf”}] (JSON 資料表格式)、 [“EmailAddresses”、“MemberOf”] (JSON 陣列格式) 或 EmailAddresses,MemberOf (CSV 格式)。

以執行緒身分執行指令碼
RunScriptAsThread boolean

如果設定為 false (預設值),IA-Connect 代理程式會立即執行 PowerShell 腳本,並在腳本完成時將結果傳回給 Director。 如果執行長或複雜的 PowerShell 腳本,此動作可能會逾時。如果設定為 true,IA-Connect 代理程式會以代理程式執行緒的 PowerShell 指令碼執行,而 IA-Connect 導向器 (或 Orchestrator、PowerShell 模組、Blue Prism) 可以監控此代理程式執行緒的狀態,並等待其完成。 這允許長或複雜的 PowerShell 腳本在沒有逾時的情況下運行。 IA-Connect 代理程式 9.3 和更早版本無法將 PowerShell 指令碼作為代理程式執行緒執行。

擷取執行緒識別碼的輸出資料
RetrieveOutputDataFromThreadId integer

如果您先前以代理程式執行緒身分執行 PowerShell 腳本,並將 [等候執行緒的秒數] 設定為 0,請提供代理程式執行緒識別碼以擷取結果。 此代理程式執行緒識別碼將由先前呼叫此動作提供。 如果您只是執行 PowerShell 指令碼,請設定為 0 (預設值) (,因此不會擷取先前以代理程式執行緒執行的 PowerShell 指令碼的結果)。

等待執行緒的秒數
SecondsToWaitForThread integer

如果「以執行緒身分執行指令碼」設定為 true,則要等待代理程式執行緒完成的秒數。 如果執行 PowerShell 腳本的代理程式執行緒在此時間內尚未完成,則會引發例外狀況。 設定為 0 以略過等候:代理程式會繼續執行 PowerShell 腳本,但也可用於下一個動作。 然後,您可以使用動作 [等候代理程式執行程成功完成] 來等候代理程式執行緒完成,然後重新執行此 [執行 PowerShell 腳本] 動作,並將輸入 [擷取執行緒識別碼的輸出資料] 設定為代理程式執行緒識別碼。

指令碼包含儲存的密碼
ScriptContainsStoredPassword boolean

如果指令碼包含格式為 {IAConnectPassword:StoredPasswordIdentifier} 的 IA-Connect 儲存密碼識別碼,或格式為 {OrchestratorCredential:FriendlyName} 的 IA-Connect Orchestrator 一般認證,則設定為 true。 { } 片語將被指定的密碼替換,轉義並放在單引號中(除非它已經在腳本中放在引號中)。

記錄詳細輸出
LogVerboseOutput boolean

設定為 true,可將任何 PowerShell 詳細輸出記錄到 IA-Connect 記錄中。 這對於偵錯很有用。 若要在腳本中詳細記錄,請使用下列 PowerShell:Write-Verbose 'My message' -Verbose。

要序列化的屬性名稱
PropertyNamesToSerializeJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依名稱) IA-Connect 應序列化為 JSON,因此它們會傳回為字串類型 (您可以在收到後還原序列化)。 根據屬性、其類型和值,您還應該考慮使用替代輸入 '要傳回為集合的屬性' 和 '要序列化的屬性類型' (選擇一個)。 例如:若要序列化 EmailAddresses 和 MemberOf 屬性,請輸入 [{“PropertyName”: “EmailAddresses”}、{“PropertyName”: “MemberOf”}] (JSON 資料表格式)、 [“EmailAddresses”、“MemberOf”] (JSON 陣列格式) 或 EmailAddresses,MemberOf (CSV 格式)。

要序列化的內容類型
PropertyTypesToSerializeJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依類型) IA-Connect 應序列化為 JSON,因此它們會傳回為字串類型 (收到後可以還原序列化)。 根據屬性、其類型和值,您也應該考慮使用替代輸入「要傳回為集合的屬性」和「要序列化的屬性名稱」(選擇一個)。 此輸入是具有單一 'PropertyType' 欄位的集合。 例如:若要序列化 Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] 類型的任何屬性,請輸入 [{“PropertyType”: “Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]”}] (JSON 資料表格式)、 [“Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]”] (JSON 陣列格式) 或 'Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (CSV 格式)。

名稱
Name string

輸入 PowerShell 參數的名稱。 這必須符合 PowerShell 變數命名格式 (,亦即建議避免使用空格或特殊符號)。 PowerShell 變數名稱不區分大小寫。 例如:MyVariable 會導致建立變數$MyVariable。

字串值
StringValue string

要指派給輸入 PowerShell 參數的字串值。 或者,如果您輸入布林值或數值,請使用其他值輸入。

整數值
IntValue integer

要指派給輸入 PowerShell 參數的整數 (整數) 值。 或者,如果您要輸入字串、布林值或數值,請使用其他值輸入。

布林值
BooleanValue boolean

要指派給輸入 PowerShell 參數的布林值 (true 或 false)。 或者,如果您要輸入字串或數值,請使用其他值輸入。

十進位值
DecimalValue double

要指派給輸入 PowerShell 參數的十進位值。 或者,如果您輸入字串、布林值或整數值,請使用其他值輸入。

物件值
ObjectValue object

要指派給輸入 PowerShell 參數的物件值。 這將成為 PowerShell 腳本中的 JSON 序列化字串變數,因此請使用 ConvertFrom-Json 還原序列化為物件。 或者,如果您要輸入字串、布林值或數值,請使用其他值輸入。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
PowerShell 輸出 JSON
PowerShellJSONOutput string

PowerShell 指令碼的輸出,格式為 JSON。

執行緒識別碼
ThreadId integer

如果 PowerShell 指令碼以代理程式執行緒身分執行,則此輸出會保留代理程式執行緒識別碼,可用來監視 PowerShell 指令碼執行,並在指令碼完成時擷取 PowerShell 指令碼結果。

執行 Exchange PowerShell 腳本

在執行 IA-Connect 代理程式之工作階段的 Exchange 執行空間中執行 PowerShell 腳本,其中腳本內容會作為命令的一部分傳遞至 IA-Connect 代理程式。 這是執行您自己的自訂 Exchange PowerShell 程式碼的建議動作。 此動作也可用來擷取先前執行 PowerShell 指令碼的結果,並以代理程式執行緒的形式執行。

參數

名稱 機碼 必要 類型 Description
PowerShell 腳本內容
PowerShellScriptContents string

要在 Exchange 執行空間中執行的 PowerShell 腳本內容。 IA-Connect 將透過直接傳遞到 PowerShell 自動化引擎來執行此腳本 as-is。 實際上不會在磁碟上建立任何 PowerShell 腳本。 或者,您可以在磁碟上執行現有的 PowerShell 腳本,方法是輸入下列內容:return &; 'scriptpath'。 例如:return & 'c:\scripts\ExchangeTestScript.ps1'。

沒有結果是錯誤嗎
IsNoResultAnError boolean

如果 PowerShell 命令未傳回任何資料,這是否表示錯誤?

傳回複式類型
ReturnComplexTypes boolean

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 輸入 'Properties to return as collection'、'Properties names to serialize' 和 'Property types to serialize' 可讓您指定應該傳回哪些「複雜」屬性,以及用來格式化資料的方法 (根據屬性,挑選最有效的一個)。 此輸入可讓您指定應該對任何剩餘屬性執行的動作 (即「複雜」且未明確命名的屬性)。 如果設定為 true,IA-Connect 將嘗試使用 ToString() 傳回資料的字串表示法。 如果設定為 false (預設值),則 IA-Connect 不會傳回屬性。

將布林值傳回為布林值
ReturnBooleanAsBoolean boolean

布林屬性是否應該作為布林值返回? 如果為 false,則會以字串的形式傳回。

傳回數值為十進位
ReturnNumericAsDecimal boolean

Numeric 屬性應該以 Numerics 的形式傳回嗎? 如果為 false,則會以字串的形式傳回。

將返回日期作為日期
ReturnDateAsDate boolean

Date 屬性應該以 Dates 的形式傳回嗎? 如果為 false,則會以字串的形式傳回。

要傳回為集合的屬性
PropertiesToReturnAsCollectionJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依名稱) IA-Connect 應該嘗試以集合的形式傳回。 視屬性、其類型和值而定,您也應該考慮使用替代輸入「要序列化的屬性名稱」和「要序列化的屬性類型」(選擇一個)。 此輸入可以 JSON 或 CSV 格式輸入。 例如:若要傳回 EmailAddresses 和 MemberOf 陣列屬性,請輸入 [{“PropertyName”: “EmailAddresses”}、{“PropertyName”: “MemberOf”}] (JSON 資料表格式)、 [“EmailAddresses”、“MemberOf”] (JSON 陣列格式) 或 EmailAddresses,MemberOf (CSV 格式)。

以執行緒身分執行指令碼
RunScriptAsThread boolean

如果設定為 false (預設值),IA-Connect 代理程式會立即執行 PowerShell 腳本,並在腳本完成時將結果傳回給 Director。 如果執行長或複雜的 PowerShell 腳本,此動作可能會逾時。如果設定為 true,IA-Connect 代理程式會以代理程式執行緒的 PowerShell 指令碼執行,而 IA-Connect 導向器 (或 Orchestrator、PowerShell 模組、Blue Prism) 可以監控此代理程式執行緒的狀態,並等待其完成。 這允許長或複雜的 PowerShell 腳本在沒有逾時的情況下運行。 IA-Connect 代理程式 9.3 和更早版本無法將 PowerShell 指令碼作為代理程式執行緒執行。

擷取執行緒識別碼的輸出資料
RetrieveOutputDataFromThreadId integer

如果您先前以代理程式執行緒身分執行 PowerShell 腳本,並將 [等候執行緒的秒數] 設定為 0,請提供代理程式執行緒識別碼以擷取結果。 此代理程式執行緒識別碼將由先前呼叫此動作提供。 如果您只是執行 PowerShell 指令碼,請設定為 0 (預設值) (,因此不會擷取先前以代理程式執行緒執行的 PowerShell 指令碼的結果)。

等待執行緒的秒數
SecondsToWaitForThread integer

如果「以執行緒身分執行指令碼」設定為 true,則要等待代理程式執行緒完成的秒數。 如果執行 PowerShell 腳本的代理程式執行緒在此時間內尚未完成,則會引發例外狀況。 設定為 0 以略過等候:代理程式會繼續執行 PowerShell 腳本,但也可用於下一個動作。 然後,您可以使用動作 [等候代理程式執行程成功完成] 來等候代理程式執行緒完成,然後重新執行此 [執行 PowerShell 腳本] 動作,並將輸入 [擷取執行緒識別碼的輸出資料] 設定為代理程式執行緒識別碼。

指令碼包含儲存的密碼
ScriptContainsStoredPassword boolean

如果指令碼包含格式為 {IAConnectPassword:StoredPasswordIdentifier} 的 IA-Connect 儲存密碼識別碼,或格式為 {OrchestratorCredential:FriendlyName} 的 IA-Connect Orchestrator 一般認證,則設定為 true。 { } 片語將被指定的密碼替換,轉義並放在單引號中(除非它已經在腳本中放在引號中)。

記錄詳細輸出
LogVerboseOutput boolean

設定為 true,可將任何 PowerShell 詳細輸出記錄到 IA-Connect 記錄中。 這對於偵錯很有用。 若要在腳本中詳細記錄,請使用下列 PowerShell:Write-Verbose 'My message' -Verbose。

要序列化的屬性名稱
PropertyNamesToSerializeJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依名稱) IA-Connect 應序列化為 JSON,因此它們會傳回為字串類型 (您可以在收到後還原序列化)。 根據屬性、其類型和值,您還應該考慮使用替代輸入 '要傳回為集合的屬性' 和 '要序列化的屬性類型' (選擇一個)。 例如:若要序列化 EmailAddresses 和 MemberOf 屬性,請輸入 [{“PropertyName”: “EmailAddresses”}、{“PropertyName”: “MemberOf”}] (JSON 資料表格式)、 [“EmailAddresses”、“MemberOf”] (JSON 陣列格式) 或 EmailAddresses,MemberOf (CSV 格式)。

要序列化的內容類型
PropertyTypesToSerializeJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依類型) IA-Connect 應序列化為 JSON,因此它們會傳回為字串類型 (收到後可以還原序列化)。 根據屬性、其類型和值,您也應該考慮使用替代輸入「要傳回為集合的屬性」和「要序列化的屬性名稱」(選擇一個)。 此輸入是具有單一 'PropertyType' 欄位的集合。 例如:若要序列化 Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] 類型的任何屬性,請輸入 [{“PropertyType”: “Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]”}] (JSON 資料表格式)、 [“Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]”] (JSON 陣列格式) 或 'Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (CSV 格式)。

名稱
Name string

輸入 PowerShell 參數的名稱。 這必須符合 PowerShell 變數命名格式 (,亦即建議避免使用空格或特殊符號)。 PowerShell 變數名稱不區分大小寫。 例如:MyVariable 會導致建立變數$MyVariable。

字串值
StringValue string

要指派給輸入 PowerShell 參數的字串值。 或者,如果您輸入布林值或數值,請使用其他值輸入。

整數值
IntValue integer

要指派給輸入 PowerShell 參數的整數 (整數) 值。 或者,如果您要輸入字串、布林值或數值,請使用其他值輸入。

布林值
BooleanValue boolean

要指派給輸入 PowerShell 參數的布林值 (true 或 false)。 或者,如果您要輸入字串或數值,請使用其他值輸入。

十進位值
DecimalValue double

要指派給輸入 PowerShell 參數的十進位值。 或者,如果您輸入字串、布林值或整數值,請使用其他值輸入。

物件值
ObjectValue object

要指派給輸入 PowerShell 參數的物件值。 這將成為 PowerShell 腳本中的 JSON 序列化字串變數,因此請使用 ConvertFrom-Json 還原序列化為物件。 或者,如果您要輸入字串、布林值或數值,請使用其他值輸入。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
PowerShell 輸出 JSON
PowerShellJSONOutput string

PowerShell 指令碼的輸出,格式為 JSON。

執行緒識別碼
ThreadId integer

如果 PowerShell 指令碼以代理程式執行緒身分執行,則此輸出會保留代理程式執行緒識別碼,可用來監視 PowerShell 指令碼執行,並在指令碼完成時擷取 PowerShell 指令碼結果。

執行 Office 365 PowerShell 腳本

在執行 IA-Connect 代理程式的工作階段的 Office 365 執行空間中執行 PowerShell 指令碼,其中指令碼內容會作為命令的一部分傳遞至 IA-Connect 代理程式。 這是執行您自己的自訂 Office 365 Exchange Online PowerShell 程式碼的建議動作。 此動作也可用來擷取先前執行 PowerShell 指令碼的結果,並以代理程式執行緒的形式執行。

參數

名稱 機碼 必要 類型 Description
PowerShell 腳本內容
PowerShellScriptContents string

要在 Office 365 執行空間中執行的 PowerShell 腳本內容。 IA-Connect 將透過直接傳遞到 PowerShell 自動化引擎來執行此腳本 as-is。 實際上不會在磁碟上建立任何 PowerShell 腳本。 或者,您可以在磁碟上執行現有的 PowerShell 腳本,方法是輸入下列內容:return &; 'scriptpath'。 例如:return & 'c:\scripts\O365TestScript.ps1'。

沒有結果是錯誤嗎
IsNoResultAnError boolean

如果 PowerShell 命令未傳回任何資料,這是否表示錯誤?

傳回複式類型
ReturnComplexTypes boolean

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 輸入 'Properties to return as collection'、'Properties names to serialize' 和 'Property types to serialize' 可讓您指定應該傳回哪些「複雜」屬性,以及用來格式化資料的方法 (根據屬性,挑選最有效的一個)。 此輸入可讓您指定應該對任何剩餘屬性執行的動作 (即「複雜」且未明確命名的屬性)。 如果設定為 true,IA-Connect 將嘗試使用 ToString() 傳回資料的字串表示法。 如果設定為 false (預設值),則 IA-Connect 不會傳回屬性。

將布林值傳回為布林值
ReturnBooleanAsBoolean boolean

布林屬性是否應該作為布林值返回? 如果為 false,則會以字串的形式傳回。

傳回數值為十進位
ReturnNumericAsDecimal boolean

Numeric 屬性應該以 Numerics 的形式傳回嗎? 如果為 false,則會以字串的形式傳回。

將返回日期作為日期
ReturnDateAsDate boolean

Date 屬性應該以 Dates 的形式傳回嗎? 如果為 false,則會以字串的形式傳回。

要傳回為集合的屬性
PropertiesToReturnAsCollectionJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依名稱) IA-Connect 應該嘗試以集合的形式傳回。 視屬性、其類型和值而定,您也應該考慮使用替代輸入「要序列化的屬性名稱」和「要序列化的屬性類型」(選擇一個)。 此輸入可以 JSON 或 CSV 格式輸入。 例如:若要傳回 EmailAddresses 和 MemberOf 陣列屬性,請輸入 [{“PropertyName”: “EmailAddresses”}、{“PropertyName”: “MemberOf”}] (JSON 資料表格式)、 [“EmailAddresses”、“MemberOf”] (JSON 陣列格式) 或 EmailAddresses,MemberOf (CSV 格式)。

PowerShell 本機範圍
LocalScope boolean

基礎 Office 365 PowerShell 命令是否應該在本機範圍內執行。 根據預設,此不會設定,因此 PowerShell 會回復為預設值。

以執行緒身分執行指令碼
RunScriptAsThread boolean

如果設定為 false (預設值),IA-Connect 代理程式會立即執行 PowerShell 腳本,並在腳本完成時將結果傳回給 Director。 如果執行長或複雜的 PowerShell 腳本,此動作可能會逾時。如果設定為 true,IA-Connect 代理程式會以代理程式執行緒的 PowerShell 指令碼執行,而 IA-Connect 導向器 (或 Orchestrator、PowerShell 模組、Blue Prism) 可以監控此代理程式執行緒的狀態,並等待其完成。 這允許長或複雜的 PowerShell 腳本在沒有逾時的情況下運行。 IA-Connect 代理程式 9.3 和更早版本無法將 PowerShell 指令碼作為代理程式執行緒執行。

擷取執行緒識別碼的輸出資料
RetrieveOutputDataFromThreadId integer

如果您先前以代理程式執行緒身分執行 PowerShell 腳本,並將 [等候執行緒的秒數] 設定為 0,請提供代理程式執行緒識別碼以擷取結果。 此代理程式執行緒識別碼將由先前呼叫此動作提供。 如果您只是執行 PowerShell 指令碼,請設定為 0 (預設值) (,因此不會擷取先前以代理程式執行緒執行的 PowerShell 指令碼的結果)。

等待執行緒的秒數
SecondsToWaitForThread integer

如果「以執行緒身分執行指令碼」設定為 true,則要等待代理程式執行緒完成的秒數。 如果執行 PowerShell 腳本的代理程式執行緒在此時間內尚未完成,則會引發例外狀況。 設定為 0 以略過等候:代理程式會繼續執行 PowerShell 腳本,但也可用於下一個動作。 然後,您可以使用動作 [等候代理程式執行程成功完成] 來等候代理程式執行緒完成,然後重新執行此 [執行 PowerShell 腳本] 動作,並將輸入 [擷取執行緒識別碼的輸出資料] 設定為代理程式執行緒識別碼。

指令碼包含儲存的密碼
ScriptContainsStoredPassword boolean

如果指令碼包含格式為 {IAConnectPassword:StoredPasswordIdentifier} 的 IA-Connect 儲存密碼識別碼,或格式為 {OrchestratorCredential:FriendlyName} 的 IA-Connect Orchestrator 一般認證,則設定為 true。 { } 片語將被指定的密碼替換,轉義並放在單引號中(除非它已經在腳本中放在引號中)。

記錄詳細輸出
LogVerboseOutput boolean

設定為 true,可將任何 PowerShell 詳細輸出記錄到 IA-Connect 記錄中。 這對於偵錯很有用。 若要在腳本中詳細記錄,請使用下列 PowerShell:Write-Verbose 'My message' -Verbose。

要序列化的屬性名稱
PropertyNamesToSerializeJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依名稱) IA-Connect 應序列化為 JSON,因此它們會傳回為字串類型 (您可以在收到後還原序列化)。 根據屬性、其類型和值,您還應該考慮使用替代輸入 '要傳回為集合的屬性' 和 '要序列化的屬性類型' (選擇一個)。 例如:若要序列化 EmailAddresses 和 MemberOf 屬性,請輸入 [{“PropertyName”: “EmailAddresses”}、{“PropertyName”: “MemberOf”}] (JSON 資料表格式)、 [“EmailAddresses”、“MemberOf”] (JSON 陣列格式) 或 EmailAddresses,MemberOf (CSV 格式)。

要序列化的內容類型
PropertyTypesToSerializeJSON string

如果 PowerShell 傳回資料包含「複雜」屬性 (例如,值、陣列、資料表或類別的集合) ,則預設不會在 IA-Connect PowerShell 回應中傳回這些屬性。 此選項可讓您指定哪些「複雜」屬性 (依類型) IA-Connect 應序列化為 JSON,因此它們會傳回為字串類型 (收到後可以還原序列化)。 根據屬性、其類型和值,您也應該考慮使用替代輸入「要傳回為集合的屬性」和「要序列化的屬性名稱」(選擇一個)。 此輸入是具有單一 'PropertyType' 欄位的集合。 例如:若要序列化 Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] 類型的任何屬性,請輸入 [{“PropertyType”: “Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]”}] (JSON 資料表格式)、 [“Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]”] (JSON 陣列格式) 或 'Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (CSV 格式)。

名稱
Name string

輸入 PowerShell 參數的名稱。 這必須符合 PowerShell 變數命名格式 (,亦即建議避免使用空格或特殊符號)。 PowerShell 變數名稱不區分大小寫。 例如:MyVariable 會導致建立變數$MyVariable。

字串值
StringValue string

要指派給輸入 PowerShell 參數的字串值。 或者,如果您輸入布林值或數值,請使用其他值輸入。

整數值
IntValue integer

要指派給輸入 PowerShell 參數的整數 (整數) 值。 或者,如果您要輸入字串、布林值或數值,請使用其他值輸入。

布林值
BooleanValue boolean

要指派給輸入 PowerShell 參數的布林值 (true 或 false)。 或者,如果您要輸入字串或數值,請使用其他值輸入。

十進位值
DecimalValue double

要指派給輸入 PowerShell 參數的十進位值。 或者,如果您輸入字串、布林值或整數值,請使用其他值輸入。

物件值
ObjectValue object

要指派給輸入 PowerShell 參數的物件值。 這將成為 PowerShell 腳本中的 JSON 序列化字串變數,因此請使用 ConvertFrom-Json 還原序列化為物件。 或者,如果您要輸入字串、布林值或數值,請使用其他值輸入。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
PowerShell 輸出 JSON
PowerShellJSONOutput string

PowerShell 指令碼的輸出,格式為 JSON。

執行緒識別碼
ThreadId integer

如果 PowerShell 指令碼以代理程式執行緒身分執行,則此輸出會保留代理程式執行緒識別碼,可用來監視 PowerShell 指令碼執行,並在指令碼完成時擷取 PowerShell 指令碼結果。

將 Active Directory 使用者移至 OU

將 Active Directory 使用者移至現有的 Active Directory 組織單位 (OU)。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity True string

Active Directory 使用者的身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

目標路徑
TargetPath True string

目標組織單位 (OU) 的路徑,採用辨別名稱格式 (例如 OU=Target OU、OU=London、DC=mydomain、DC=local)、GUID 格式或路徑 (例如 MyUsers\London)。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectoryMoveADUserToOUByIdentityResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

將 Active Directory 物件新增至多個群組

將 Active Directory 物件 (通常是使用者、群組或電腦) 新增至多個現有的 Active Directory 群組。 IA-Connect 將物件新增至盡可能多的群組,並報告結果。 如果物件已經是一或多個指定群組的成員,則會算作成功。

參數

名稱 機碼 必要 類型 Description
物件身分識別
UserIdentity True string

要新增至一或多個群組的物件 (通常是使用者、群組或電腦)。 您可以依識別名稱 (例如 CN=User1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'User1') 來指定使用者或群組。 您可以依識別名稱或電腦名稱 (2K 之前) 後面接著 $ (例如 VM01$) 來指定電腦。

要新增的 AD 群組
GroupNamesJSON string

要新增物件的 AD 群組清單,採用 JSON 或 CSV 格式。 例如:[{“GroupName”: “Group 1”}、{“GroupName”: “Group 2”}] (JSON 表格格式)、 [“Group 1”、“Group 2”] (JSON 陣列格式) 或 Group 1,Group 2 (CSV 格式)。 您可以依識別名稱 (例如 CN=Group1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'Group1') 來指定群組。 您不能使用顯示名稱或群組名稱(儘管群組名稱通常與可以使用的 2K 之前名稱相同)。

如果任何群組無法新增,則會發生例外狀況
ExceptionIfAnyGroupsFailToAdd boolean

如果設定為 true:如果任何單一群組無法新增 (即需要 100% 成功) ,則會引發例外狀況 (失敗) 。 如果未引發例外狀況,此動作會報告成功新增的群組數目,以及新增失敗的群組數目。

如果所有群組都無法新增
ExceptionIfAllGroupsFailToAdd boolean

如果設定為 true:只有在所有群組都無法新增 (即沒有成功且部分失敗) 時,才會引發例外狀況 (失敗) 。 如果未引發例外狀況,此動作會報告成功新增的群組數目,以及新增失敗的群組數目。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

每次通話的組數上限
MaxGroupsPerCall integer

如果指定大量 AD 群組進行新增,可能會導致逾時。 透過將「每個通話的群組數目上限」值設定為 1 或更高,IA-Connect Orchestrator 會將此動作分割成多個呼叫,以達到每個通話指定的群組數目上限,對 IA-Connect Director 和客服人員進行呼叫。 首次在 IA-Connect 9.3 中推出。 例如:如果您設定值為 5,且要求新增 14 個群組,則 Orchestrator 會將其分割為 5、5、4 個要求。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
AD組已成功添加
ADGroupsAddedSuccessfully integer

成功新增物件的 AD 群組數目。

AD 群組無法新增
ADGroupsFailedToAdd integer

物件無法新增的 AD 群組數目。

新增 AD 群組錯誤訊息
AddADGroupsMasterErrorMessage string

如果物件無法新增至某些 AD 群組,且未引發例外狀況,則此錯誤訊息會提供問題的詳細資料。

將 Azure AD 使用者指派給多個系統管理員角色

將 Azure Active Directory 使用者 (或其他物件) 指派給一或多個現有的 Azure Active Directory 系統管理員角色。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
UserObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

角色物件識別碼或顯示名稱
RolesJSON string

要指派給使用者的管理員角色清單,採用 JSON 或 CSV 格式。 例如:[{“Role”: “Application Developer”}、{“Role”: “Exchange Administrator”}] (JSON 表格格式)、 [“Application Developer”, “Exchange Administrator”] (JSON 陣列格式) 或 Application Developer,Exchange Administrator (CSV 格式)。 您可以依顯示名稱 (例如「應用程式開發人員」) 或 ObjectId (例如 UUID/GUID 值) 來指定 AAD 系統管理員角色。

如果任何角色無法指派,則為例外狀況
ExceptionIfAnyRolesFailToAssign boolean

如果設定為 true:如果任何單一 Azure AD 系統管理員角色無法指派 (亦即需要 100% 成功) ,則會引發例外狀況 (失敗) 。 如果未引發例外狀況,此動作會報告成功指派的 Azure AD 系統管理員角色數目,以及指派失敗的數目。

如果所有角色都無法指派,則會出現例外狀況
ExceptionIfAllRolesFailToAssign boolean

如果設定為 true:只有在所有 Azure AD 系統管理員角色都無法指派 (亦即沒有成功和某些失敗) 時,才會引發例外狀況 (失敗)。 如果未引發例外狀況,此動作會報告成功指派的 Azure AD 系統管理員角色數目,以及指派失敗的數目。

目錄範圍識別碼
DirectoryScopeId string

所指派之所有角色的目錄範圍識別碼。 例如:/ 代表整個租用戶,/GUID 代表應用程式註冊,/administrativeUnits/GUID 代表系統管理單位。

先檢查使用者角色成員資格
CheckUserRoleMembershipsFirst boolean

如果設定為 true (預設值),IA-Connect 會在嘗試將使用者指派給角色之前檢查使用者的角色指派。 如果使用者已指派給角色,IA-Connect 只會報告成功,而不需要執行任何動作。 如果設定為 false,IA-Connect 會立即將使用者指派給角色而不進行檢查,如果使用者已指派給角色,則會導致錯誤。

檢查角色識別碼是否存在
CheckRoleIdsExist boolean

如果設定為 true (預設值),且一或多個角色以物件識別碼格式提供,IA-Connect 會仔細檢查這些角色識別碼是否有效。 建議這樣做,因為當您提供無效的物件識別碼時,從 Azure AD 收到的錯誤訊息沒有幫助。 如果設定為 false,IA-Connect 將不會仔細檢查任何提供的角色標識碼的有效性,這會更快。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已成功指派 Azure AD 角色
AzureADRolesAssignedSuccessfully integer

成功指派的 Azure AD 角色數目。

Azure AD 角色無法指派
AzureADRolesFailedToAssign integer

指派失敗的 Azure AD 角色數目。

指派 Azure AD 角色錯誤訊息
AssignAzureADRolesMasterErrorMessage string

如果某些角色無法指派,且未引發例外狀況,則此錯誤訊息會提供問題的詳細資料。

將 Azure AD 使用者指派給系統管理員角色

將 Azure Active Directory 使用者 (或其他物件) 指派給現有的 Azure Active Directory 系統管理員角色。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
UserObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

角色物件識別碼或顯示名稱
RoleObjectId True string

Azure Active Directory 系統管理員角色的識別碼或顯示名稱。 您可以依顯示名稱 (例如「應用程式開發人員」) 或 ObjectId (例如 UUID/GUID 值) 來指定 AAD 系統管理員角色。

目錄範圍識別碼
DirectoryScopeId string

角色指派的目錄範圍識別碼。 例如:/ 代表整個租用戶,/GUID 代表應用程式註冊,/administrativeUnits/GUID 代表系統管理單位。

先檢查使用者角色成員資格
CheckUserRoleMembershipsFirst boolean

如果設定為 true (預設值),IA-Connect 會在嘗試將使用者指派給角色之前檢查使用者的角色指派。 如果使用者已指派給角色,IA-Connect 只會報告成功,而不需要執行任何動作。 如果設定為 false,IA-Connect 會立即將使用者指派給角色而不進行檢查,如果使用者已指派給角色,則會導致錯誤。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
AzureADv2AssignUserToRoleResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

將 Azure AD 使用者新增至多個群組

將 Azure Active Directory 使用者新增至多個現有的 Azure Active Directory 群組,其中群組是由物件識別碼或顯示名稱所指定。 IA-Connect 將使用者新增至盡可能多的群組,並報告結果。 此動作無法修改通訊群組清單或已啟用郵件的安全性群組 - 請改用 Office 365 Exchange Online 動作。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
UserObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

要新增的 Azure AD 群組
GroupNamesJSON string

要新增使用者的 Azure AD 群組識別碼或顯示名稱清單,採用 JSON 或 CSV 格式。 例如:[{“GroupName”: “Group 1”}、{“GroupName”: “Group 2”}] (JSON 表格格式)、 [“Group 1”、“Group 2”] (JSON 陣列格式) 或 Group 1,Group 2 (CSV 格式)。

如果任何群組無法新增,則會發生例外狀況
ExceptionIfAnyGroupsFailToAdd boolean

如果設定為 true:如果任何單一群組無法新增 (即需要 100% 成功) ,則會引發例外狀況 (失敗) 。 某些群組 (例如:Office 365 群組) 可能不會新增,因此例外狀況可能很常見。 如果未引發例外狀況,此動作會報告成功新增的群組數目,以及新增失敗的群組數目。

如果所有群組都無法新增
ExceptionIfAllGroupsFailToAdd boolean

如果設定為 true:只有在所有群組都無法新增 (即沒有成功且部分失敗) 時,才會引發例外狀況 (失敗) 。 如果未引發例外狀況,此動作會報告成功新增的群組數目,以及新增失敗的群組數目。

先檢查使用者群組成員資格
CheckUserGroupMembershipsFirst boolean

如果設定為 true,IA-Connect 會在嘗試將使用者新增至群組之前檢查使用者的群組成員資格。 如果使用者已經是群組的成員,IA-Connect 只會報告成功,而不需要執行任何動作。 如果設定為 false,IA-Connect 會立即將使用者新增至群組而不進行檢查,如果使用者已經在群組中,則會導致錯誤。

每個呼叫的 Azure AD 群組上限
MaxAzureADGroupsPerCall integer

如果指定大量 Azure AD 群組進行新增,可能會導致逾時。 透過將「每個呼叫的 Azure AD 群組數目上限」值設定為 1 或更高,IA-Connect Orchestrator 會將此動作分割成對 IA-Connect Director 和代理程式的多個呼叫,每個呼叫的群組數目上限。 例如:如果您設定值為 5 且需要移除 14 個群組,Orchestrator 會將其分割為 5、5、4 個要求。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已成功新增 Azure AD 群組
AzureADGroupsAddedSuccessfully integer

使用者成功新增至的 Azure AD 群組數目。

Azure AD 群組無法新增
AzureADGroupsFailedToAdd integer

使用者無法新增至的 Azure AD 群組數目。

新增 Azure AD 群組主要錯誤訊息
AddAzureADGroupsMasterErrorMessage string

如果使用者無法新增至某些 Azure AD 群組,且未引發例外狀況,則此錯誤訊息會提供問題的詳細資料。

將 Azure AD 使用者新增至群組

將 Azure Active Directory 使用者新增至現有的 Azure Active Directory 安全性或 M365 群組。 此動作無法修改通訊群組清單或已啟用郵件的安全性群組 - 請改用 Office 365 Exchange Online 動作。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
UserObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

群組物件識別碼或顯示名稱
GroupObjectId True string

Azure Active Directory 群組的識別碼或顯示名稱。 您可以依顯示名稱 (例如「財務使用者」) 或 ObjectId (例如 UUID/GUID 值) 指定群組。

先檢查使用者群組成員資格
CheckUserGroupMembershipsFirst boolean

如果設定為 true,IA-Connect 會在嘗試將使用者新增至群組之前檢查使用者的群組成員資格。 如果使用者已經是群組的成員,IA-Connect 只會報告成功,而不需要執行任何動作。 如果設定為 false,IA-Connect 會立即將使用者新增至群組而不進行檢查,如果使用者已經在群組中,則會導致錯誤。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
AzureADv2AddUserToGroupResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

將 Exchange 設定為檢視整個 Active Directory 樹系

指定在執行 Exchange 動作時,是否搜尋/檢視整個 Active Directory 樹系 (包括子網域)。 如果您有多個連結的網域,則可能需要使用此動作。

參數

名稱 機碼 必要 類型 Description
查看整個森林
ViewEntireForest True boolean

如果您想要搜尋整個 Active Directory 樹系,請設定為 true,如果您只想搜尋目前的 Active Directory 網域,請設定為 false。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ExchangeSetADServerToViewEntireForestResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

將 Microsoft Exchange 信箱權限新增至使用者

將信箱許可權指派給指定的信箱使用者、使用者或安全性群組。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange 信箱的身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

User
User True string

要新增至信箱權限的使用者。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定使用者。

存取權限
AccessRights True string

要指派給使用者信箱權限的存取權限。 可用選項包括 'ChangeOwner'、'ChangePermission'、'DeleteItem'、'ExternalAccount'、'FullAccess' 和 'ReadPermission'。 若要指派多個權限,請將它們指定為逗號分隔的清單。

自動映射
AutoMapping boolean

如果設定為 true,信箱和使用者帳戶將會設定一些其他屬性,這些屬性會導致 Outlook 在以此使用者身分登入時自動開啟信箱。 這可能需要幾分鐘才能生效。 如果設定為 false,則不會設定其他屬性,而且 Outlook 不會自動開啟信箱。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ExchangeAddMailboxPermissionResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

將 Microsoft Exchange 成員新增至通訊群組

將成員 (例如使用者) 新增至 Exchange 通訊群組。 如果成員已在群組中,則不會採取任何動作。

參數

名稱 機碼 必要 類型 Description
通訊群組身分識別
Identity True string

要新增的通訊群組身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=MyGroup、OU=My Groups、DC=mydomain、DC=local)、電子郵件地址或 GUID 來指定通訊群組。

要新增的成員
Member True string

要新增至通訊群組的成員身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ExchangeAddDistributionGroupMemberResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

將 Office 365 信箱權限新增至使用者

將 Microsoft Exchange Online 或 Office 365 信箱許可權指派給指定的信箱使用者、使用者或安全性群組。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange Online 或 Office 365 信箱的識別碼。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

User
User True string

信箱使用者、使用者或已啟用郵件的安全性群組,以接收信箱許可權。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

存取權限
AccessRights True string

要指派給使用者信箱權限的存取權限。 可用選項包括 'ChangeOwner'、'ChangePermission'、'DeleteItem'、'ExternalAccount'、'FullAccess' 和 'ReadPermission'。 若要指派多個權限,請將它們指定為逗號分隔的清單。

自動映射
AutoMapping boolean

如果設定為 true,信箱和使用者帳戶將會設定一些其他屬性,這些屬性會導致 Outlook 在以此使用者身分登入時自動開啟信箱。 這可能需要幾分鐘才能生效。 如果設定為 false,則不會設定其他屬性,而且 Outlook 不會自動開啟信箱。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
O365AddMailboxPermissionResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

將 Office 365 成員新增至通訊群組

將成員新增至 Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組。

參數

名稱 機碼 必要 類型 Description
通訊群組身分識別
Identity True string

要新增至的通訊群組或已啟用郵件的安全性群組身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=MyGroup、OU=My Groups、DC=mydomain、DC=local)、電子郵件地址或 GUID 來指定通訊群組。

要新增的成員
Member True string

要新增至通訊群組或已啟用郵件的安全性群組的成員身分識別。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

略過安全性群組管理員檢查
BypassSecurityGroupManagerCheck boolean

如果 IA-Connect 代理程式自動化帳戶不是通訊群組或已啟用郵件的安全性群組的擁有者,則無法移除群組。 如果您將此選項設定為 true,則會略過擁有者檢查,但它需要自動化帳戶位於 Exchange「組織管理」角色群組中,或指派「角色管理」角色 - 這是單一角色,可讓您修改任何 Office 355 Exchange Online 群組,而不是成為您需要修改之所有群組的擁有者。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
O365AddDistributionGroupMemberResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

已連線到 Azure AD

報告 IA-Connect 是否連線到 Azure Active Directory (也稱為 Microsoft Entra ID、Azure AD 或 AAD)。 使用其中一個 [連線到 Azure AD] 動作來連線。

參數

名稱 機碼 必要 類型 Description
擷取 PowerShell 執行空間進程識別碼
RetrievePowerShellRunSpacePID boolean

如果設定為 true:IA-Connect 代理程式會擷取裝載 PowerShell 執行空間之進程進程識別碼的相關資訊。 這項資訊會在輸出 'PowerShell 執行空間進程識別碼' 和 '代理程式裝載 PowerShell 執行空間' 中提供。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
Azure AD PowerShell 執行空間已開啟
AzureADv2RunspaceOpen boolean

如果 IA-Connect 連線到 Azure AD,則設定為 true。 這可能會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組。

Azure AD API
AzureADAPI string

所使用的 Azure AD API 名稱。 如果使用 Azure AD v2 PowerShell 模組,則會設定為 'AzureADv2',如果使用 Microsoft Graph 使用者 PowerShell 模組,則會設定為 'MSGraphUsersPS'。

PowerShell 執行空間進程識別碼
PowerShellRunspacePID integer

PowerShell 執行空間進程識別碼 (PID)。 如果 IA-Connect 代理程式裝載 PowerShell 執行空間,此值將會是 IA-Connect 代理程式的 PID。 如果 PowerShell 執行空間已隔離,則此值會是隔離程式的 PID。

代理程式是否裝載 PowerShell 執行空間
IsAgentHostingPowerShellRunSpace boolean

如果 IA-Connect Agent 裝載 PowerShell 執行空間 (,也就是 'PowerShell 執行空間進程識別碼' 是代理程式 PID) ,則傳回 true。

已連線至 Active Directory

報告 IA-Connect 是否連線到 Active Directory。 根據預設,IA-Connect 會使用執行 IA-Connect Agent 的帳戶,自動連線到執行 IA-Connect Agent 的電腦所屬的網域。 使用「使用認證連線到 Active Directory」動作,使用替代認證或連線到替代網域。

參數

名稱 機碼 必要 類型 Description
Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
連線到 Active Directory
ActiveDirectoryRunspaceOpen boolean

如果 IA-Connect 連線到 Active Directory,則設定為 true。 這應該一律傳回 true,因為 IA-Connect 會自動連線到執行代理程式的電腦所屬的網域。

本地直通連接
ActiveDirectoryLocalPassthroughRunspace boolean

如果 IA-Connect 連線到執行 IA-Connect Agent 的電腦所屬的網域,則使用 IA-Connect Agent 執行的帳戶,則設定為 true。

Active Directory 伺服器
ActiveDirectoryServer string

連線的 Active Directory 伺服器。 如果空白,則 IA-Connect 根據 AD 站台設定,對執行代理程式的電腦使用預設的 Active Directory 網域控制站。

Active Directory DNS 網域
ActiveDirectoryDNSDomain string

IA-Connect 所連線之網域的 Active Directory DNS 網域。 如果空白,則 IA-Connect 使用執行代理程式的電腦的預設 Active Directory 網域。 例如:mydomain.local。

Active Directory 網域 DN
ActiveDirectoryDomainDN string

連線至之網域 IA-Connect 的 Active Directory 網域 DN。 如果空白,則 IA-Connect 使用執行代理程式的電腦的預設 Active Directory 網域。 例如:DC=mydomain,DC=local。

已驗證的使用者名稱
AuthenticatedUsername string

IA-Connect 用於連線至 Active Directory 的已驗證使用者名稱。 如果空白,表示 IA-Connect 正在使用 IA-Connect Agent 執行時所用的帳戶。

已連線至 Microsoft Exchange

報告 IA-Connect 是否連線到Microsoft Exchange 伺服器。 使用動作 [連線到 Microsoft Exchange] 進行連線。

參數

名稱 機碼 必要 類型 Description
測試通訊
TestCommunications boolean

如果設定為 false:IA-Connect 不會發出測試命令來確認 Exchange 伺服器連線正常運作,而且會依賴上次已知的狀態。 如果設定為 true (預設值) :IA-Connect 會發出測試命令,以確認 Exchange 伺服器連線正常運作。

擷取 PowerShell 執行空間進程識別碼
RetrievePowerShellRunSpacePID boolean

如果設定為 true:IA-Connect 代理程式會擷取裝載 PowerShell 執行空間之進程進程識別碼的相關資訊。 這項資訊會在輸出 'PowerShell 執行空間進程識別碼' 和 '代理程式裝載 PowerShell 執行空間' 中提供。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已連線至 Microsoft Exchange
ExchangeRunspaceOpen boolean

如果 IA-Connect 已連線到 Microsoft Exchange,則設定為 true。

交易所連接方式
ExchangeConnectionMethod string

保留目前的 Exchange 連線方法:本機或遠端。

PowerShell 執行空間進程識別碼
PowerShellRunspacePID integer

PowerShell 執行空間進程識別碼 (PID)。 如果 IA-Connect 代理程式裝載 PowerShell 執行空間,此值將會是 IA-Connect 代理程式的 PID。 如果 PowerShell 執行空間已隔離,則此值會是隔離程式的 PID。

代理程式是否裝載 PowerShell 執行空間
IsAgentHostingPowerShellRunSpace boolean

如果 IA-Connect Agent 裝載 PowerShell 執行空間 (,也就是 'PowerShell 執行空間進程識別碼' 是代理程式 PID) ,則傳回 true。

已連線至 Office 365

報告 IA-Connect 是否使用 Office 365 PowerShell 模組連線到 Office 365。 使用動作 [連線到 Office 365] 進行連線。

參數

名稱 機碼 必要 類型 Description
測試通訊
TestCommunications boolean

如果設定為 false:IA-Connect 不會發出測試命令來確認 Office 365 Exchange Online 連線正常運作,而且會依賴上次已知的狀態。 如果設定為 true (預設值):IA-Connect 會發出測試命令,以確認 Office 365 Exchange Online 連線正常運作。

擷取 PowerShell 執行空間進程識別碼
RetrievePowerShellRunSpacePID boolean

如果設定為 true:IA-Connect 代理程式會擷取裝載 PowerShell 執行空間之進程進程識別碼的相關資訊。 這項資訊會在輸出 'PowerShell 執行空間進程識別碼' 和 '代理程式裝載 PowerShell 執行空間' 中提供。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已連線至 Office 365
O365RunspaceOpen boolean

如果 IA-Connect 使用 Office 365 PowerShell 模組連線到 Office 365,則設定為 true。

Office 365 連線方式
Office365ConnectionMethod string

保留目前的 Office 365 連線方法:EXOV1 或 EXOV2。

PowerShell 執行空間進程識別碼
PowerShellRunspacePID integer

PowerShell 執行空間進程識別碼 (PID)。 如果 IA-Connect 代理程式裝載 PowerShell 執行空間,此值將會是 IA-Connect 代理程式的 PID。 如果 PowerShell 執行空間已隔離,則此值會是隔離程式的 PID。

代理程式是否裝載 PowerShell 執行空間
IsAgentHostingPowerShellRunSpace boolean

如果 IA-Connect Agent 裝載 PowerShell 執行空間 (,也就是 'PowerShell 執行空間進程識別碼' 是代理程式 PID) ,則傳回 true。

建立 Microsoft Exchange Online 信箱和使用者帳戶

在內部部署 Active Directory 中建立已啟用郵件的使用者,並在 Microsoft Exchange Online 或 Office 365 中建立相關聯的遠端信箱。 只有在使用者不存在於內部部署 Active Directory 中時,才使用此動作。 如果使用者已存在,請使用動作 '為使用者建立 Microsoft Exchange Online 信箱]。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。

參數

名稱 機碼 必要 類型 Description
名字
FirstName string

使用者的名字。

姓氏
LastName string

使用者的姓氏。

組織單位
OnPremisesOrganizationalUnit string

組織單位 (OU) ,以識別名稱格式 (例如 OU=Target OU、OU=London、DC=mydomain、DC=local)、GUID 格式或路徑 (例如 MyUsers\London) 儲存使用者。 如果將其保留空白,則會在「使用者」OU 中建立使用者。

名稱
Name True string

Active Directory 使用者的名稱。 這會顯示在 AD 使用者和電腦的「名稱」欄中,以及使用者「一般」標籤的頂端。這不是使用者登入名稱。

顯示名稱
DisplayName string

選擇性使用者顯示名稱。

遠端路由位址
RemoteRoutingAddress string

設定此選項可覆寫與此使用者相關聯的 Microsoft Exchange Online 或 Office 365 中信箱的 SMTP 位址。 如果您將此欄位保留空白 (預設值),則會根據內部部署與 Microsoft Exchange Online 之間的目錄同步處理自動計算遠端路由位址。

Alias
Alias string

使用者的 Exchange 別名 (也稱為郵件暱稱)。 如果已啟用電子郵件地址原則,則會用來產生主要SMTP電子郵件地址的名稱元件(例如)。 alias@mydomain.com 如果未啟用電子郵件地址原則,您可能希望改為設定主要 SMTP 位址。

主要 SMTP 位址
PrimarySmtpAddress string

用於收件者的主要回信電子郵件地址。 如果啟用「電子郵件地址原則」,您不太可能設定此設定,因此請改用「別名」(原則會從別名建立主要 SMTP 位址),或停用電子郵件地址原則。

使用者主體名稱
UserPrincipalName True string

Active Directory 中的使用者登入名稱。 這通常應該採用 'name@domainFQDN' 格式(例如 'TestUser1@domain.local')。 使用者可以使用以下格式登入:name@domainFQDN。

SAM 帳戶名稱
SamAccountName string

Active Directory 中的使用者登入名稱 (Windows 2000 之前)。 其格式為 'name' (例如 'TestUser1')。 使用者可以使用以下格式登入:DOMAIN\name。

帳戶密碼
Password password

使用者密碼。 必須指定此值,並符合 Active Directory 密碼複雜度規則。 如果這是「儲存」密碼,請輸入 {IAConnectPassword:StoredPasswordIdentifier} 格式,並將「儲存密碼」輸入設定為 true。 如果這是 Orchestrator 一般認證,請輸入 {OrchestratorCredential:FriendlyName} 格式,並將「儲存的密碼」輸入設定為 true。

帳號密碼為儲存密碼
AccountPasswordIsStoredPassword boolean

如果密碼是 IA-Connect 儲存的密碼識別碼 (例如:由「產生密碼」動作產生) 或 IA-Connect Orchestrator 一般認證 (例如:如果將 IA-Connect 與 PA 流程搭配使用),則設定為 true。

用戶必須在下次登入時變更密碼
ResetPasswordOnNextLogon boolean

如果您想要強制使用者在登入時變更密碼,請設定為 true (也就是說,此處設定的新密碼是讓使用者登入的一次性密碼)。 如果這是使用者將使用的密碼,則設定為 false,直到他們手動變更為止。

是共用信箱
SharedMailbox boolean

如果正在建立的信箱應該是共用信箱,請設定為 true。

已啟用電子郵件地址原則
EmailAddressPolicyEnabled boolean

如果您想要根據套用至此收件者的電子郵件地址原則自動更新電子郵件地址,請設定為 true。 如果啟用電子郵件地址原則,這通常會影響您設定主要 SMTP 位址的能力。 設定為 false 可停用該功能,讓您完全控制手動設定電子郵件地址。 如果您不想設定此選項,請保留空白(即保留現有值或預設值)。

建立封存信箱
Archive boolean

如果您想要在 Microsoft Exchange Online 或 Office 365 中額外建立封存信箱,請設定為 true。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
動作結果JSON
PowerShellJSONOutput string

新遠端信箱動作的輸出,採用 JSON 格式。

新信箱 DN
NewMailboxDN string

新建立信箱的識別名稱 (DN)。 這是信箱的唯一識別碼,可用於此信箱的進一步動作。

新的信箱 GUID
NewMailboxGUID string

新建立信箱的 GUID。 這是信箱的唯一識別碼,可用於此信箱的進一步動作。

建立 Microsoft Exchange 信箱和使用者帳戶

在內部部署 Active Directory 中建立已啟用郵件的使用者,並在 Microsoft Exchange 中建立相關聯的信箱。 只有在使用者不存在於內部部署 Active Directory 中時,才使用此動作。 如果使用者已存在,請使用動作「為使用者建立 Microsoft Exchange 信箱」。

參數

名稱 機碼 必要 類型 Description
名字
FirstName string

使用者的名字。

姓氏
LastName string

使用者的姓氏。

組織單位
OrganizationalUnit string

組織單位 (OU) ,以識別名稱格式 (例如 OU=Target OU、OU=London、DC=mydomain、DC=local)、GUID 格式或路徑 (例如 MyUsers\London) 儲存使用者。 如果將其保留空白,則會在「使用者」OU 中建立使用者。

名稱
Name True string

Active Directory 使用者的名稱。 這會顯示在 AD 使用者和電腦的「名稱」欄中,以及使用者「一般」標籤的頂端。這不是使用者登入名稱。

顯示名稱
DisplayName string

選擇性使用者顯示名稱。

Alias
Alias string

使用者的 Exchange 別名 (也稱為郵件暱稱)。 如果已啟用電子郵件地址原則,則會用來產生主要SMTP電子郵件地址的名稱元件(例如)。 alias@mydomain.com 如果未啟用電子郵件地址原則,您可能希望改為設定主要 SMTP 位址。

主要 SMTP 位址
PrimarySmtpAddress string

用於收件者的主要回信電子郵件地址。 如果啟用「電子郵件地址原則」,您不太可能設定此設定,因此請改用「別名」(原則會從別名建立主要 SMTP 位址),或停用電子郵件地址原則。

使用者主體名稱
UserPrincipalName True string

Active Directory 中的使用者登入名稱。 這通常應該採用 'name@domainFQDN' 格式(例如 'TestUser1@domain.local')。 使用者可以使用以下格式登入:name@domainFQDN。

SAM 帳戶名稱
SamAccountName string

Active Directory 中的使用者登入名稱 (Windows 2000 之前)。 其格式為 'name' (例如 'TestUser1')。 使用者可以使用以下格式登入:DOMAIN\name。

帳戶密碼
Password password

使用者密碼。 必須指定此值,並符合 Active Directory 密碼複雜度規則。 如果這是「儲存」密碼,請輸入 {IAConnectPassword:StoredPasswordIdentifier} 格式,並將「儲存密碼」輸入設定為 true。 如果這是 Orchestrator 一般認證,請輸入 {OrchestratorCredential:FriendlyName} 格式,並將「儲存的密碼」輸入設定為 true。

帳號密碼為儲存密碼
AccountPasswordIsStoredPassword boolean

如果密碼是 IA-Connect 儲存的密碼識別碼 (例如:由「產生密碼」動作產生) 或 IA-Connect Orchestrator 一般認證 (例如:如果將 IA-Connect 與 PA 流程搭配使用),則設定為 true。

用戶必須在下次登入時變更密碼
ResetPasswordOnNextLogon boolean

如果您想要強制使用者在登入時變更密碼,請設定為 true (也就是說,此處設定的新密碼是讓使用者登入的一次性密碼)。 如果這是使用者將使用的密碼,則設定為 false,直到他們手動變更為止。

資料庫
Database string

要包含新資料庫的 Exchange 資料庫。 您可以依辨別名稱、GUID 或名稱來指定資料庫。

是共用信箱
SharedMailbox boolean

如果正在建立的信箱應該是共用信箱,請設定為 true。

已啟用電子郵件地址原則
EmailAddressPolicyEnabled boolean

如果您想要根據套用至此收件者的電子郵件地址原則自動更新電子郵件地址,請設定為 true。 如果啟用電子郵件地址原則,這通常會影響您設定主要 SMTP 位址的能力。 設定為 false 可停用該功能,讓您完全控制手動設定電子郵件地址。 如果您不想設定此選項,請保留空白(即保留現有值或預設值)。

建立封存信箱
Archive boolean

如果您想要在 Microsoft Exchange Online 或 Office 365 中額外建立封存信箱,請設定為 true。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
動作結果JSON
PowerShellJSONOutput string

新信箱動作的輸出,以 JSON 格式。

新信箱 DN
NewMailboxDN string

新建立信箱的識別名稱 (DN)。 這是信箱的唯一識別碼,可用於此信箱的進一步動作。

新的信箱 GUID
NewMailboxGUID string

新建立信箱的 GUID。 這是信箱的唯一識別碼,可用於此信箱的進一步動作。

建立 Office 365 信箱和使用者帳戶

在 Microsoft Exchange Online 中建立信箱,並在 Azure Active Directory/Entra ID 中建立使用者帳戶。 只有在使用者尚未存在於 Azure Active Directory/Entra ID 中時,才使用此動作。 如果使用者已存在,請改為將適當的授權指派給使用者帳戶。

參數

名稱 機碼 必要 類型 Description
Microsoft Online 服務識別碼
MicrosoftOnlineServicesID True string

使用者的唯一識別碼。這通常採用 'name@xxx.onmicrosoft.com' 格式。

名稱
Name True string

信箱的唯一名稱。 這是外部不可見的內部值。 建議您將其設定為與其 Microsoft Online Services 識別碼的名稱元件相同的值 (例如 'user1') ,除非您有替代程式,或有充分的理由使用不同的值。

名字
FirstName string

使用者的名字。

姓氏
LastName string

使用者的姓氏。

首字母
Initials string

使用者的中間字母縮寫。

顯示名稱
DisplayName string

選擇性使用者顯示名稱。

Alias
Alias string

使用者的信箱別名 (也稱為郵件暱稱)。 此值將用來產生使用者SMTP電子郵件地址的名稱元件(例如,別名「alias」 alias@mydomain.com會導致)。 如果這與主要 SMTP 位址不同,則會導致使用者擁有多個 SMTP 位址。 如果未提供此值,則不會設定任何使用者別名,而且使用者只會有主要 SMTP 位址。

主要 SMTP 位址
PrimarySmtpAddress string

用於收件者的主要傳回 SMTP 電子郵件地址。 如果這與使用者別名不同,則會導致使用者擁有多個 SMTP 位址。 如果未提供此值,則會根據組織原則自動計算主要 SMTP 位址 (通常以 Office 365 系統管理中心中設定的預設網域為基礎) 。

帳戶密碼
Password password

使用者密碼。 必須指定此值,並符合 Azure Active Directory 密碼複雜度規則。 如果這是「儲存」密碼,請輸入 {IAConnectPassword:StoredPasswordIdentifier} 格式,並將「儲存密碼」輸入設定為 true。 如果這是 Orchestrator 一般認證,請輸入 {OrchestratorCredential:FriendlyName} 格式,並將「儲存的密碼」輸入設定為 true。

帳號密碼為儲存密碼
AccountPasswordIsStoredPassword boolean

如果密碼是 IA-Connect 儲存的密碼識別碼 (例如:由「產生密碼」動作產生) 或 IA-Connect Orchestrator 一般認證 (例如:如果將 IA-Connect 與 PA 流程搭配使用),則設定為 true。

用戶必須在下次登入時變更密碼
ResetPasswordOnNextLogon boolean

如果您想要強制使用者在登入時變更密碼,請設定為 true (也就是說,此處設定的新密碼是讓使用者登入的一次性密碼)。 如果這是使用者將使用的密碼,則設定為 false,直到他們手動變更為止。

建立封存信箱
Archive boolean

如果您想要在 Microsoft Exchange Online 或 Office 365 中額外建立封存信箱,請設定為 true。

信箱方案
MailboxPlan string

要套用至信箱的選擇性信箱計劃。 信箱方案會指定信箱可用的許可權和功能。 您可以在 IA-Connect Inspector 的 'Office 365' PowerShell 執行空間中執行腳本 'Get-MailboxPlan' 來查看可用的信箱計劃。

信箱區域
MailboxRegion string

在多地理位置環境中建立信箱的選擇性地理區域。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
動作結果JSON
PowerShellJSONOutput string

新信箱動作的輸出,以 JSON 格式。

新使用者 Microsoft Online Services 識別碼
NewUserMicrosoftOnlineServicesID string

新建立使用者帳戶的 Microsoft Online services 識別碼。 這是使用者的唯一識別碼,可用於進一步的動作。

新的信箱 GUID
NewMailboxGUID string

新建立信箱的 GUID。 這是信箱的唯一識別碼,可用於進一步的動作。

新的信箱主要 SMTP 位址
NewMailboxPrimarySmtpAddress string

新建立信箱的主要 SMTP 位址。

建立 Office 365 共用信箱和使用者帳戶

在 Microsoft Exchange Online 中建立共用信箱,並在 Azure Active Directory/Entra ID 中建立使用者帳戶。 只有在使用者尚未存在於 Azure Active Directory/Entra ID 中時,才使用此動作。 共用信箱 SMTP 位址將以名稱、別名或主要 SMTP 位址為基礎 (取決於提供的輸入)。

參數

名稱 機碼 必要 類型 Description
名稱
Name True string

信箱的唯一名稱。 這是內部值,不會在外部顯示 (除非您未設定別名或主要 SMTP 位址,在此情況下,它會用作信箱 SMTP 電子郵件地址的名稱元件)。 建議您將它設為與別名相同的值,除非您有替代程序,或有充分的理由使用不同的值。

名字
FirstName string

信箱使用者的名字。

姓氏
LastName string

信箱使用者的姓氏。

首字母
Initials string

信箱使用者的中間縮寫。

顯示名稱
DisplayName string

選擇性信箱顯示名稱。

Alias
Alias string

使用者的信箱別名 (也稱為郵件暱稱)。 此值將用來產生信箱SMTP電子郵件地址的名稱元件(例如,別名'alias' alias@mydomain.com會導致)。 如果這與主要 SMTP 位址不同,則會導致信箱具有多個 SMTP 位址。 如果未提供此值,則不會設定信箱別名,而且信箱只會有主要 SMTP 位址。

主要 SMTP 位址
PrimarySmtpAddress string

用於收件者的主要傳回 SMTP 電子郵件地址。 如果這與信箱別名不同,則會導致信箱具有多個 SMTP 位址。 如果未提供此值,則會根據別名或名稱和組織原則 (通常以 Office 365 系統管理中心中設定的預設網域) 自動計算主要 SMTP 位址。

建立封存信箱
Archive boolean

如果您想要在 Microsoft Exchange Online 或 Office 365 中額外建立封存信箱,請設定為 true。

信箱區域
MailboxRegion string

在多地理位置環境中建立信箱的選擇性地理區域。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
動作結果JSON
PowerShellJSONOutput string

新信箱動作的輸出,以 JSON 格式。

新使用者 Microsoft Online Services 識別碼
NewUserMicrosoftOnlineServicesID string

新建立信箱使用者帳戶的 Microsoft Online services 識別碼。 這是信箱的唯一識別碼,可用於進一步的動作。

新的信箱 GUID
NewMailboxGUID string

新建立信箱的 GUID。 這是信箱的唯一識別碼,可用於進一步的動作。

新的信箱主要 SMTP 位址
NewMailboxPrimarySmtpAddress string

新建立信箱的主要 SMTP 位址。

建立新的 Azure AD Microsoft 365 群組

建立新的 Azure Active Directory Microsoft 365 群組。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
顯示名稱
DisplayName True string

群組的顯示名稱。

Description
Description string

群組說明。

郵件暱稱
MailNickname string

電子郵件暱稱,用來形成群組電子郵件地址。

群組可見度
GroupVisibility string

如果設為公開 (預設值),任何人都可以檢視群組的內容,而且任何人都可以加入群組。 如果設為私人,則只有成員可以檢視群組的內容,且只有擁有者可以將新成員新增至群組或核准加入要求。

檢查群組是否存在
CheckGroupExists boolean

如果設定為 true,IA-Connect 會檢查群組是否存在,如果確實存在,IA-Connect 只會報告該群組的成功,而不需要執行任何動作。 如果設定為 false,IA-Connect 將建立群組而不進行檢查,這可能會導致群組名稱重複。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
動作結果JSON
PowerShellJSONOutput string

建立通訊群組動作的輸出,採用 JSON 格式。 這通常會保存所建立群組的詳細資料。

群組已存在
GroupAlreadyExists boolean

如果群組已存在,則會設定為 true,以通知您群組存在,因此 IA-Connect 不需要執行任何動作。

已建立的群組物件識別碼
CreatedGroupObjectId string

已建立群組 (或現有群組) 的物件識別碼。

建立新的 Azure AD 安全性群組

建立新的 Azure Active Directory 安全性群組。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
顯示名稱
DisplayName True string

群組的顯示名稱。

Description
Description string

群組說明。

檢查群組是否存在
CheckGroupExists boolean

如果設定為 true,IA-Connect 會檢查群組是否存在,如果確實存在,IA-Connect 只會報告該群組的成功,而不需要執行任何動作。 如果設定為 false,IA-Connect 將建立群組而不進行檢查,這可能會導致群組名稱重複。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
動作結果JSON
PowerShellJSONOutput string

建立通訊群組動作的輸出,採用 JSON 格式。 這通常會保存所建立群組的詳細資料。

群組已存在
GroupAlreadyExists boolean

如果群組已存在,則會設定為 true,以通知您群組存在,因此 IA-Connect 不需要執行任何動作。

已建立的群組物件識別碼
CreatedGroupObjectId string

已建立群組 (或現有群組) 的物件識別碼。

建立新的 Microsoft Exchange 通訊群組

建立新的 Microsoft Exchange 通訊群組或已啟用郵件的安全性群組。

參數

名稱 機碼 必要 類型 Description
群組名稱
Name True string

新群組的唯一名稱。

Alias
Alias string

新群組的別名 (也稱為郵件暱稱)。 如果您未指定 SMTP 位址,則會使用別名來產生電子郵件地址的名稱元件 (例如 alias@mydomain.com)。

顯示名稱
DisplayName string

群組的顯示名稱。 這在地址列表中可見。

註釋
Notes string

有關物件的選用附註。

管理單位
ManagedBy string

群組的擁有者。 如果您未指定擁有者,則建立群組的使用者將成為擁有者。 擁有者可以是信箱、郵件使用者或已啟用郵件的安全性群組。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

Members
Members string

要新增至新群組的成員清單以逗號分隔。 您可以依名稱、別名、識別名稱 (例如 CN=MyGroup、OU=My Groups、DC=mydomain、DC=local)、電子郵件地址或 GUID 來指定成員。

組織單位
OrganizationalUnit string

Active Directory 中要儲存群組的組織單位 (OU)。 您可以以識別名稱格式 (例如 OU=Target OU、OU=London、DC=mydomain、DC=local)、GUID 格式或路徑 (例如 MyGroups\London) 指定 OU。 如果將其保留空白,則會在「使用者」OU 中建立群組。

主要 SMTP 位址
PrimarySmtpAddress string

用於新群組的主要回傳電子郵件地址。

會員離境限制
MemberDepartRestriction string

可讓您指定成員離開通訊群組的限制。 「開啟」是預設設定,允許成員在未經批准的情況下離開群組,「關閉」限制成員離開群組。 對於安全性群組,會忽略此選項,因為使用者無法從安全性群組中移除自己。

成員加入限制
MemberJoinRestriction string

可讓您指定成員在建立通訊群組之後加入通訊群組的限制。 「開啟」允許成員在未經核准的情況下加入群組,「關閉」(預設值)限制成員加入群組,「ApprovalRequired」允許成員請求加入群組,如果群組擁有者接受要求,則會新增成員。 對於安全群組,會忽略此選項,因為使用者無法將自己新增至安全群組。

需要寄件者驗證
RequireSenderAuthenticationEnabled boolean

設定為 true 以指定群組只會接受來自已驗證 (內部) 寄件者的訊息。 設定為 false 以接受來自所有寄件者的郵件。

群組類型
Type string

指定要建立的群組類型。 'Distribution' 是預設值,並建立通訊群組。 '安全性' 用於建立已啟用郵件的安全性群組。

如果群組已存在,則例外狀況
ErrorIfGroupAlreadyExists boolean

如果群組已經存在,是否應該發生例外狀況? 設定為 false,如果群組已經存在(例如,它已經建立),則什麼都不做。 如果已存在的群組是錯誤 (亦即預期不存在) ,則設為 true。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
動作結果JSON
PowerShellJSONOutput string

建立通訊群組動作的輸出,採用 JSON 格式。 這通常會保存所建立群組的詳細資料。

群組已存在
GroupAlreadyExists boolean

如果群組已存在 (且「群組已存在則例外狀況」設定為 false),則會設定為 true,以通知您群組實際上並未建立,因為它已經存在。

新組DN
NewGroupDN string

新建立群組的識別名稱 (DN)。 這是群組的唯一識別碼,可用於對此群組的進一步操作。

新的群組 GUID
NewGroupGUID string

新建立 (已啟用) 群組的 GUID。 這是群組的唯一識別碼,可用於對此群組的進一步操作。

建立新的 Office 365 通訊群組

建立新的 Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組。

參數

名稱 機碼 必要 類型 Description
群組名稱
Name True string

新群組的唯一名稱。

Alias
Alias string

新群組的別名 (也稱為郵件暱稱)。 如果您未指定 SMTP 位址,則會使用別名來產生電子郵件地址的名稱元件 (例如 alias@mydomain.com)。

顯示名稱
DisplayName string

群組的顯示名稱。 這在地址列表中可見。

註釋
Notes string

有關物件的選用附註。

管理單位
ManagedBy string

群組的擁有者。 如果您未指定擁有者,則建立群組的使用者將成為擁有者。 擁有者可以是信箱、郵件使用者或已啟用郵件的安全性群組。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

Members
Members string

要新增至新群組的成員清單以逗號分隔。 您可以依名稱、別名、識別名稱 (例如 CN=MyGroup、OU=My Groups、DC=mydomain、DC=local)、電子郵件地址或 GUID 來指定成員。

組織單位
OrganizationalUnit string

Azure Active Directory 中要儲存群組的組織單位 (OU)。 您可以以識別名稱格式 (例如 OU=Target OU、OU=London、DC=mydomain、DC=local) 或 GUID 格式指定 OU。

主要 SMTP 位址
PrimarySmtpAddress string

用於新群組的主要回傳電子郵件地址。

會員離境限制
MemberDepartRestriction string

可讓您指定成員離開群組的限制。 「開啟」是預設設定,允許成員在未經批准的情況下離開群組,「關閉」限制成員離開群組。

成員加入限制
MemberJoinRestriction string

可讓您指定成員在建立群組後加入群組的限制。 「開啟」允許成員在未經核准的情況下加入群組,「關閉」(預設值)限制成員加入群組,「ApprovalRequired」允許成員請求加入群組,如果群組擁有者接受要求,則會新增成員。

需要寄件者驗證
RequireSenderAuthenticationEnabled boolean

設定為 true 以指定群組只會接受來自已驗證 (內部) 寄件者的訊息。 設定為 false 以接受來自所有寄件者的郵件。

群組類型
Type string

指定要建立的群組類型。 'Distribution' 是預設值,並建立通訊群組。 '安全性' 用於建立已啟用郵件的安全性群組。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
動作結果JSON
PowerShellJSONOutput string

建立通訊群組動作的輸出,採用 JSON 格式。 這通常會保存所建立群組的詳細資料。

群組已存在
GroupAlreadyExists boolean

如果群組已存在,則會設定為 true,以通知您群組實際上並未建立。

已建立群組DN
CreatedGroupDN string

已建立群組 (或現有群組) 的識別名稱 (DN)。

已建立群組 GUID
CreatedGroupGUID string

已建立群組 (或現有群組) 的 GUID。

已建立的群組身分識別
CreatedGroupIdentity string

已建立群組 (或現有群組) 的身分識別。

從DN獲取Active Directory域FQDN

效用函數。 給定 Active Directory 使用者的識別名稱 (DN),傳回包含使用者的 Active Directory 網域。

參數

名稱 機碼 必要 類型 Description
使用者 DN
DN True string

搜尋使用者的識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
網域 FQDN
DomainFQDN string

包含使用者的 Active Directory 網域。

從使用者 DN 取得 Active Directory OU

效用函數。 給定 Active Directory 使用者的辨別名稱 (DN),會傳回使用者所在的組織單位 (OU)。

參數

名稱 機碼 必要 類型 Description
使用者 DN
UserDN True string

搜尋使用者的識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
使用者 OU
UserOU string

使用者所在的組織單位 (OU)。

從多個系統管理員角色中移除 Azure AD 使用者

從一或多個現有的 Azure Active Directory 系統管理員角色中移除 Azure Active Directory 使用者 (或其他物件)。 此動作會逐一查看使用者的角色指派清單,並移除相符的項目,因此如果您指定要移除的不存在角色,則不會觸發錯誤 (因為如果使用者不在該角色中,則不會嘗試任何動作)。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
UserObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

角色物件識別碼或顯示名稱
RolesJSON string

要指派給使用者的管理員角色清單,採用 JSON 或 CSV 格式。 例如:[{“Role”: “Application Developer”}、{“Role”: “Exchange Administrator”}] (JSON 表格格式)、 [“Application Developer”, “Exchange Administrator”] (JSON 陣列格式) 或 Application Developer,Exchange Administrator (CSV 格式)。 您可以依顯示名稱 (例如「應用程式開發人員」) 或 ObjectId (例如 UUID/GUID 值) 來指定 AAD 系統管理員角色。

目錄範圍識別碼
DirectoryScopeId string

選擇性目錄範圍識別碼,指定要移除的角色指派必須相符。 例如:/ 代表整個租用戶 (,而且只會產生目錄範圍標識碼為 / 的具名角色指派,/GUID 代表應用程式註冊,/administrativeUnits/GUID 代表系統管理單位。 如果您想要移除具名角色指派,而不論目錄範圍為何,請指定 * 或空白值。

如果任何角色無法移除,則會發生例外狀況
ExceptionIfAnyRolesFailToRemove boolean

如果設定為 true:如果任何單一 Azure AD 系統管理員角色無法移除 (亦即需要 100% 成功) ,則會引發例外狀況 (失敗) 。 如果未引發例外狀況,此動作會報告成功移除的 Azure AD 系統管理員角色數目,以及移除失敗的數目。

如果所有角色都無法移除,則為例外狀況
ExceptionIfAllRolesFailToRemove boolean

如果設定為 true:只有在所有 Azure AD 系統管理員角色都無法移除 (亦即沒有成功且部分失敗) 時,才會引發例外狀況 (失敗) 。 如果未引發例外狀況,此動作會報告成功移除的 Azure AD 系統管理員角色數目,以及移除失敗的數目。

如果角色不存在,則例外狀況
ExceptionIfRoleDoesNotExist boolean

如果設為 true:如果指定要移除的其中一個角色不存在,則會引發異常狀況 (失敗)。 如果設定為 false (預設值):如果指定要移除的角色不存在,則會忽略該角色,因為無法將使用者指派給該角色。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已成功移除 Azure AD 角色
AzureADRolesRemovedSuccessfully integer

已移除的 Azure AD 角色數目。 這只會計算實際移除的角色 (使用者不屬於的角色不計算在內)。

Azure AD 角色無法移除
AzureADRolesFailedToRemove integer

無法移除的 Azure AD 角色數目。

移除 Azure AD 角色錯誤訊息
RemoveAzureADRolesMasterErrorMessage string

如果某些角色無法移除,且未引發例外狀況,則此錯誤訊息會提供問題的詳細資料。

從多個群組中移除 Active Directory 物件

從多個現有的 Active Directory 群組中移除 Active Directory 物件 (通常是使用者、群組或電腦)。 IA-Connect 會從盡可能多的群組中移除物件,並報告結果。 如果物件不是一或多個指定群組的成員,則會算作成功。

參數

名稱 機碼 必要 類型 Description
物件身分識別
UserIdentity True string

要從一或多個群組中移除的物件 (通常是使用者、群組或電腦)。 您可以依識別名稱 (例如 CN=User1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'User1') 來指定使用者或群組。 您可以依識別名稱或電腦名稱 (2K 之前) 後面接著 $ (例如 VM01$) 來指定電腦。

要移除的 AD 群組
GroupNamesJSON string

要從中移除物件的 AD 群組清單,採用 JSON 或 CSV 格式。 例如:[{“GroupName”: “Group 1”}、{“GroupName”: “Group 2”}] (JSON 表格格式)、 [“Group 1”、“Group 2”] (JSON 陣列格式) 或 Group 1,Group 2 (CSV 格式)。 您可以依識別名稱 (例如 CN=User1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'User1') 來指定使用者或群組。 您可以依識別名稱或電腦名稱 (2K 之前) 後面接著 $ (例如 VM01$) 來指定電腦。

如果任何群組無法移除,則會發生例外狀況
ExceptionIfAnyGroupsFailToRemove boolean

如果設定為 true:如果任何單一群組無法移除,則會引發例外狀況 (失敗) (即 100% 成功是必要條件)。 如果未引發例外狀況,此動作會報告成功移除的群組數目,以及移除失敗的群組數目。

如果所有群組都無法移除,則會發生例外狀況
ExceptionIfAllGroupsFailToRemove boolean

如果設定為 true:只有在所有群組都無法移除 (即沒有成功且部分失敗) 時,才會引發異常 (失敗) 。 如果未引發例外狀況,此動作會報告成功移除的群組數目,以及移除失敗的群組數目。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

每次通話的組數上限
MaxGroupsPerCall integer

如果指定了大量 AD 群組進行移除,這可能會導致逾時。 透過將「每個通話的群組數目上限」值設定為 1 或更高,IA-Connect Orchestrator 會將此動作分割成多個呼叫,以達到每個通話指定的群組數目上限,對 IA-Connect Director 和客服人員進行呼叫。 首次在 IA-Connect 9.3 中推出。 例如:如果您設定值為 5,且要求移除 14 個群組,Orchestrator 會將其分割為 5、5、4 個要求。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已成功移除 AD 群組
ADGroupsRemovedSuccessfully integer

成功移除物件的 AD 群組數目。

AD 群組無法移除
ADGroupsFailedToRemove integer

物件無法從中移除的 AD 群組數目。

移除 AD 群組錯誤訊息
RemoveADGroupsMasterErrorMessage string

如果物件無法從某些 AD 群組中移除,且未引發例外狀況,則此錯誤訊息會提供問題的詳細資料。

從多個群組中移除 Azure AD 使用者

從多個現有的 Azure Active Directory 群組中移除 Azure Active Directory 使用者,其中群組是由物件識別碼或顯示名稱所指定。 IA-Connect 會從盡可能多的群組中移除使用者,並報告結果。 此動作無法修改通訊群組清單或已啟用郵件的安全性群組 - 請改用 Office 365 Exchange Online 動作。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
UserObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

要移除的 Azure AD 群組
GroupNamesJSON string

要從中移除使用者的 Azure AD 群組識別碼或顯示名稱清單,採用 JSON 或 CSV 格式。 例如:[{“GroupName”: “Group 1”}、{“GroupName”: “Group 2”}] (JSON 表格格式)、 [“Group 1”、“Group 2”] (JSON 陣列格式) 或 Group 1,Group 2 (CSV 格式)。

如果任何群組無法移除,則會發生例外狀況
ExceptionIfAnyGroupsFailToRemove boolean

如果設定為 true:如果任何單一群組無法移除,則會引發例外狀況 (失敗) (即 100% 成功是必要條件)。 某些群組 (例如:Office 365 群組) 可能不會移除,因此例外狀況可能很常見。 如果未引發例外狀況,此動作會報告成功刪除的群組數目,以及刪除失敗的群組數目。

如果所有群組都無法移除,則會發生例外狀況
ExceptionIfAllGroupsFailToRemove boolean

如果設定為 true:如果所有群組都無法移除 (即沒有成功且有些失敗) ,則會引發例外狀況 (失敗) 。 如果未引發例外狀況,此動作會報告成功刪除的群組數目,以及刪除失敗的群組數目。

先檢查使用者群組成員資格
CheckUserGroupMembershipsFirst boolean

如果設定為 true,IA-Connect 會先檢查使用者的群組成員資格,再嘗試從每個群組中移除使用者的群組成員資格。 如果使用者不是特定群組的成員,IA-Connect 只會報告該群組的成功,而不需要執行任何動作。 如果設定為 false,IA-Connect 會立即從每個指定的群組中移除使用者,而不進行檢查,如果使用者不在群組中,則會導致錯誤。

每個呼叫的 Azure AD 群組上限
MaxAzureADGroupsPerCall integer

如果使用者是大量 Azure AD 群組的成員,這可能會導致逾時。 透過將「每個呼叫的 Azure AD 群組數目上限」值設定為 1 或更高,IA-Connect Orchestrator 會將此動作分割成對 IA-Connect Director 和代理程式的多個呼叫,每個呼叫的群組數目上限。 例如:如果您設定值為 5 且需要移除 14 個群組,Orchestrator 會將其分割為 5、5、4 個要求。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已成功移除 Azure AD 群組
AzureADGroupsRemovedSuccessfully integer

成功移除使用者的 Azure AD 群組數目。

Azure AD 群組無法移除
AzureADGroupsFailedToRemove integer

使用者無法移除的 Azure AD 群組數目。

移除 Azure AD 群組主要錯誤訊息
RemoveAzureADGroupsErrorMessage string

如果使用者無法從某些 Azure AD 群組中移除,且未引發例外狀況,則此錯誤訊息會提供問題的詳細資料。

從所有系統管理員角色指派中移除 Azure AD 使用者

從指派給 Azure Active Directory 管理員角色的所有 Azure Active Directory 使用者 (或其他物件) 中移除。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
UserObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

如果任何角色無法移除,則會發生例外狀況
ExceptionIfAnyRolesFailToRemove boolean

如果設定為 true:如果任何單一管理員角色無法移除 (即需要 100% 成功) ,則會引發例外狀況 (失敗)。 如果未引發例外狀況,此動作會報告成功移除的角色數目,以及移除失敗的角色數目。

如果所有角色都無法移除,則為例外狀況
ExceptionIfAllRolesFailToRemove boolean

如果設定為 true (預設值):如果所有管理員角色都無法移除 (即沒有成功且部分失敗) ,則會引發例外狀況 (失敗)。 如果未引發例外狀況,此動作會報告成功移除的角色數目,以及移除失敗的角色數目。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已成功移除 Azure AD 角色
AzureADRolesRemovedSuccessfully integer

成功移除使用者的 Azure AD 角色數目。

Azure AD 角色無法移除
AzureADRolesFailedToRemove integer

使用者無法移除的 Azure AD 角色數目。

移除 Azure AD 角色主機錯誤訊息
RemoveAzureADRolesErrorMessage string

如果使用者無法從某些 Azure AD 角色中移除,且未引發例外狀況,則此錯誤訊息會提供問題的詳細資料。

從所有群組中移除 Active Directory 使用者

從 Active Directory 使用者所屬的所有 Active Directory 群組中移除他們。 IA-Connect 會從盡可能多的群組中移除使用者,並報告結果。 此動作僅適用於使用者帳戶,您無法使用此動作來移除群組或電腦的群組成員資格。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity string

要從所有群組中移除的使用者。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

要排除的 AD 群組
GroupsToExcludeJSON string

要從移除中排除的 AD 群組清單,採用 JSON 或 CSV 格式。 例如:[{“GroupName”: “Group 1”}、{“GroupName”: “Group 2”}] (JSON 表格格式)、 [“Group 1”、“Group 2”] (JSON 陣列格式) 或 Group 1,Group 2 (CSV 格式)。 您可以依識別名稱 (例如 CN=User1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'User1') 來指定使用者或群組。 您可以依識別名稱或電腦名稱 (2K 之前) 後面接著 $ (例如 VM01$) 來指定電腦。

排除的群組不存在時的例外狀況
ExceptionIfExcludedGroupDoesNotExist boolean

如果設定為 true:如果其中一個排除的群組不存在,則會引發異常 (失敗) (IA-Connect 必須查閱群組才能取得群組 DN)。 如果設定為 false (預設值):如果排除的群組不存在,則會忽略它,因為使用者不可能是該群組的成員。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

以執行緒身分執行
RunAsThread boolean

如果設定為 false,IA-Connect 代理程式會立即執行動作,並在動作完成時傳回結果,但如果花費的時間超過背景工作者/RPA 命令逾時,則會失敗。 如果設為 true,IA-Connect 代理程式會以代理程式執行緒的形式執行此動作,並監視它,直到它完成為止。 這可讓動作執行的時間超過背景工作角色/RPA 命令逾時的時間。

擷取執行緒識別碼的輸出資料
RetrieveOutputDataFromThreadId integer

如果您先前以代理程式執行緒身分執行此動作,並將「等待執行緒的秒數」設定為 0,請提供代理程式執行緒識別碼以擷取結果。 此代理程式執行緒識別碼將由先前呼叫此動作提供。 如果您只是執行此動作 (因此不會擷取此動作先前執行個體的結果,則設定為 0 (預設值) 作為代理程式執行緒執行)。

等待執行緒的秒數
SecondsToWaitForThread integer

如果「以執行緒身分執行」設定為 true,則等待代理程式執行緒完成的秒數。 如果執行此動作的代理程式執行緒在此時間內尚未完成,則會引發例外狀況。 設定為 0 以略過等待:代理程式將繼續執行動作,但也可用於下一個動作。 然後,您可以使用動作 '等候代理程式執行緒成功完成' 來等候代理程式執行緒完成,然後重新執行此 '從所有群組中移除 Active Directory 使用者' 動作,並將輸入 [擷取執行緒識別碼的輸出資料] 設定為代理程式執行緒識別碼,以擷取動作結果。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已成功移除 AD 群組
ADGroupsRemovedSuccessfully integer

成功移除使用者的 AD 群組數目。

AD 群組無法移除
ADGroupsFailedToRemove integer

使用者無法從中移除的 AD 群組數目。

從移除中排除的 AD 群組
ADGroupsExcludedFromRemoval integer

從移除中排除的 AD 群組數目。

移除 AD 群組錯誤訊息
RemoveADGroupsMasterErrorMessage string

如果使用者無法從某些 AD 群組中移除,則此錯誤訊息會提供問題的詳細資料。

執行緒識別碼
ThreadId integer

如果此動作是作為代理程式執行緒執行,則此輸出會保留代理程式執行緒識別碼,可用來監視動作執行,並在動作完成時擷取結果。

從所有群組中移除 Azure AD 使用者

從 Azure Active Directory 使用者所屬的所有 Azure Active Directory 群組中移除他們。 此動作無法修改通訊群組清單或已啟用郵件的安全性群組 - 請改用 Office 365 Exchange Online 動作。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
UserObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

如果任何群組無法移除,則會發生例外狀況
ExceptionIfAnyGroupsFailToRemove boolean

如果設定為 true:如果任何單一群組無法移除,則會引發例外狀況 (失敗) (即 100% 成功是必要條件)。 某些群組 (例如:Office 365 群組) 可能不會移除,因此例外狀況可能很常見。 如果未引發例外狀況,此動作會報告成功刪除的群組數目,以及刪除失敗的群組數目。

如果所有群組都無法移除,則會發生例外狀況
ExceptionIfAllGroupsFailToRemove boolean

如果設定為 true:如果所有群組都無法移除 (即沒有成功且有些失敗) ,則會引發例外狀況 (失敗) 。 如果未引發例外狀況,此動作會報告成功刪除的群組數目,以及刪除失敗的群組數目。

每個呼叫的 Azure AD 群組上限
MaxAzureADGroupsPerCall integer

如果使用者是大量 Azure AD 群組的成員,這可能會導致逾時。 透過將「每個呼叫的 Azure AD 群組數目上限」值設定為 1 或更高,IA-Connect Orchestrator 會將此動作分割成對 IA-Connect Director 和代理程式的多個呼叫,每個呼叫的群組數目上限。 例如:如果您設定值為 5 且需要移除 14 個群組,Orchestrator 會將其分割為 5、5、4 個要求。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已成功移除 Azure AD 群組
AzureADGroupsRemovedSuccessfully integer

成功移除使用者的 Azure AD 群組數目。

Azure AD 群組無法移除
AzureADGroupsFailedToRemove integer

使用者無法移除的 Azure AD 群組數目。

移除 Azure AD 群組主要錯誤訊息
RemoveAzureADGroupsErrorMessage string

如果使用者無法從某些 Azure AD 群組中移除,且未引發例外狀況,則此錯誤訊息會提供問題的詳細資料。

從所有通訊群組移除 Office 365 信箱

從信箱所屬的所有 Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組中移除信箱。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
MailboxIdentity string

要從其所屬的所有通訊群組或已啟用郵件的安全性群組中移除的信箱身分識別。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

略過安全性群組管理員檢查
BypassSecurityGroupManagerCheck boolean

如果 IA-Connect 代理程式自動化帳戶不是通訊群組或已啟用郵件的安全性群組的擁有者,則無法從該群組中移除成員。 如果您將此選項設定為 true (預設值) ,將會略過擁有者檢查,但它需要自動化帳戶位於 Exchange的「組織管理」角色群組中,或指派「角色管理」角色 - 這是單一角色,可讓您修改任何 Office 355 Exchange Online 群組的權限,而不是成為您需要修改之所有群組的擁有者。

如果任何群組無法移除,則會發生例外狀況
ExceptionIfAnyGroupsFailToRemove boolean

如果設定為 true:如果信箱無法從任何個別群組移除,則會引發例外狀況 (失敗) (,即需要 100% 成功) 。 如果未引發例外狀況,此動作會報告成功移除的群組數目,以及移除失敗的群組數目。

如果所有群組都無法移除,則會發生例外狀況
ExceptionIfAllGroupsFailToRemove boolean

如果設定為 true (預設值):如果信箱無法從所有群組中移除 (亦即沒有成功和某些失敗) ,則會引發例外狀況 (失敗) 。 如果未引發例外狀況,此動作會報告成功移除的群組數目,以及移除失敗的群組數目。

要排除的群組 DN
GroupDNsToExcludeJSON string

要從移除中排除的群組辨別名稱 (DN) 清單,採用 JSON 或 CSV 格式。 例如:[{“GroupDN”: “Group DN 1”}、{“GroupName”: “Group DN 2”}] (JSON 表格格式)、 [“Group DN 1”、“Group DN 2”] (JSON 陣列格式) 或 “Group DN 1”、“Group DN 2” (CSV 格式)。

以執行緒身分執行
RunAsThread boolean

如果設定為 false,IA-Connect 代理程式會立即執行動作,並在動作完成時傳回結果,但如果花費的時間超過背景工作者/RPA 命令逾時,則會失敗。 如果設為 true,IA-Connect 代理程式會以代理程式執行緒的形式執行此動作,並監視它,直到它完成為止。 這可讓動作執行的時間超過背景工作角色/RPA 命令逾時的時間。

擷取執行緒識別碼的輸出資料
RetrieveOutputDataFromThreadId integer

如果您先前以代理程式執行緒身分執行此動作,並將「等待執行緒的秒數」設定為 0,請提供代理程式執行緒識別碼以擷取結果。 此代理程式執行緒識別碼將由先前呼叫此動作提供。 如果您只是執行此動作 (因此不會擷取此動作先前執行個體的結果,則設定為 0 (預設值) 作為代理程式執行緒執行)。

等待執行緒的秒數
SecondsToWaitForThread integer

如果「以執行緒身分執行」設定為 true,則等待代理程式執行緒完成的秒數。 如果執行此動作的代理程式執行緒在此時間內尚未完成,則會引發例外狀況。 設定為 0 以略過等待:代理程式將繼續執行動作,但也可用於下一個動作。 然後,您可以使用動作 [等候代理程式執行程成功完成] 來等候代理程式執行緒完成,然後重新執行此 [從所有通訊群組移除 Office 365 信箱] 動作,並將輸入 [擷取執行緒識別碼的輸出資料] 設定為代理程式執行緒識別碼。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
O365 群組已成功移除
O365GroupsRemovedSuccessfully integer

成功移除信箱的 O365 群組數目。

O365 群組無法移除
O365GroupsFailedToRemove integer

信箱無法移除的 O365 群組數目。

O365 群組被排除在移除範圍之外
O365GroupsExcludedFromRemoval integer

從移除中排除的 O365 群組數目(即與要排除的指定群組 DN 之一相符)。

移除 O365 群組主要錯誤訊息
RemoveO365GroupsErrorMessage string

如果信箱無法從某些 O365 群組中移除,且未引發例外狀況,則此錯誤訊息會提供問題的詳細數據。

執行緒識別碼
ThreadId integer

如果此動作是作為代理程式執行緒執行,則此輸出會保留代理程式執行緒識別碼,可用來監視動作執行,並在動作完成時擷取結果。

從系統管理員角色指派中移除 Azure AD 使用者

從現有的 Azure Active Directory 系統管理員角色指派中移除 Azure Active Directory 使用者 (或其他物件)。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
UserObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

角色物件識別碼或顯示名稱
RoleObjectId True string

Azure Active Directory 系統管理員角色的識別碼或顯示名稱。 您可以依顯示名稱 (例如「應用程式開發人員」) 或 ObjectId (例如 UUID/GUID 值) 來指定 AAD 系統管理員角色。

目錄範圍識別碼
DirectoryScopeId string

選擇性目錄範圍識別碼,指定要移除的角色指派必須符合。 例如:/ 代表整個租用戶 (,而且只會產生目錄範圍標識碼為 / 的具名角色指派,/GUID 代表應用程式註冊,/administrativeUnits/GUID 代表系統管理單位。 如果您想要移除角色指派,而不論目錄範圍為何,請指定 * 或空白值。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
使用者已從角色中移除
UserRemovedFromRole boolean

如果使用者已從角色中移除,則為 True。 如果使用者未指派給角色,則為 False (因此無事可做)。

從群組中移除 Azure AD 使用者

從 Azure Active Directory 群組中移除 Azure Active Directory 使用者。 此動作無法修改通訊群組清單或已啟用郵件的安全性群組 - 請改用 Office 365 Exchange Online 動作。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
UserObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

群組物件識別碼或顯示名稱
GroupObjectId True string

Azure Active Directory 群組的識別碼或顯示名稱。 您可以依顯示名稱 (例如「財務使用者」) 或 ObjectId (例如 UUID/GUID 值) 指定群組。

先檢查使用者群組成員資格
CheckUserGroupMembershipsFirst boolean

如果設定為 true,IA-Connect 會先檢查使用者的群組成員資格,再嘗試從群組中移除使用者。 如果使用者不是群組的成員,IA-Connect 只會報告成功,而不需要執行任何動作。 如果設定為 false,IA-Connect 會立即將使用者從群組中移除,而不進行檢查,如果使用者不在群組中,則會導致錯誤。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
AzureADv2RemoveUserFromGroupResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

從通訊群組中移除 Office 365 成員

從 Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組中移除成員。

參數

名稱 機碼 必要 類型 Description
通訊群組身分識別
GroupIdentity True string

要從中移除的通訊群組或已啟用郵件的安全性群組身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=MyGroup、OU=My Groups、DC=mydomain、DC=local)、電子郵件地址或 GUID 來指定通訊群組。

要移除的成員
Member True string

要從通訊群組或已啟用郵件的安全性群組中移除的成員身分識別。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

略過安全性群組管理員檢查
BypassSecurityGroupManagerCheck boolean

如果 IA-Connect 代理程式自動化帳戶不是通訊群組或已啟用郵件的安全性群組的擁有者,則無法從群組中移除成員。 如果您將此選項設定為 true (預設值) ,將會略過擁有者檢查,但它需要自動化帳戶位於 Exchange的「組織管理」角色群組中,或指派「角色管理」角色 - 這是單一角色,可讓您修改任何 Office 355 Exchange Online 群組的權限,而不是成為您需要修改之所有群組的擁有者。

如果成員不在群組中,則例外情況
ExceptionIfMemberNotInGroup boolean

如果成員不在群組中,是否應該發生例外狀況? 設定為 false (預設值),如果成員不在群組中,則不會執行任何動作 (例如,它可能已經被移除,或從未在群組中)。 如果成員不在群組中是錯誤 (也就是預期它應該在群組中) ,則設定為 true。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
O365RemoveDistributionGroupMemberResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

從通訊群組移除 Microsoft Exchange 成員

從 Exchange 通訊群組移除成員 (例如使用者)。 如果成員不在群組中,則不會採取任何動作。

參數

名稱 機碼 必要 類型 Description
通訊群組身分識別
Identity True string

要新增的通訊群組身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=MyGroup、OU=My Groups、DC=mydomain、DC=local)、電子郵件地址或 GUID 來指定通訊群組。

要移除的成員
Member True string

要從通訊群組移除的成員身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

略過安全性群組管理員檢查
BypassSecurityGroupManagerCheck boolean

根據預設,如果 IA-Connect 代理程式自動化帳戶不是通訊群組的擁有者,則無法修改通訊群組。 或者,您可以將此選項設定為 true,這會移除該檢查,但它需要自動化帳戶位於 Exchange 的「組織管理」角色群組中,或指派「角色管理」角色 - 這是單一角色,可讓您修改任何 Exchange 通訊群組的許可權,而不是成為您需要修改之所有通訊群組的擁有者。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ExchangeRemoveDistributionGroupMemberResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

擷取 Microsoft Exchange Online 信箱詳細資料

傳回指定 Microsoft Exchange Online 或 Office 365 (遠端) 信箱的屬性。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。 您可以依身分或使用篩選器進行搜尋。 身分識別搜尋應該會傳回 0 或 1 個結果。 篩選搜尋可能會傳回 0 個或多個結果。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity string

Microsoft Exchange Online 或 Office 365 (遠端) 信箱的身分識別。 您可以依 Active Directory 物件識別碼、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、DOMAIN\username、電子郵件地址、GUID 或使用者主體名稱 (UPN) 來指定 Microsoft Exchange Online 或 Office 365 (遠端) 信箱。

篩選屬性名稱
FilterPropertyName string

作為依身分識別搜尋的替代方案,請提供要篩選信箱的屬性名稱。 常見的屬性名稱包括:Name、Alias、PrimarySMTPAddress、DisplayName。 如果使用篩選器,您也必須填入「篩選器資源比較」和「篩選器資源值」欄位。

篩選器屬性比較
FilterPropertyComparison string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入比較類型 (例如:如果篩選器屬性名稱為「別名」,則比較可以是「等於」或「類似」)。 如果您想要輸入原始篩選器 (OPATH 格式),請選擇「原始:手動輸入篩選器」的比較類型,然後在「篩選器屬性值」欄位中輸入完整篩選器。

篩選屬性值
FilterPropertyValue string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入篩選器屬性的值 (例如:如果篩選器屬性名稱為 'Alias',則篩選器屬性值可能是 'JohnDoe')。

沒有結果是例外嗎
NoResultIsAnException boolean

設定為 true,可在找不到信箱時引發例外狀況。 設定為 false ,如果找不到信箱,則只會報告計數 0。 請注意,「false」選項在與非英文語言的身分識別搭配使用時可能無法運作,因此請考慮改用篩選器進行搜尋。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
搜尋結果JSON
PowerShellJSONOutput string

符合搜尋身分識別的 Microsoft Exchange Online 或 Office 365 信箱 (及其要求的屬性) 清單,採用 JSON 格式。

找到的信箱計數
CountOfMailboxesFound integer

找到符合搜尋身分識別或篩選條件的 Microsoft Exchange Online 或 Office 365 信箱數目。 通常 1.

擷取 Microsoft Exchange Online 信箱電子郵件地址

擷取指派給現有 Microsoft Exchange Online 或 Office 365 (遠端) 信箱之所有電子郵件地址清單。 這包括主要 SMTP 位址、代理電子郵件地址、X.400 位址和 EUM(Exchange 統一通訊)位址。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange Online 或 Office 365 (遠端) 信箱的身分識別。 您可以依 Active Directory 物件識別碼、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、DOMAIN\username、電子郵件地址、GUID 或使用者主體名稱 (UPN) 來指定 Microsoft Exchange Online 或 Office 365 (遠端) 信箱。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
郵箱電子郵件地址
MailboxEmailAddresses array of string

信箱電子郵件地址。 主要 SMTP 電子郵件地址將顯示為 SMTP:emailaddress,次要 (Proxy) SMTP 電子郵件地址將顯示為 smtp:emailaddress,X.400 電子郵件地址將顯示為 x400:address,Exchange 整合通訊 (EUM) 位址將顯示為 eum:address。

擷取 Microsoft Exchange 信箱詳細資料

傳回指定 Exchange 信箱的屬性。 您可以依身分或使用篩選器進行搜尋。 身分識別搜尋應該會傳回 0 或 1 個結果。 篩選搜尋可能會傳回 0 個或多個結果。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity string

Microsoft Exchange 信箱的身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

篩選屬性名稱
FilterPropertyName string

作為依身分識別搜尋的替代方案,請提供要篩選信箱的屬性名稱。 常見的屬性名稱包括:Name、Alias、PrimarySMTPAddress、DisplayName、SamAccountName。 如果使用篩選器,您也必須填入「篩選器資源比較」和「篩選器資源值」欄位。

篩選器屬性比較
FilterPropertyComparison string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入比較類型 (例如:如果篩選器屬性名稱為「別名」,則比較可以是「等於」或「類似」)。 如果您想要輸入原始篩選器 (OPATH 格式),請選擇「原始:手動輸入篩選器」的比較類型,然後在「篩選器屬性值」欄位中輸入完整篩選器。

篩選屬性值
FilterPropertyValue string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入篩選器屬性的值 (例如:如果篩選器屬性名稱為 'Alias',則篩選器屬性值可能是 'JohnDoe')。

收件者類型詳細資料
RecipientTypeDetails string

要搜尋的信箱類型。 如果此欄位留空,則搜尋中將包含所有類型的信箱。

沒有結果是例外嗎
NoResultIsAnException boolean

設定為 true,可在找不到信箱時引發例外狀況。 設定為 false ,如果找不到信箱,則只會報告計數 0。 請注意,「false」選項在與非英文語言的身分識別搭配使用時可能無法運作,因此請考慮改用篩選器進行搜尋。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
搜尋結果JSON
PowerShellJSONOutput string

符合搜尋身分識別的 Exchange 信箱 (及其要求的屬性) 清單,採用 JSON 格式。

找到的信箱計數
CountOfMailboxesFound integer

找到符合搜尋身分識別或篩選條件的 Exchange 信箱數目。 如果按身份搜索,則預期會有 1 個結果。 如果按過濾器搜索,則預期會有 0 個或更多結果。

擷取 Microsoft Exchange 信箱通訊群組成員資格

擷取信箱所屬的通訊群組。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange 信箱的身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
搜尋結果JSON
PowerShellJSONOutput string

信箱所屬的 Microsoft Exchange 通訊群組清單,採用 JSON 格式。

找到的通訊群組計數
CountOfDistributionGroupsFound integer

信箱所屬的 Microsoft Exchange 通訊群組數目。

擷取 Microsoft Exchange 信箱電子郵件地址

擷取指派給 Microsoft Exchange 信箱的所有電子郵件地址清單。 這包括主要 SMTP 位址、代理電子郵件地址、X.400 位址和 EUM(Exchange 統一通訊)位址。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange 信箱的身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
郵箱電子郵件地址
MailboxEmailAddresses array of string

信箱電子郵件地址。 主要 SMTP 電子郵件地址將顯示為 SMTP:emailaddress,次要 (Proxy) SMTP 電子郵件地址將顯示為 smtp:emailaddress,X.400 電子郵件地址將顯示為 x400:address,Exchange 整合通訊 (EUM) 位址將顯示為 eum:address。

擷取 Microsoft Exchange 通訊群組詳細數據

擷取 Microsoft Exchange 通訊群組的詳細數據。 您可以依身分或使用篩選器進行搜尋。 身分識別搜尋應該會傳回 0 或 1 個結果。 篩選搜尋可能會傳回 0 個或多個結果。

參數

名稱 機碼 必要 類型 Description
通訊群組身分識別
Identity string

要搜尋的通訊群組身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=MyGroup、OU=My Groups、DC=mydomain、DC=local)、電子郵件地址或 GUID 來指定通訊群組。

篩選屬性名稱
FilterPropertyName string

作為依身分識別搜尋的替代方案,請提供屬性名稱以篩選通訊群組。 常見的屬性名稱包括:DisplayName、Name、GroupType、PrimarySMTPAddress。 如果使用篩選器,您也必須填入「篩選器資源比較」和「篩選器資源值」欄位。

篩選器屬性比較
FilterPropertyComparison string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入比較類型 (例如:如果篩選器屬性名稱為「別名」,則比較可以是「等於」或「類似」)。 如果您想要輸入原始篩選器 (OPATH 格式),請選擇「原始:手動輸入篩選器」的比較類型,然後在「篩選器屬性值」欄位中輸入完整篩選器。

篩選屬性值
FilterPropertyValue string

如果依篩選器搜尋,而不是依身分識別搜尋,請在此處輸入篩選器屬性的值 (例如:如果篩選器屬性名稱為 'Alias',則篩選器屬性值可能是 'JohnDoe')。

沒有結果是例外嗎
NoResultIsAnException boolean

設定為 true,以在找不到通訊群組時引發例外狀況。 設定為 false,如果找不到通訊群組,則只會報告計數 0。 請注意,「false」選項在與非英文語言的身分識別搭配使用時可能無法運作,因此請考慮改用篩選器進行搜尋。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
搜尋結果JSON
PowerShellJSONOutput string

符合搜尋身分識別或篩選的 Microsoft Exchange 通訊群組清單,採用 JSON 格式。

找到的通訊群組計數
CountOfDistributionGroupsFound integer

找到符合搜尋身分識別或篩選的 Microsoft Exchange 通訊群組數目。 通常 1.

擷取 Office 365 信箱通訊群組成員資格

擷取 Office 365 或 Exchange Online 信箱所屬的通訊群組或已啟用郵件的安全性群組。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
MailboxIdentity True string

Microsoft Exchange Online 或 Office 365 信箱的識別碼。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

要擷取的內容
PropertiesToRetrieveJSON string

要擷取的成員屬性清單,採用 JSON 或 CSV 格式。 例如:[“Identity”、“DistinguishedName”] (JSON 陣列格式) 或 “Identity”,“DistinguishedName” (CSV 格式)。 常見的群組屬性包括:Alias、DisplayName、DistinguishedName、GroupType、Identity、Name、PrimarySmtpAddress 和 SamAcountName。 如果您將此欄位保留空白,則會擷取一組預設內容。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
搜尋結果JSON
PowerShellJSONOutput string

信箱所屬的 Office 365 或 Exchange Online 通訊群組或已啟用郵件的安全性群組清單,採用 JSON 格式。

找到的通訊群組計數
CountOfDistributionGroupsFound integer

信箱所屬的 Office 365 或 Exchange Online 通訊群組或已啟用郵件的安全性群組數目。

新增 Active Directory OU

建立新的 Active Directory 組織單位 (OU)。

參數

名稱 機碼 必要 類型 Description
名稱
Name True string

Active Directory OU 的名稱。 這會出現在 AD 使用者和電腦的 OU 樹狀結構中,以及 OU 屬性 [一般] 索引標籤頂端 (在標題中) 。

路徑
Path string

組織單位 (OU) ,以識別名稱格式 (例如 OU=父 OU、OU=倫敦、DC=mydomain、DC=本機)、GUID 格式或路徑 (例如 London\Parent OU) 儲存新 OU。 如果將其保留空白,則會在樹狀結構的根目錄中建立 OU。

Description
Description string

選用的 OU 說明。

顯示名稱
DisplayName string

選用的 OU 顯示名稱。 不同於使用者帳戶,OU 顯示名稱不會顯示在 AD 使用者和電腦中。

管理單位
ManagedBy string

指定管理此 OU 的使用者或群組。 您可以以識別名稱格式 (例如 CN=MrBig、OU=London、DC=mydomain、DC=local)、GUID 格式、SID 或 SAMAccountName (例如 'MrBig') 指定此輸入。

防止意外刪除
ProtectedFromAccidentalDeletion boolean

設定為 true (預設值) ,以保護此 OU 免於意外刪除。 設定為 false 可讓 OU 不受意外刪除的保護。

街道地址
StreetAddress string

OU 的 'Street' 屬性 (在 AD 使用者和電腦的 OU 屬性 'General' 索引標籤中) 。

城市
City string

OU 的 'City' 屬性 (在 AD 使用者和電腦的 OU 屬性 'General' 索引標籤中) 。

State
State string

OU 的 'State/province' 屬性 (在 AD 使用者和電腦的 OU 屬性 'General' 索引標籤中)。

郵遞區號
PostalCode string

OU 的 'ZIP/Postal Code' 屬性 (在 AD 使用者和電腦的 OU 屬性 'General' 索引標籤中) 。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
PowerShell 輸出 JSON
PowerShellJSONOutput string

PowerShell 指令碼的輸出,格式為 JSON。

已建立的 OU 識別名稱
CreatedOUDistinguishedName string

已建立 OU 的 Active Directory 識別名稱 (DN)。

新增 Active Directory 使用者

建立新的 Active Directory 使用者帳戶。

參數

名稱 機碼 必要 類型 Description
名稱
Name True string

Active Directory 使用者的名稱。 這會顯示在 AD 使用者和電腦的「名稱」欄中,以及使用者「一般」索引標籤的頂端 (在標題中)。 這不是使用者登入名稱。

使用者主體名稱
UserPrincipalName string

Active Directory 中的使用者登入名稱。 這通常應該採用 'name@domainFQDN' 格式(例如 'TestUser1@domain.local')。 使用者可以使用以下格式登入:name@domainFQDN。

SAM 帳戶名稱
SamAccountName string

Active Directory 中的使用者登入名稱 (Windows 2000 之前)。 其格式為 'name' (例如 'TestUser1')。 使用者可以使用以下格式登入:DOMAIN\name。

名字
GivenName string

選用使用者名字。

姓氏
SurName string

選擇性使用者姓氏。

路徑
Path string

組織單位 (OU) ,以識別名稱格式 (例如 OU=Target OU、OU=London、DC=mydomain、DC=local)、GUID 格式或路徑 (例如 MyUsers\London) 儲存使用者。 如果將其保留空白,則會在「使用者」OU 中建立使用者。

Description
Description string

選用使用者描述。

顯示名稱
DisplayName string

選擇性使用者顯示名稱。

帳戶密碼
AccountPassword password

使用者密碼。 必須指定此值,並符合 Active Directory 密碼複雜度規則。 如果這是「儲存」密碼,請輸入 {IAConnectPassword:StoredPasswordIdentifier} 格式,並將「儲存密碼」輸入設定為 true。 如果這是 Orchestrator 一般認證,請輸入 {OrchestratorCredential:FriendlyName} 格式,並將「儲存的密碼」輸入設定為 true。

帳號密碼為儲存密碼
AccountPasswordIsStoredPassword boolean

如果密碼是 IA-Connect 儲存的密碼識別碼 (例如:由「產生密碼」動作產生) 或 IA-Connect Orchestrator 一般認證 (例如:如果將 IA-Connect 與 PA 流程搭配使用),則設定為 true。

已啟用
Enabled boolean

如果您想要在建立帳戶後立即啟用帳戶,請設定為true。 設定為 false ,帳戶會開始停用。 此選項預設為 true。

用戶必須在下次登入時變更密碼
ChangePasswordAtLogon boolean

如果您想要強制使用者在登入時變更密碼,請設定為 true (也就是說,此處設定的新密碼是讓使用者登入的一次性密碼)。 如果這是使用者將使用的密碼,則設定為 false,直到他們手動變更為止。 您不能將此選項設定為 true,同時將「使用者無法變更密碼」或「密碼永不過期」設定為 true。

用戶無法變更密碼
CannotChangePassword boolean

設定為 true 可阻止使用者變更其密碼。 如果使用者可以變更密碼,則設為 false。 您不能將此選項設定為 true,同時將「使用者必須在下次登入時變更密碼」設定為 true。

密碼永不過期
PasswordNeverExpires boolean

如果密碼永遠不會過期,則設定為 true (亦即永遠不會提示使用者變更密碼)。 如果密碼可以過期,請設定為 false 如 Active Directory 網域原則中所設定。 您不能將此選項設定為 true,同時將「使用者必須在下次登入時變更密碼」設定為 true。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
PowerShell 輸出 JSON
PowerShellJSONOutput string

PowerShell 指令碼的輸出,格式為 JSON。

已建立的使用者識別名稱
CreatedUserDistinguishedName string

已建立使用者帳戶的 Active Directory 辨別名稱 (DN)。

已建立的使用者 SAM 帳戶名稱
CreatedUserSAMAccountName string

已建立使用者帳戶的 Active Directory SAM 帳戶名稱。

已建立的使用者主體名稱
CreatedUserPrincipalName string

所建立使用者帳戶的 Active Directory 使用者主體名稱 (UPN)。

新增 Active Directory 群組

建立新的 Active Directory 群組。

參數

名稱 機碼 必要 類型 Description
名稱
Name True string

Active Directory 群組的名稱。 這會顯示在 AD 使用者和電腦的「名稱」欄中,以及群組的「一般」索引標籤頂端 (在標題中)。

SAM 帳戶名稱
SamAccountName string

Active Directory 中的群組名稱 (Windows 2000 之前)。 其格式為 'name' (例如 'TestGroup1')。

路徑
Path string

組織單位 (OU) ,以識別名稱格式 (例如 OU=Target OU、OU=London、DC=mydomain、DC=local)、GUID 格式或路徑 (例如 MyGroups\London) 儲存群組。 如果將其保留空白,則會在「使用者」OU 中建立群組。

Description
Description string

選用的群組描述。

註釋
Notes string

可選的群組註釋。

顯示名稱
DisplayName string

選擇性群組顯示名稱。 與使用者帳戶不同,群組顯示名稱不會顯示在 AD 使用者和電腦中。

團體類別
GroupCategory True string

要建立的群組類型。 安全性群組通常用來管理使用者和電腦對 IT 資源的存取。 通訊群組通常用來建立群組電子郵件,可讓您傳送電子郵件給使用者群組。

群組範圍
GroupScope True string

要建立的群組範圍。 有一組複雜的規則,說明可以參考群組的位置,以及可以放置在群組中的內容,視該群組的範圍而定。 您稍後無法一律轉換成另一個群組範圍,因此您應該在建立時挑選正確的範圍。

首頁
HomePage string

選用的群組首頁。

管理單位
ManagedBy string

指定管理此群組的使用者或群組。 您可以以識別名稱格式 (例如 CN=MrBig、OU=London、DC=mydomain、DC=local)、GUID 格式、SID 或 SAMAccountName (例如 'MrBig') 指定此輸入。

防止意外刪除
ProtectedFromAccidentalDeletion boolean

設定為 true 可保護此群組免於意外刪除。 設定為 false 可讓群組預設為不受意外刪除保護。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
PowerShell 輸出 JSON
PowerShellJSONOutput string

PowerShell 指令碼的輸出,格式為 JSON。

已建立的群組識別名稱
CreatedGroupDistinguishedName string

已建立群組的 Active Directory 識別名稱 (DN)。

已建立的群組 SAM 帳戶名稱
CreatedGroupSAMAccountName string

已建立群組的 Active Directory SAM 帳戶名稱。

新增 Active Directory 群組成員

將 Active Directory 物件 (通常是使用者、群組或電腦) 新增至現有的 Active Directory 群組。 如果群組和群組成員位於不同的網域中,則需要為群組和成員指定識別名稱 (DN)。

參數

名稱 機碼 必要 類型 Description
群組身分
GroupIdentity string

Active Directory 群組的身分識別。 您可以依識別名稱 (例如 CN=Group1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'Group1') 來指定群組。 您不能使用顯示名稱或群組名稱(儘管群組名稱通常與可以使用的 2K 之前名稱相同)。

群組名稱
GroupName string

作為依身分識別搜尋的替代方案,請提供 Active Directory 群組的 2K 之前名稱 (SAMAccountName)。 由於「群組身分」輸入也接受 2K 之前的名稱,因此此輸入現在是多餘的,但為了回溯相容性而保留。

群組成員
UserIdentity True string

要新增的群組成員 (通常是使用者、群組或電腦)。 您可以依識別名稱 (例如 CN=User1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'User1') 來指定使用者或群組。 您可以依識別名稱或電腦名稱 (2K 之前) 後面接著 $ (例如 VM01$) 來指定電腦。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectoryAddADGroupMemberByIdentityResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

新增 Azure AD 使用者

建立新的 Azure Active Directory 使用者帳戶。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者主體名稱
UserPrincipalName True string

Azure Active Directory 中的使用者登入名稱。 這通常應該採用 'name@domainFQDN' 格式(例如 'TestUser1@mydomain.onmicrosoft.com')。

已啟用帳戶
AccountEnabled True boolean

如果您想要在建立帳戶後立即啟用帳戶,請設定為true。 設定為 false ,帳戶會開始停用。 此選項預設為 true。

帳戶密碼
AccountPassword True password

使用者密碼。 必須指定此值,並符合 Azure Active Directory 密碼複雜度規則。 如果這是「儲存」密碼,請輸入 {IAConnectPassword:StoredPasswordIdentifier} 格式,並將「儲存密碼」輸入設定為 true。 如果這是 Orchestrator 一般認證,請輸入 {OrchestratorCredential:FriendlyName} 格式,並將「儲存的密碼」輸入設定為 true。

帳號密碼為儲存密碼
AccountPasswordIsStoredPassword boolean

如果密碼是 IA-Connect 儲存的密碼識別碼 (例如:由「產生密碼」動作產生) 或 IA-Connect Orchestrator 一般認證 (例如:如果將 IA-Connect 與 PA 流程搭配使用),則設定為 true。

名字
FirstName string

使用者的名字。

姓氏
LastName string

使用者的姓氏/姓氏。

顯示名稱
DisplayName True string

此使用者的完整顯示名稱。

城市
City string

使用者居住的城市名稱,或其辦公室所在的位置。

公司名稱
CompanyName string

使用者工作的公司名稱。

國家或地區
Country string

使用者居住的國家或地區,或其辦公室所在的位置。

部門
Department string

使用者在公司內工作的部門名稱。

傳真號碼
FaxNumber string

使用者的傳真 (傳真) 電話號碼。

職稱
JobTitle string

使用者的職稱。

郵件暱稱
MailNickName True string

使用者的郵件暱稱。

手機號碼
MobilePhone string

使用者的手機號碼。

Office
Office string

使用者工作的辦公室位置。

電話號碼
PhoneNumber string

使用者的電話號碼。

郵遞區號
PostalCode string

使用者居住的郵遞區號或郵遞區號,或他們工作的辦公室。

首選語言
PreferredLanguage string

使用者的偏好語言。 這通常以兩個字母的語言代碼 (ISO 639-1) 的形式輸入,後面接著破折號,後面接著兩個字母的大寫國家/地區代碼 (ISO 3166)。 例如:en-US、 en-GB、 fr-FR、 ja-JP。

State 或 province
State string

使用者居住的州、省或縣,或其辦公室所在的位置。

街道地址
StreetAddress string

使用者居住的街道地址,或其辦公室街道地址。

使用位置
UsageLocation string

兩個字母的國家代碼 (ISO 3166)。 對於因法律要求而獲指派授權的使用者所必需。 例如:美國 (美國)、日本 (日本)、GB (英國)、法國 (法國)、印度 (印度)。 請參閱 https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes

年齡組
AgeGroup string

使用者的年齡層,用於家長監護目的。 預設值為 none / not specified which (從控制項目的觀點來看) 與 Adult 相同。

為未成年人提供同意書
ConsentProvidedForMinor string

如果「年齡群組」為「未成年人」,則此欄位可讓您指定是否已為未成年人提供同意,以符合家長監護目的。

員工 ID
EmployeeId string

選擇性的員工識別碼。您可以使用此功能來區分組織中的每個使用者。

下次登入時強制更改密碼
ForceChangePasswordNextLogin boolean

如果您想要強制使用者下次登入時變更密碼,請設定為 true (也就是說,此處設定的新密碼是允許使用者登入的一次性密碼)。 如果這是使用者將使用的密碼,則設定為 false,直到他們手動變更為止。

強制執行變更密碼原則
EnforceChangePasswordPolicy boolean

設定為 true 可強制執行 Azure Active Directory 變更密碼原則,該原則 (視您的環境而定) 可定義使用者變更其密碼、密碼復原選項和其他安全性驗證的頻率。 這可能會導致系統提示使用者輸入其他資訊。

密碼永不過期
PasswordNeverExpires boolean

如果密碼永遠不會過期,則設定為 true (亦即永遠不會提示使用者變更密碼)。 如果密碼可以過期,請設定為 false 如 Azure Active Directory 密碼原則中所設定。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
動作結果JSON
PowerShellJSONOutput string

PowerShell 指令碼的輸出,格式為 JSON。

已建立的使用者主體名稱
CreatedUserPrincipalName string

所建立使用者帳戶的 Azure Active Directory 使用者主體名稱 (UPN)。

已建立的使用者物件識別碼
CreatedUserObjectId string

已建立使用者帳戶的 Azure Active Directory 使用者物件識別碼。

新增 Microsoft Exchange 信箱權限

將信箱權限指派給 Active Directory 物件 (例如使用者或群組) 。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange 信箱的身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

Active Directory 物件
User True string

要指派權限的 Active Directory 物件 (例如使用者或群組)。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定使用者。

存取權限
AccessRights string

要指派給使用者信箱權限的存取權限。 可用的選項包括 'AccessSystemSecurity'、'CreateChild'、'DeleteChild'、'ListChildren'、'Self'、'ReadProperty'、'WriteProperty'、'DeleteTree'、'ListObject'、'ExtendedRight'、'Delete'、'ReadControl'、'GenericExecute'、'GenericWrite'、'GenericRead'、'WriteDacl'、'WriteOwner'、'GenericAll' 和 'Synchronize'。

延伸權利
ExtendedRights string

選擇性延伸許可權,可指派給使用者信箱的許可權。 延伸權限包括「傳送方式」。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ExchangeAddADPermissionResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

新增多個 Active Directory 群組成員

將一或多個 Active Directory 物件 (通常是使用者、群組或電腦) 新增至現有的 Active Directory 群組。 IA-Connect 將盡可能多的成員添加到群組中並報告結果。 如果群組和群組成員位於不同的網域中,則需要為群組和成員指定識別名稱 (DN)。 如果某些物件已經是群組的成員,則會算作成功。

參數

名稱 機碼 必要 類型 Description
群組身分
GroupIdentity string

Active Directory 群組的身分識別。 您可以依識別名稱 (例如 CN=Group1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'Group1') 來指定群組。 您不能使用顯示名稱或群組名稱(儘管群組名稱通常與可以使用的 2K 之前名稱相同)。

群組成員
GroupMembersJSON string

要新增至 AD 群組的成員 (通常是使用者、群組或電腦) 清單,採用 JSON 或 CSV 格式。 例如:[{“MemberName”: “User 1”}、{“MemberName”: “User 2”}] (JSON 表格格式)、 [“User 1”、“User 2”] (JSON 陣列格式) 或 User 1,User 2 (CSV 格式)。 您可以依識別名稱 (例如 CN=User1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'User1') 來指定使用者或群組。 您可以依識別名稱或電腦名稱 (2K 之前) 後面接著 $ (例如 VM01$) 來指定電腦。

如果任何成員無法新增
ExceptionIfAnyMembersFailToAdd boolean

如果設定為 true:如果任何單一成員無法新增,則會引發例外狀況 (失敗) (即需要 100% 成功)。 如果未引發例外狀況,此動作會報告成功新增的成員數目,以及新增失敗的成員數目。

如果所有成員都無法新增
ExceptionIfAllMembersFailToAdd boolean

如果設定為 true:只有在所有成員都無法新增 (即沒有成功且部分失敗) 時,才會引發異常 (失敗) 。 如果未引發例外狀況,此動作會報告成功新增的成員數目,以及新增失敗的成員數目。

在一次通話中新增所有成員
AddAllMembersInASingleCall boolean

如果設定為 true,則所有成員都會在單一動作中新增至群組。 這會更快,但如果單一成員不存在或無法新增,則不會新增任何成員,並且會引發例外,無論「例外」輸入選項為何。 如果設定為 false (預設值),則會個別新增每個成員,而 IA-Connect 代理程式會計算成功新增的數目,以及新增失敗的數目。 如果跨網域將成員新增至群組,建議將此輸入設定為 false。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
AD群組成員已成功新增
ADGroupMembersAddedSuccessfully integer

成功新增至 AD 群組的成員數目。

AD 群組成員無法新增
ADGroupMembersFailedToAdd integer

無法新增至 AD 群組的成員數目。

新增 AD 群組成員錯誤訊息
AddADGroupMembersMasterErrorMessage string

如果某些成員無法新增至 AD 群組,且未引發例外狀況,則此錯誤訊息會提供問題的詳細資料。

是 Azure AD 使用者群組中的使用者

傳回使用者是否為 Azure Active Directory 群組的成員。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
ObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

群組物件識別碼或顯示名稱
GroupObjectId True string

Azure Active Directory 群組的識別碼或顯示名稱。 您可以依顯示名稱 (例如「財務使用者」) 或 ObjectId (例如 UUID/GUID 值) 指定群組。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
使用者在群組中
UserIsInGroup boolean

使用者是否為 Azure AD 群組的成員。

是否已安裝 Azure AD PowerShell 模組

報告 Azure Active Directory 所需的 PowerShell 模組 (也稱為 Microsoft Entra ID、Azure AD 或 AAD) 是否安裝在執行 IA-Connect 代理程式的電腦上。 此動作會檢查 Azure AD v2 和 Microsoft Graph 使用者 PowerShell 模組。

參數

名稱 機碼 必要 類型 Description
Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已安裝 Azure AD v2 PowerShell 模組
AzureADv2PowerShellModuleInstalled boolean

如果已安裝 Azure AD v2 PowerShell 模組 (AzureAD),則設定為 true。

已安裝 Microsoft Graph 使用者 PowerShell 模組
MSGraphUsersPowerShellModuleInstalled boolean

如果已安裝 Microsoft Graph 使用者 PowerShell 模組 (Microsoft.Graph.Users 和 Microsoft.Graph.Authentication) ,則設定為 true。

檢查 Active Directory OU 是否存在

報告 Active Directory 組織單位 (OU) 是否存在。

參數

名稱 機碼 必要 類型 Description
OU 身分識別
OUIdentity True string

目標組織單位 (OU) 的路徑,採用辨別名稱格式 (例如 OU=Target OU、OU=London、DC=mydomain、DC=local)、GUID 格式或路徑 (例如 London\Target OU) 。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
OU 屬性作為 JSON
PowerShellJSONOutput string

已找到的組織單位 (OU) 的詳細資料。

OU 存在
OUExists boolean

如果組織單位 (OU) 存在,則設定為 true,如果不存在,則設定為 false。

清除 Active Directory 使用者帳戶到期

清除 Active Directory 帳戶的到期日。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity True string

Active Directory 使用者的身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectoryClearADUserAccountExpirationResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

為使用者建立 Microsoft Exchange Online 信箱

為內部部署 Active Directory 中尚未有信箱的現有使用者建立 Microsoft Exchange Online 或 Office 365 (遠端) 信箱或封存信箱。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。 您也可以使用此動作來封存現有的遠端信箱。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

您要為其建立信箱的現有使用者身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

Alias
Alias string

使用者的 Exchange 別名 (也稱為郵件暱稱)。 如果已啟用電子郵件地址原則,則會用來產生主要SMTP電子郵件地址的名稱元件(例如)。 alias@mydomain.com 如果未啟用電子郵件地址原則,您可能希望改為設定主要 SMTP 位址。

顯示名稱
DisplayName string

信箱的顯示名稱。 這在地址列表中可見。

遠端路由位址
RemoteRoutingAddress string

此使用者與之相關聯的 Microsoft Exchange Online 或 Office 365 信箱的 SMTP 位址。

主要 SMTP 位址
PrimarySmtpAddress string

用於收件者的主要回信電子郵件地址。 如果啟用了「電子郵件地址政策」,您不太可能設定此功能,因此請改用「別名」或停用電子郵件地址政策。

建立封存信箱
Archive boolean

如果您想要在 Microsoft Exchange Online 或 Office 365 中額外建立封存信箱,請設定為 true。

已啟用電子郵件地址原則
EmailAddressPolicyEnabled boolean

如果您想要根據套用至此收件者的電子郵件地址原則自動更新電子郵件地址,請設定為 true。 如果啟用電子郵件地址原則,這通常會影響您設定主要 SMTP 位址的能力。 設定為 false 可停用該功能,讓您完全控制手動設定電子郵件地址。 如果您不想設定此選項,請保留空白(即保留現有值或預設值)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
動作結果JSON
PowerShellJSONOutput string

啟用遠端信箱動作的輸出,採用 JSON 格式。

新信箱 DN
NewMailboxDN string

新建立 (啟用) 信箱的辨別名稱 (DN)。 這是信箱的唯一識別碼,可用於此信箱的進一步動作。

新的信箱 GUID
NewMailboxGUID string

新建立 (已啟用) 信箱的 GUID。 這是信箱的唯一識別碼,可用於此信箱的進一步動作。

為使用者建立 Microsoft Exchange 信箱

為尚未有信箱的現有使用者建立 Microsoft Exchange 信箱。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

您要為其建立信箱的現有使用者身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

Alias
Alias string

使用者的 Exchange 別名 (也稱為郵件暱稱)。 如果已啟用電子郵件地址原則,則會用來產生主要SMTP電子郵件地址的名稱元件(例如)。 alias@mydomain.com 如果未啟用電子郵件地址原則,您可能希望改為設定主要 SMTP 位址。

顯示名稱
DisplayName string

信箱的顯示名稱。 這在地址列表中可見。

連結的網域控制站
LinkedDomainController string

如果您要建立連結信箱,這可讓您在使用者帳戶所在的樹系中指定網域控制站。 使用網域控制站的完整網域名稱 (FQDN) 。

連結的主帳戶
LinkedMasterAccount string

如果您要建立連結的信箱,這可讓您指定信箱連結到的帳戶。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID 或名稱 (例如 'User1') 來指定帳戶。

資料庫
Database string

要包含新資料庫的 Exchange 資料庫。 您可以依辨別名稱、GUID 或名稱來指定資料庫。

主要 SMTP 位址
PrimarySmtpAddress string

用於收件者的主要回信電子郵件地址。 如果啟用「電子郵件地址原則」,您不太可能設定此設定,因此請改用「別名」(原則會從別名建立主要 SMTP 位址),或停用電子郵件地址原則。

已啟用電子郵件地址原則
EmailAddressPolicyEnabled boolean

如果您想要根據套用至此收件者的電子郵件地址原則自動更新電子郵件地址,請設定為 true。 如果啟用電子郵件地址原則,這通常會影響您設定主要 SMTP 位址的能力。 設定為 false 可停用該功能,讓您完全控制手動設定電子郵件地址。 如果您不想設定此選項,請保留空白(即保留現有值或預設值)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
動作結果JSON
PowerShellJSONOutput string

啟用信箱動作的輸出,採用 JSON 格式。

新信箱 DN
NewMailboxDN string

新建立 (啟用) 信箱的辨別名稱 (DN)。 這是信箱的唯一識別碼,可用於此信箱的進一步動作。

新的信箱 GUID
NewMailboxGUID string

新建立 (已啟用) 信箱的 GUID。 這是信箱的唯一識別碼,可用於此信箱的進一步動作。

為現有使用者建立 Office 365 封存信箱

在 Microsoft Exchange Online 中為 Azure Active Directory/Entra ID 中的現有使用者建立封存信箱。 使用者必須已經擁有信箱和適當的授權。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange Online 或 Office 365 信箱的識別碼。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

檢查存檔是否存在
CheckIfArchiveExists boolean

如果設定為 true (預設值),IA-Connect 代理程式會檢查信箱是否已經有封存。 如果存檔已經存在,則無需執行任何操作(因為您無法創建兩次存檔),並且代理將返回成功。 如果設定為 false,IA-Connect 代理程式將不會檢查信箱是否已經有封存,如果封存已經存在,則會導致例外狀況。

存檔名稱
ArchiveName string

選用的封存名稱。 如果未指定,則預設為 'In-Place Archive - {Display name}'。

自動擴展存檔
AutoExpandingArchive boolean

如果設定為 true,則當封存信箱接近儲存限制時,會自動將額外的儲存空間新增至封存信箱。 此功能一旦啟用,就無法停用。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
O365EnableArchiveMailboxResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

移除 Active Directory OU

從 Active Directory 中移除組織單位 (OU)。 如果 OU 中有物件 (例如使用者、群組或電腦),則無法刪除 OU。

參數

名稱 機碼 必要 類型 Description
OU 身分識別
OUIdentity True string

Active Directory OU 的身分識別。 您可以依識別名稱 (例如 OU=Servers、OU=London、DC=mydomain、DC=local)、GUID 格式或路徑 (例如 London\Servers) 來指定 OU。

即使受保護也刪除
DeleteEvenIfProtected boolean

設定為 true 可刪除 OU,即使它受到保護免於刪除。 設定為 false ,只會在 OU 未受到保護時刪除 OU ,並在 OU 受到保護時引發例外狀況。

如果 OU 不存在,則引發例外狀況
RaiseExceptionIfOUDoesNotExist boolean

如果設定為 true 且 OU 不存在,則會引發例外狀況。 如果設定為 false 且 OU 不存在,則動作會報告成功,但輸出會報告未刪除任何 OU。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已刪除的 OU 數目
NumberOfOUsDeleted integer

此輸出會保留已刪除的 AD OU 數目,應該是 0 或 1。

移除 Active Directory 使用者

從 Active Directory 中移除使用者。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity True string

Active Directory 使用者的身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

移除意外刪除的保護
RemoveProtectionFromAccidentalDeletion boolean

設定為 true,以嘗試移除使用者之前,先嘗試移除意外刪除的保護。

即使使用者有子物件也移除
DeleteEvenIfUserHasSubObjects boolean

如果使用者帳戶有子物件 (亦即使用者不是分葉物件) ,則移除使用者的一般指令將會失敗。 如果您想要在偵測到子物件時回復至替代刪除方法,請將此輸入設定為 true。

強制刪除遞迴
ForceDeleteRecursive boolean

如果使用者帳戶有子物件 (亦即使用者不是分葉物件) ,則移除使用者的一般指令將會失敗。 如果您想要執行遞迴子物件刪除,而不需要先嘗試正常移除使用者,請將此輸入設定為 true。 如果後援偵測不起作用,這可能會很有用。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectoryRemoveADUserByIdentityResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

移除 Active Directory 群組

從 Active Directory 中移除群組。 如果群組中有物件 (例如使用者、群組或電腦),這些物件將在群組刪除過程中移除。

參數

名稱 機碼 必要 類型 Description
群組身分
GroupIdentity True string

Active Directory 群組的身分識別。 您可以依識別名稱 (例如 CN=Group1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'Group1') 來指定群組。 您不能使用顯示名稱或群組名稱(儘管群組名稱通常與可以使用的 2K 之前名稱相同)。

即使受保護也刪除
DeleteEvenIfProtected boolean

設定為 true 可刪除群組,即使該群組受到保護,不會被刪除。 設定為 false 只會在群組未受到刪除保護時刪除群組,並在群組受到保護時引發例外狀況。

如果群組不存在,則引發例外狀況
RaiseExceptionIfGroupDoesNotExist boolean

如果設定為 true 且群組不存在,則會引發例外狀況。 如果設定為 false 且群組不存在,則動作會報告成功,但輸出會報告未刪除任何群組。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已刪除的群組數目
NumberOfGroupsDeleted integer

此輸出將保留已刪除的AD組數,該數應為0或1。

移除 Active Directory 群組成員

從 Active Directory 群組中移除 Active Directory 成員 (使用者、群組或電腦)。

參數

名稱 機碼 必要 類型 Description
群組身分
GroupIdentity string

Active Directory 群組的身分識別。 您可以依識別名稱 (例如 CN=Group1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'Group1') 來指定群組。 您不能使用顯示名稱或群組名稱(儘管群組名稱通常與可以使用的 2K 之前名稱相同)。

群組名稱
GroupName string

作為依身分識別搜尋的替代方案,請提供 Active Directory 群組的 2K 之前名稱 (SAMAccountName)。 由於「群組身分」輸入也接受 2K 之前的名稱,因此此輸入現在是多餘的,但為了回溯相容性而保留。

群組成員
UserIdentity True string

要移除的群組成員。 您可以依識別名稱 (例如 CN=User1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'User1') 來指定使用者或群組。 您可以依識別名稱或電腦名稱 (2K 之前) 後面接著 $ (例如 VM01$) 來指定電腦。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectoryRemoveADGroupMemberByGroupIdentityResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

移除 Azure AD 使用者

移除 Azure Active Directory 使用者。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
ObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

使用者不存在時的例外狀況
ErrorIfUserDoesNotExist boolean

如果使用者不存在,是否應該發生例外狀況? 設定為 false ,如果使用者不存在(例如,它可能已被刪除),則什麼都不做。 如果使用者不存在是錯誤 (即預期存在) ,則設定為 true。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
使用者存在
UserExisted boolean

如果使用者存在且已刪除,則會設定為 true。 如果使用者不存在 (且「使用者不存在則發生錯誤」已設定為 false,因此不會引發例外狀況),則會設定為 false ,以通知您使用者不存在,因此 IA-Connect 不需要執行任何動作。

移除 Azure AD 安全性或 Microsoft 365 群組

移除 Azure Active Directory 安全性群組或 Microsoft 365 群組。 此動作無法移除已啟用郵件的安全性群組或通訊群組清單:請改用 [移除 Office 365 通訊群組] 動作。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
群組物件識別碼或顯示名稱
GroupObjectId True string

Azure Active Directory 群組的識別碼或顯示名稱。 您可以依顯示名稱 (例如「財務使用者」) 或 ObjectId (例如 UUID/GUID 值) 指定群組。

群組不存在時的例外狀況
ErrorIfGroupDoesNotExist boolean

如果群組不存在,是否應該發生例外狀況? 設定為 false,如果群組不存在(例如,它可能已被刪除),則什麼都不做。 如果群組不存在是錯誤 (也就是預期存在) ,則設為 true。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
存在的群組
GroupExisted boolean

如果群組存在且已刪除,則會設定為 true。 如果群組不存在 (且「群組不存在時發生錯誤」已設定為 false,因此不會引發例外狀況),則會設定為 false ,以通知您群組不存在,因此 IA-Connect 不需要執行任何動作。

移除 Microsoft Exchange 通訊群組

移除 Microsoft Exchange 通訊群組。

參數

名稱 機碼 必要 類型 Description
通訊群組身分識別
Identity True string

通訊群組的身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=MyGroup、OU=My Groups、DC=mydomain、DC=local)、電子郵件地址或 GUID 來指定通訊群組。

略過安全性群組管理員檢查
BypassSecurityGroupManagerCheck boolean

根據預設,如果 IA-Connect 代理程式自動化帳戶不是通訊群組的擁有者,則無法移除通訊群組。 或者,您可以將此選項設定為 true,這會移除該檢查,但它需要自動化帳戶位於 Exchange 的「組織管理」角色群組中,或指派「角色管理」角色 - 這是單一角色,可讓您修改任何 Exchange 通訊群組的許可權,而不是成為您需要修改之所有通訊群組的擁有者。

群組不存在時的例外狀況
ErrorIfGroupDoesNotExist boolean

如果群組不存在,是否應該發生例外狀況? 設定為 false,如果群組不存在(例如,它可能已被刪除),則什麼都不做。 如果群組不存在是錯誤 (也就是預期存在) ,則設為 true。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ExchangeRemoveDistributionGroupResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

移除 Office 365 通訊群組

移除 Microsoft Exchange Online 或 Office 365 通訊群組或已啟用郵件的安全性群組。

參數

名稱 機碼 必要 類型 Description
通訊群組身分識別
Identity True string

要移除的通訊群組或已啟用郵件的安全性群組身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=MyGroup、OU=My Groups、DC=mydomain、DC=local)、電子郵件地址或 GUID 來指定通訊群組。

略過安全性群組管理員檢查
BypassSecurityGroupManagerCheck boolean

如果 IA-Connect 代理程式自動化帳戶不是通訊群組或已啟用郵件的安全性群組的擁有者,則無法移除群組。 如果您將此選項設定為 true (預設值) ,將會略過擁有者檢查,但它需要自動化帳戶位於 Exchange的「組織管理」角色群組中,或指派「角色管理」角色 - 這是單一角色,可讓您修改任何 Office 355 Exchange Online 群組的權限,而不是成為您需要修改之所有群組的擁有者。

群組不存在時的例外狀況
ErrorIfGroupDoesNotExist boolean

如果群組不存在,是否應該發生例外狀況? 設定為 false,如果群組不存在(例如,它可能已被刪除),則什麼都不做。 如果群組不存在是錯誤 (也就是預期存在) ,則設為 true。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
O365RemoveDistributionGroupResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

移除使用者的 Microsoft Exchange 信箱權限

從指定的信箱使用者、使用者或安全性群組移除信箱許可權。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange 信箱的身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

User
User True string

要從信箱中移除權限的使用者。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定使用者。

存取權限
AccessRights True string

要從使用者對信箱的許可權中移除的存取權限。 可用選項包括 'ChangeOwner'、'ChangePermission'、'DeleteItem'、'ExternalAccount'、'FullAccess' 和 'ReadPermission'。 若要移除多個權限,請將它們指定為逗號分隔的清單。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ExchangeRemoveMailboxPermissionResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

移除使用者的 Office 365 信箱權限

從指定的信箱使用者、使用者或安全性群組移除 Microsoft Exchange Online 或 Office 365 信箱許可權。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange Online 或 Office 365 信箱的識別碼。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

User
User True string

要從信箱許可權中移除的信箱使用者、使用者或已啟用郵件的安全性群組。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

存取權限
AccessRights True string

要從使用者對信箱的許可權中移除的存取權限。 可用選項包括 'ChangeOwner'、'ChangePermission'、'DeleteItem'、'ExternalAccount'、'FullAccess' 和 'ReadPermission'。 若要移除多個權限,請將它們指定為逗號分隔的清單。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
O365RemoveMailboxPermissionResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

移除多個 Active Directory 群組成員

從現有的 Active Directory 群組中移除一或多個 Active Directory 物件 (通常是使用者、群組或電腦)。 IA-Connect 從群組中移除盡可能多的成員,並報告結果。 如果群組和群組成員位於不同的網域中,則需要為群組和成員指定識別名稱 (DN)。 如果某些物件不是群組的成員,則會算作成功。

參數

名稱 機碼 必要 類型 Description
群組身分
GroupIdentity string

Active Directory 群組的身分識別。 您可以依識別名稱 (例如 CN=Group1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'Group1') 來指定群組。 您不能使用顯示名稱或群組名稱(儘管群組名稱通常與可以使用的 2K 之前名稱相同)。

群組成員
GroupMembersJSON string

要從 AD 群組中移除的成員 (通常是使用者、群組或電腦) 清單,採用 JSON 或 CSV 格式。 例如:[{“MemberName”: “User 1”}、{“MemberName”: “User 2”}] (JSON 表格格式)、 [“User 1”、“User 2”] (JSON 陣列格式) 或 User 1,User 2 (CSV 格式)。 您可以依識別名稱 (例如 CN=User1、OU=My Groups、DC=mydomain、DC=local)、GUID、SID 或 SAMAccountName/pre-2K 名稱 (例如 'User1') 來指定使用者或群組。 您可以依識別名稱或電腦名稱 (2K 之前) 後面接著 $ (例如 VM01$) 來指定電腦。

如果任何成員無法移除,則會發生例外狀況
ExceptionIfAnyMembersFailToRemove boolean

如果設定為 true:如果任何單一成員無法移除,則會引發例外狀況 (失敗) (即 100% 成功是必要條件)。 如果未引發例外狀況,此動作會報告成功移除的成員數目,以及移除失敗的成員數目。

如果所有成員都無法移除,則會發生例外狀況
ExceptionIfAllMembersFailToRemove boolean

如果設定為 true:只有在所有成員都無法移除 (即沒有成功且部分失敗) 時,才會引發例外狀況 (失敗) 。 如果未引發例外狀況,此動作會報告成功移除的成員數目,以及移除失敗的成員數目。

在一次通話中移除所有成員
RemoveAllMembersInASingleCall boolean

如果設定為 true,則會在單一動作中從群組中移除所有成員。 這會更快,但如果單一成員不存在或無法移除,則不會移除任何成員,並且無論「例外」輸入選項為何,都會引發例外。 如果設定為 false (預設值),則會個別移除每個成員,且 IA-Connect 代理程式會計算成功移除的數目,以及移除失敗的數目。 如果從跨網域的群組中移除成員,建議將此輸入設定為 false。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已成功移除 AD 群組成員
ADGroupMembersRemovedSuccessfully integer

成功從 AD 群組中移除的成員數目。

AD 群組成員無法移除
ADGroupMembersFailedToRemove integer

無法從 AD 群組中移除的成員數目。

移除 AD 群組成員錯誤訊息
RemoveADGroupMembersMasterErrorMessage string

如果某些成員無法從 AD 群組中移除,且未引發例外狀況,則此錯誤訊息會提供問題的詳細資料。

移除所有 Azure AD 使用者授權

移除指派給使用者的所有 Azure AD 使用者授權 (SKU)。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
ObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
AzureADv2RemoveAllAzureADUserLicenseResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

等候 Office 365 信箱

等候指定的 Microsoft Exchange Online 或 Office 365 信箱存在。 如果您正在等待 AD 同步或授權設定生效,這很常見。 如果信箱已經存在,動作會立即傳回成功。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange Online 或 Office 365 信箱的識別碼。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

收件者類型詳細資料
RecipientTypeDetails string

要搜尋的信箱類型。 如果此欄位留空,則搜尋中將包含所有類型的信箱。

檢查次數
NumberOfTimesToCheck True integer

檢查信箱是否存在的次數。 每個檢查都以可配置的時間量分隔。

嘗試之間的秒數
SecondsBetweenTries True integer

每次檢查之間要等待多少秒。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
搜尋結果JSON
PowerShellJSONOutput string

所定位信箱的屬性 (如果它已經存在或等待之後存在) ,以 JSON 格式。

找到的信箱計數
CountOfMailboxesFound integer

找到符合搜尋身分的信箱數目。 1 代表等候成功 (或信箱已存在) 。 0 會代表信箱不存在,即使等待之後也是如此。

複製 Active Directory 使用者屬性

將來源 Active Directory 使用者的指定屬性/屬性設定為目的地 Active Directory 使用者。

參數

名稱 機碼 必要 類型 Description
來源使用者身分識別
SourceUserIdentity True string

來源 Active Directory 使用者的身分識別 (要從中複製屬性的使用者)。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

目的地使用者身分識別
DestinationUserIdentity True string

目的地 Active Directory 使用者的身分識別 (要複製屬性的使用者)。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

要複製的屬性
PropertiesToClone True string

以逗點分隔的使用者屬性清單,可從來源使用者複製到目的地使用者。 要複製的常見屬性包括:city、company、country、department、description、division、enabled、homedirectory、homedrive、homephone、manager、office、organization、postalcode、profilepath、scriptpath、state、streetaddress。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectoryCloneADUserPropertiesResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

複製 Active Directory 使用者群組成員資格

將目的地 Active Directory 使用者新增至第一個使用者所屬的相同 Active Directory 群組,減去主要群組 (通常是「網域使用者」),因為技術上它不是成員資格。

參數

名稱 機碼 必要 類型 Description
來源使用者身分識別
SourceUserIdentity True string

來源 Active Directory 使用者的身分識別 (要從中複製群組的使用者)。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

目的地使用者身分識別
DestinationUserIdentity True string

目的地 Active Directory 使用者的身分識別 (要新增群組的使用者)。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
AD組已成功添加
ADGroupsAddedSuccessfully integer

目的地使用者成功新增至的 AD 群組數目。

AD 群組無法新增
ADGroupsFailedToAdd integer

目的地使用者無法新增至的 AD 群組數目。

新增 AD 群組錯誤訊息
AddADGroupsMasterErrorMessage string

如果目的地使用者無法新增至某些 AD 群組,則此錯誤訊息會提供問題的詳細資料。

解除鎖定 Active Directory 帳戶

解除鎖定 Active Directory 帳戶。 如果帳戶未鎖定,則此命令不會執行任何動作。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity True string

Active Directory 使用者的身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectoryUnlockADAccountByIdentityResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

設定 Active Directory 伺服器

設定要用於所有進一步 Active Directory 動作的特定 Active Directory 伺服器。

參數

名稱 機碼 必要 類型 Description
預先定義的 AD 伺服器選擇
PredefinedADServerChoice string

使用者 PDC:將使用目前登入使用者所屬網域的 PDC 模擬器。 電腦 PDC:將會使用電腦所屬網域的 PDC 模擬器 (執行 IA-Connect 會話) 。 手動:在「AD 伺服器」欄位中輸入 Active Directory 網域控制站 (DC)。 如果此欄位為空白且「AD 伺服器」欄位具有值,則會使用該值。

AD 伺服器
ADServer string

只有在「預先定義的 AD 伺服器選擇」設定為「手動」(或空白)時,才會使用此欄位。 Active Directory 網域控制站 (DC) 的名稱或完整網域名稱 (FQDN) ,以連絡所有進一步的 Active Directory 動作。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectorySetADServerResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

設定 Active Directory 使用者免於意外刪除

將 Active Directory 帳戶設定為保護 (或不受保護) 以防止意外刪除。 如果您保護帳戶免遭意外刪除,則在移除保護之前,您無法刪除該帳戶。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity True string

Active Directory 使用者的身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

防止意外刪除
ProtectedFromAccidentalDeletion True boolean

設定為 true 可保護使用者免於意外刪除。 設定為 false 以移除意外刪除的保護。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectorySetADUserProtectedFromAccidentalDeletionByIdentityResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

設定 Active Directory 使用者帳戶到期日期結束日期

設定 Active Directory 使用者帳戶的帳戶到期結束日期。 這是帳戶可用的最後一整天,因此從技術上講,該帳戶會在第二天開始時到期。 IA-Connect 代理程式會察覺到這一點,並在將日期儲存在 Active Directory 中時自動將 1 天新增至提供的輸入日期。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity True string

Active Directory 使用者的身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

Year True integer

帳戶到期的年份。 例如:2023年。

Month True integer

帳戶應到期的月份數。 1 月 = 1,12 月 = 12。 例如:6。

Day
Day True integer

帳戶到期的日期數字。 當月的第一天 = 1。 例如:19。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectorySetADUserAccountExpirationEndOfDateResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

設定 Azure AD 使用者授權

新增或移除 Azure AD 使用者授權 (SKU)。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
ObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

要添加的許可證
LicenseToAdd string

要新增的單一 Azure AD 授權 SKU。 這可以輸入為 SKU 識別碼 (GUID) 或 SKU 零件編號 (單字)。 例如:TEAMS_EXPLORATORY。 如果您想要啟用多個授權,請為每個授權呼叫此動作一次。

要新增的授權計劃
LicensePlansChoice string

某些授權有計劃:如果您想要啟用所有計劃(或不知道),請選擇「全部」。 如果您只想啟用某些具名計劃,請選擇“選擇加入”,然後在“許可證計劃 CSV”字段中輸入要啟用的計劃。 如果您希望啟用除您指定的計劃之外的所有計劃,請選擇“選擇退出”,然後在“許可證計劃 CSV”字段中輸入要禁用的計劃。

授權方案
LicensePlansCSV string

授權計劃 (授權的元件) 的逗號分隔清單 (CSV) ,以啟用或停用。 如果您將此欄位保留空白,則會啟用所有授權方案。 這可以輸入為 SKU 識別碼 (GUID) 或 SKU 零件編號 (單字)。 例如:YAMMER_ENTERPRISE,SHAREPOINTSTANDARD。

要移除的授權
LicensesToRemoveCSV string

要移除的 Azure AD 授權 SKU 的逗號分隔清單。 這可以輸入為 SKU 識別碼 (GUID) 或 SKU 零件編號 (單字) 的逗號分隔清單。 例如:TEAMS_EXPLORATORY,FLOW_FREE。

使用位置
UsageLocation string

兩個字母的國家代碼 (ISO 3166)。 對於因法律要求而獲指派授權的使用者所必需。 例如:美國 (美國)、日本 (日本)、GB (英國)、法國 (法國)、印度 (印度)。 請參閱 https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes。 如果您未設定此值,使用者必須已設定其使用位置,否則授權將無法套用。

PowerShell 本機範圍
LocalScope boolean

基礎 Azure AD v2 PowerShell 命令是否應該在本機範圍內執行。 根據預設,此不會設定,因此 PowerShell 會回復為預設值。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
AzureADv2SetAzureADUserLicenseResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

設定 Azure AD 使用者的管理員

設定 Azure Active Directory 使用者的管理員。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
ObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

經理
Manager string

若要新增管理員,請指定使用者的管理員物件識別碼 (例如 UUID/GUID 值) 或 UPN (例如 myboss@mydomain.com)。 若要移除使用者的管理員,請將此欄位設為空白。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
AzureADv2SetAzureADUserManagerResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

設定 Exchange 信箱代表傳送

指定誰可以代表此現有信箱傳送。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange 信箱的身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

授予代表傳送至
GrantSendOnBehalfTo True string

可以代表此信箱傳送電子郵件的使用者、群組或信箱的識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定使用者。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ExchangeSetMailboxSendOnBehalfOfPermissionResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

設定 Microsoft Exchange Online 信箱上的屬性

設定現有 Microsoft Exchange Online 或 Office 365 (遠端) 信箱的屬性。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange Online 或 Office 365 (遠端) 信箱的身分識別。 您可以依 Active Directory 物件識別碼、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、DOMAIN\username、電子郵件地址、GUID 或使用者主體名稱 (UPN) 來指定 Microsoft Exchange Online 或 Office 365 (遠端) 信箱。

Alias
Alias string

使用者的 Exchange 別名 (也稱為郵件暱稱)。 如果已啟用電子郵件地址原則,則會用來產生主要SMTP電子郵件地址的名稱元件(例如)。 alias@mydomain.com 如果未啟用電子郵件地址原則,您可能希望改為設定主要 SMTP 位址。 如果您不想變更目前值,請保留空白。

顯示名稱
DisplayName string

信箱的顯示名稱。 這在地址列表中可見。 如果您不想變更目前值,請保留空白。

主要 SMTP 位址
PrimarySmtpAddress string

用於收件者的主要回信電子郵件地址。 如果啟用「電子郵件地址原則」,您不太可能設定此設定,因此請改用「別名」(原則會從別名建立主要 SMTP 位址),或停用電子郵件地址原則。 如果您不想變更目前值,請保留空白。

信箱類型
Type string

信箱的類型。 如果您不想變更目前值,請保留空白。

從通訊清單中隱藏
HiddenFromAddressListsEnabled boolean

設定為 true 可從通訊清單中隱藏信箱,設定為 false 可在通訊清單中顯示信箱,或不指定值以保持目前設定不變。

自訂屬性 1
CustomAttribute1 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 2
CustomAttribute2 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 3
CustomAttribute3 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 4
CustomAttribute4 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 5
CustomAttribute5 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 6
CustomAttribute6 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 7
CustomAttribute7 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 8
CustomAttribute8 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 9
CustomAttribute9 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 10
CustomAttribute10 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 11
CustomAttribute11 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 12
CustomAttribute12 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 13
CustomAttribute13 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 14
CustomAttribute14 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 15
CustomAttribute15 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

已啟用電子郵件地址原則
EmailAddressPolicyEnabled boolean

如果您想要根據套用至此收件者的電子郵件地址原則自動更新電子郵件地址,請設定為 true。 如果啟用電子郵件地址原則,這通常會影響您設定主要 SMTP 位址的能力。 設定為 false 可停用該功能,讓您完全控制手動設定電子郵件地址。 如果您不想設定此選項,請保留空白(即保留現有值或預設值)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ExchangeSetRemoteMailboxResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

設定 Microsoft Exchange 信箱上的屬性

設定現有 Microsoft Exchange 信箱的屬性。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange 信箱的身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

帳戶已停用
AccountDisabled boolean

如果您想要停用帳戶,請設定為 true,如果要啟用帳戶,請設定為 false,或未指定值以保持目前設定不變。

Alias
Alias string

使用者的 Exchange 別名 (也稱為郵件暱稱)。 如果已啟用電子郵件地址原則,則會用來產生主要SMTP電子郵件地址的名稱元件(例如)。 alias@mydomain.com 如果未啟用電子郵件地址原則,您可能希望改為設定主要 SMTP 位址。 如果您不想變更目前值,請保留空白。

顯示名稱
DisplayName string

信箱的顯示名稱。 這在地址列表中可見。

主要 SMTP 位址
PrimarySmtpAddress string

用於收件者的主要回信電子郵件地址。 如果啟用「電子郵件地址原則」,您不太可能設定此設定,因此請改用「別名」(原則會從別名建立主要 SMTP 位址),或停用電子郵件地址原則。 如果您不想變更目前值,請保留空白。

從通訊清單中隱藏
HiddenFromAddressListsEnabled boolean

設定為 true 可從通訊清單中隱藏信箱,設定為 false 可在通訊清單中顯示信箱,或不指定值以保持目前設定不變。

自訂屬性 1
CustomAttribute1 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 2
CustomAttribute2 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 3
CustomAttribute3 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 4
CustomAttribute4 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 5
CustomAttribute5 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 6
CustomAttribute6 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 7
CustomAttribute7 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 8
CustomAttribute8 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 9
CustomAttribute9 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 10
CustomAttribute10 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 11
CustomAttribute11 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 12
CustomAttribute12 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 13
CustomAttribute13 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 14
CustomAttribute14 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

自訂屬性 15
CustomAttribute15 string

自訂屬性欄位的值。 如果您不想指定值,請保留空白。 如果您想將值設定為空白(即它已經有一個值並且您想要重置它),請使用「重置」操作。

已啟用電子郵件地址原則
EmailAddressPolicyEnabled boolean

如果您想要根據套用至此收件者的電子郵件地址原則自動更新電子郵件地址,請設定為 true。 如果啟用電子郵件地址原則,這通常會影響您設定主要 SMTP 位址的能力。 設定為 false 可停用該功能,讓您完全控制手動設定電子郵件地址。 如果您不想設定此選項,請保留空白(即保留現有值或預設值)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ExchangeSetMailboxResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

設定 Microsoft Exchange 信箱的自動回覆 (不在辦公室)

設定 Microsoft Exchange 信箱的自動回覆 (不在辦公室)。 此動作不適用於 Microsoft Exchange Online 或 Office 365 中的遠端信箱:請改用動作 [設定 Office 365 信箱的自動回覆 (不在辦公室) ]。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange 信箱的身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

自動回覆狀態
AutoReplyState True string

允許您啟用或禁用自動回复。

內部訊息
InternalMessage string

要傳送給內部寄件者的自動回覆 (不在辦公室) 訊息。 設定為空白以移除訊息。

外部對象
ExternalAudience string

可讓您指定是否要將自動回覆傳送給外部對象。 依預設,回覆會傳送給所有外部寄件者。

對外訊息
ExternalMessage string

如果外部對象設定為「全部」或「已知」,則要傳送給外部寄件者的自動回覆 (不在辦公室) 訊息。 設定為空白以移除訊息。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ExchangeSetMailboxAutoReplyConfigurationResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

設定 Office 365 信箱的屬性

設定 Microsoft Exchange Online 或 Office 365 信箱上的屬性。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange Online 或 Office 365 信箱的識別碼。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

帳戶已停用
AccountDisabled boolean

如果您想要停用帳戶,請設定為 true,如果要啟用帳戶,請設定為 false,或未指定值以保持目前設定不變。

Alias
Alias string

使用者的 Exchange 別名 (也稱為郵件暱稱)。

顯示名稱
DisplayName string

信箱的顯示名稱。 這在地址列表中可見。

從通訊清單中隱藏
HiddenFromAddressListsEnabled boolean

設定為 true 可從通訊清單中隱藏信箱,設定為 false 可在通訊清單中顯示信箱,或不指定值以保持目前設定不變。

自訂屬性 1
CustomAttribute1 string

自訂屬性 1 欄位的值。

自訂屬性 2
CustomAttribute2 string

自訂屬性 2 欄位的值。

自訂屬性 3
CustomAttribute3 string

自訂屬性 3 欄位的值。

自訂屬性 4
CustomAttribute4 string

自訂屬性 4 欄位的值。

信箱類型
Type string

信箱的類型。 如果您不想變更目前值,請保留空白。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
O365SetO365MailboxResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

設定 Office 365 信箱的自動回覆 (不在辦公室)

設定 Microsoft Exchange Online 或 Office 365 信箱的自動回覆 (不在辦公室)。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange Online 或 Office 365 信箱的識別碼。 您可以依名稱、別名、物件識別碼 (例如 UUID/GUID 值)、電子郵件地址、GUID、SAMAccountName (即使非 Active Directory 連線環境中的使用者也有 SAMAccountName) 或使用者主體名稱 (UPN) 來指定信箱。

自動回覆狀態
AutoReplyState True string

允許您啟用或禁用自動回复。

內部訊息
InternalMessage string

要傳送給內部寄件者的自動回覆 (不在辦公室) 訊息。 設定為空白以移除訊息。

外部對象
ExternalAudience string

可讓您指定是否要將自動回覆傳送給外部對象。 依預設,回覆會傳送給所有外部寄件者。

對外訊息
ExternalMessage string

如果外部對象設定為「全部」或「已知」,則要傳送給外部寄件者的自動回覆 (不在辦公室) 訊息。 設定為空白以移除訊息。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
O365SetO365MailboxAutoReplyConfigurationResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

連線到 Microsoft Exchange

將 IA-Connect 連線到Microsoft Exchange 伺服器。 在執行任何其他 Exchange 動作之前,必須先發出此動作。 如果您指定使用者名稱和密碼,則所有後續的 Exchange 動作都會以該帳戶執行。 如果您未指定使用者名稱和密碼,則所有後續的 Exchange 動作都會以 IA-Connect 代理程式執行時所用的使用者帳戶身分執行。

參數

名稱 機碼 必要 類型 Description
用戶名稱
Username string

執行 Exchange PowerShell 命令時要使用的帳戶使用者名稱。 您可以指定 'DOMAIN\username' (例如 TESTDOMAIN\admin) 或 'username@domainFQDN' (例如 admin@testdomain.local) 格式的使用者名稱。 如果您未指定使用者名稱和密碼,則所有後續的 Exchange 動作都會以 IA-Connect 代理程式執行時所用的使用者帳戶身分執行。

密碼
Password password

執行 Exchange PowerShell 命令時要使用的帳戶密碼。

Exchange 伺服器 FQDN
ExchangeServerFQDN True string

Microsoft Exchange 伺服器的完整網域名稱 (FQDN) 或主機名稱。

使用 SSL
UseSSL boolean

如果您希望使用 HTTPS/SSL 連接到 Microsoft Exchange 伺服器,請設定為 true。 這將加密所有流量,但只有在 Exchange 伺服器設定為透過 SSL 接受 PowerShell 命令時才有效。

連線方式
ConnectionMethod string

應該使用哪種方法來連線到 Microsoft Exchange。 'Local' 會在本機匯入遠端 Exchange 執行空間,並在本機執行命令。 'Remote' 直接在遠端 Exchange 執行空間中執行,而且由於安全性限制,可能無法執行一般 PowerShell 腳本。

驗證機制
AuthenticationMechanism string

連線到遠端電腦或以替代使用者身分執行腳本時要使用的驗證機制。 支援的值為 'Basic'、'Credssp'、'Default'、'Digest'、'Kerberos' 和 'Negotiate'。

僅在尚未連接的情況下才連接
OnlyConnectIfNotAlreadyConnected boolean

如果設定為 false:此動作一律會連線到 Exchange,即使 IA-Connect 已連線。 如果設定為 true (預設值):如果 IA-Connect 已連線到具有相同設定的 Exchange,且 Exchange 連線正在回應,則 IA-Connect 將不會執行任何動作,因為連線已建立。

要在本機匯入的命令類型
CommandTypesToImportLocally string

「本機」連線方法會在本機匯入 Exchange PowerShell 命令。 此選項可讓您選擇應匯入哪些 PowerShell 命令。 將此清單保持在最低限度可減少記憶體使用量和連線時間。 'All'(默認值,為了向後兼容)導入所有 PS 命令。 'IA-Connect only' (建議的選項) 只會匯入 IA-Connect 使用的 PS 指令 (您可以指定其他 PS 指令)。 '指定' 只會匯入您指定的 PS 命令,如果它們依賴於您未指定的 PS 命令,則可能會中斷某些 IA-Connect 操作。

要在本機匯入的其他命令
AdditionalCommandsToImportLocallyCSV string

如果使用「本機」連線方法,且您選擇匯入「僅IA-Connect」或「指定」PS 命令,您可以指定要匯入的其他 PS 命令的逗號分隔清單。 例如:「Get-Mailbox,New-Mailbox,New-DistributionGroup」。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
OpenExchangePowerShellRunspaceResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

連線到預設的 Active Directory 網域

使用 IA-Connect Agent 執行時所用的帳戶 (即預設行為),將 IA-Connect Agent 連線到執行 IA-Connect Agent 的電腦所屬的網域。

參數

名稱 機碼 必要 類型 Description
Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
OpenLocalPassthroughActiveDirectoryPowerShellRunspaceResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

連線至 JML 環境

連線至 JML 環境,其中該環境的詳細資料保存在 IA-Connect Orchestrator 中。 這些詳細資料可以包括認證、位址和其他連線設定。 例如,您可以使用此動作連線到 Active Directory、Microsoft Exchange、Azure AD 或 Office 365 Exchange Online。

參數

名稱 機碼 必要 類型 Description
友善名稱
FriendlyName string

IA-Connect Orchestrator 中保留的 JML 環境易記名稱。

僅在尚未連接的情況下才連接
OnlyConnectIfNotAlreadyConnected boolean

僅適用於 Exchange 和 Office 365 Exchange Online。 如果設定為 false:此動作一律會連線到 Exchange 或 Office 365 Exchange Online,即使 IA-Connect 已連線也一樣。 如果設定為 true (預設值):如果 IA-Connect 已連線到 Exchange 或 Office 365 Exchange Online,且 Exchange 連線正在回應,則 IA-Connect 不會執行任何動作,因為連線已建立。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
JMLConnectToJMLEnvironmentResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

重設 Active Directory 使用者密碼

使用新密碼重設 Active Directory 使用者的密碼,並選擇性地設定密碼屬性。

參數

名稱 機碼 必要 類型 Description
使用者身分識別
UserIdentity True string

Active Directory 使用者的身分識別。 您可以依識別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、GUID、SID、SAMAccountName / pre-2K 名稱 (例如 'User1') 或名稱 (例如 'User1') 來指定使用者。

新密碼
NewPassword True password

新密碼。 必須指定此值,並符合 Active Directory 密碼複雜度規則。 如果這是「儲存」密碼,請輸入 {IAConnectPassword:StoredPasswordIdentifier} 格式,並將「儲存密碼」輸入設定為 true。 如果這是 Orchestrator 一般認證,請輸入 {OrchestratorCredential:FriendlyName} 格式,並將「儲存的密碼」輸入設定為 true。

帳號密碼為儲存密碼
AccountPasswordIsStoredPassword boolean

如果密碼是 IA-Connect 儲存的密碼識別碼 (例如:由「產生密碼」動作產生) 或 IA-Connect Orchestrator 一般認證 (例如:如果將 IA-Connect 與 PA 流程搭配使用),則設定為 true。

設定使用者密碼屬性
SetUserPasswordProperties boolean

如果您除了變更密碼之外,還想設定指定的使用者密碼屬性,請設定為 [是] (預設值)。 使用者密碼屬性為「登入時變更密碼」、「使用者無法變更密碼」和「密碼永不過期」。 設定為 [否] 以僅變更使用者的密碼,而忽略此動作的其他輸入。

用戶必須在下次登入時變更密碼
ChangePasswordAtLogon boolean

如果您想要強制使用者在登入時變更其密碼,請設定為 [是] (預設值) (也就是說,此處設定的新密碼是讓使用者登入的一次性密碼)。 如果這是使用者在手動變更之前將使用的密碼,請設定為「否」。 設定為空白/空白可保持此密碼選項不變(IA-Connect 9.4 中的新功能)。 您不能將此選項設定為「是」,同時將「使用者無法變更密碼」或「密碼永不過期」設定為「是」。

用戶無法變更密碼
CannotChangePassword boolean

設定為 [是] 以阻止使用者變更其密碼。 如果使用者可以變更密碼,請設定為 No (預設值)。 設定為空白/空白可保持此密碼選項不變(IA-Connect 9.4 中的新功能)。 您不能將此選項設定為「是」,同時將「使用者下次登入時必須變更密碼」設定為「是」。

密碼永不過期
PasswordNeverExpires boolean

如果密碼永遠不會過期,則設定為 [是] (也就是永遠不會提示使用者變更密碼)。 如果密碼可以過期,請設定為 [否] (預設值) Active Directory 網域原則中所設定的密碼。 設定為空白/空白可保持此密碼選項不變(IA-Connect 9.4 中的新功能)。 您不能將此選項設定為「是」,同時將「使用者下次登入時必須變更密碼」設定為「是」。

重設密碼兩次
ResetPasswordTwice boolean

設定為「是」可重設密碼兩次,第一次重設是隨機化所要求的新密碼(相同數量的大寫、小寫、數字和相同符號,但順序隨機)。 如果您要將此使用者同步處理至 Azure Active Directory,這可降低傳遞雜湊弱點的風險。 設定為否 (預設值) 以設定要求的密碼,而不先設定隨機密碼。

AD 伺服器
ADServer string

要聯絡以執行要求動作的 Active Directory 網域控制站 (DC) 的選擇性名稱或完整網域名稱 (FQDN)。 如果留空,則會使用網站設定自動判斷 Active Directory 網域控制站 (DC)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ActiveDirectoryResetADUserPasswordByIdentityResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

重設 Azure AD 使用者密碼

使用新密碼重設 Azure Active Directory 使用者的密碼。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者主體名稱
UserPrincipalName True string

Azure Active Directory 中的使用者登入名稱。 這通常應該採用 'name@domainFQDN' 格式(例如 'TestUser1@mydomain.onmicrosoft.com')。

新密碼
NewPassword True password

新密碼。 必須指定此值,並符合 Azure Active Directory 密碼複雜度規則。 如果這是「儲存」密碼,請輸入 {IAConnectPassword:StoredPasswordIdentifier} 格式,並將「儲存密碼」輸入設定為 true。 如果這是 Orchestrator 一般認證,請輸入 {OrchestratorCredential:FriendlyName} 格式,並將「儲存的密碼」輸入設定為 true。

帳號密碼為儲存密碼
AccountPasswordIsStoredPassword boolean

如果密碼是 IA-Connect 儲存的密碼識別碼 (例如:由「產生密碼」動作產生) 或 IA-Connect Orchestrator 一般認證 (例如:如果將 IA-Connect 與 PA 流程搭配使用),則設定為 true。

下次登入時強制更改密碼
ForceChangePasswordNextLogin boolean

如果您想要強制使用者下次登入時變更密碼,請設定為 true (也就是說,此處設定的新密碼是允許使用者登入的一次性密碼)。 如果這是使用者將使用的密碼,則設定為 false,直到他們手動變更為止。

強制執行變更密碼原則
EnforceChangePasswordPolicy boolean

設定為 true 可強制執行 Azure Active Directory 變更密碼原則,該原則 (視您的環境而定) 可定義使用者變更其密碼、密碼復原選項和其他安全性驗證的頻率。 這可能會導致系統提示使用者輸入其他資訊。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
AzureADv2ResetAzureADUserPasswordResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

重設 Azure AD 使用者屬性

將 Azure Active Directory 使用者的通用屬性重設為空白值。 此動作會使用 Azure AD v2 或 Microsoft Graph 使用者 PowerShell 模組,以用來連線到 Azure 為準。

參數

名稱 機碼 必要 類型 Description
使用者物件識別碼或 UPN
ObjectId True string

Azure Active Directory 使用者的識別碼。 您可以依 UPN (例如 user@mydomain.onmicrosoft.com) 或 ObjectId (例如 UUID/GUID 值) 來指定使用者。

重設名字
ResetFirstName boolean

設定為 true 可將使用者的名字重設為空白。

重設姓氏
ResetLastName boolean

設定為 true 可將使用者的姓氏/姓氏重設為空白。

重置城市
ResetCity boolean

設定為 true 可將使用者居住的城市名稱或其辦公室所在的位置重設為空白。

重設公司名稱
ResetCompanyName boolean

設定為 true 可將使用者工作的公司名稱重設為空白。

重設國家或地區
ResetCountry boolean

設定為 true 可將使用者居住的國家或地區,或其辦公室所在的位置重設為空白。

重置部門
ResetDepartment boolean

設定為 true 可將使用者在公司內工作的部門名稱重設為空白。

重設傳真號碼
ResetFaxNumber boolean

設定為 true 可將傳真 (傳真) 電話號碼重設為空白。

重設職稱
ResetJobTitle boolean

設定為 true 可將使用者的職稱重設為空白。

重置手機號碼
ResetMobilePhone boolean

設定為true,可將使用者的手機號碼重設為空白。

重置辦公室
ResetOffice boolean

設定為 true,可將使用者工作的辦公室名稱重設為空白。

重設電話號碼
ResetPhoneNumber boolean

設定為 true 可將使用者的電話號碼重設為空白。

重設郵遞區號
ResetPostalCode boolean

設定為 true,可將使用者居住的郵遞區號或郵遞區號,或他們工作的辦公室重設為空白。

重設偏好語言
ResetPreferredLanguage boolean

設定為 true 可將使用者的慣用語言重設為空白。

重設州或省
ResetState boolean

設定為 true 可將使用者居住的州、省或縣,或其辦公室所在的位置重設為空白。

重設街道地址
ResetStreetAddress boolean

設定為 true 可將使用者居住的街道地址重設為空白,或將其辦公室街道地址重設為空白。

重設使用位置
ResetUsageLocation boolean

設定為 true 可將使用位置重設為空白。 對於因法律要求而獲指派授權的使用者,這是必要的,因此重設為空白可能會中斷問題。

重設年齡群組
ResetAgeGroup boolean

設定為 true 可將使用者的年齡群組 (出於家長控制目的) 重設為空白。

為未成年人重置同意
ResetConsentProvidedForMinor boolean

設定為 true,可將是否已為未成年人提供同意 (出於家長監護目的) 重設為空白。

重設員工識別碼
ResetEmployeeId boolean

設定為 true 可將員工識別碼重設為空白。 您可以使用此功能來區分組織中的每個使用者。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
AzureADv2ResetAzureADUserPropertiesResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

重設 Microsoft Exchange Online 信箱上的屬性

將現有 Microsoft Exchange Online 或 Office 365 (遠端) 信箱的指定屬性設定為空白。 要求會透過內部部署 Microsoft Exchange 伺服器傳送,必須針對混合式部署進行設定。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange Online 或 Office 365 (遠端) 信箱的身分識別。 您可以依 Active Directory 物件識別碼、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local)、DOMAIN\username、電子郵件地址、GUID 或使用者主體名稱 (UPN) 來指定 Microsoft Exchange Online 或 Office 365 (遠端) 信箱。

重設自訂屬性 1
ResetCustomAttribute1 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 2
ResetCustomAttribute2 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 3
ResetCustomAttribute3 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 4
ResetCustomAttribute4 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 5
ResetCustomAttribute5 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 6
ResetCustomAttribute6 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 7
ResetCustomAttribute7 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 8
ResetCustomAttribute8 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 9
ResetCustomAttribute9 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 10
ResetCustomAttribute10 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 11
ResetCustomAttribute11 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 12
ResetCustomAttribute12 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 13
ResetCustomAttribute13 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 14
ResetCustomAttribute14 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重置自訂屬性 15
ResetCustomAttribute15 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ExchangeResetRemoteMailboxAttributesResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。

重設 Microsoft Exchange 信箱上的屬性

將現有 Microsoft Exchange 信箱的指定屬性設定為空白。

參數

名稱 機碼 必要 類型 Description
信箱身分識別
Identity True string

Microsoft Exchange 信箱的身分識別。 您可以依名稱、別名、辨別名稱 (例如 CN=User1、OU=My Users、DC=mydomain、DC=local) 、DOMAIN\username、電子郵件地址、GUID、SAMAccountName 或使用者主體名稱 (UPN) 來指定信箱。

重設自訂屬性 1
ResetCustomAttribute1 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 2
ResetCustomAttribute2 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 3
ResetCustomAttribute3 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 4
ResetCustomAttribute4 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 5
ResetCustomAttribute5 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 6
ResetCustomAttribute6 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 7
ResetCustomAttribute7 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 8
ResetCustomAttribute8 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 9
ResetCustomAttribute9 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 10
ResetCustomAttribute10 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 11
ResetCustomAttribute11 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 12
ResetCustomAttribute12 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 13
ResetCustomAttribute13 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重設自訂屬性 14
ResetCustomAttribute14 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

重置自訂屬性 15
ResetCustomAttribute15 boolean

如果您想要重設自訂屬性欄位 (設定為空白值),請設定為 true。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
指令結果
ExchangeResetMailboxAttributesResult boolean

命令的結果(成功或失敗)。

錯誤訊息
ErrorMessage string

如果指令不成功,則會包含傳回的錯誤訊息。