C# 使用 CDO/ADSI 在 Active Directory 建立使用者與 Exchange 信箱

前言

在企業環境中，常需透過程式自動化建立 AD 使用者帳號並啟用 Exchange 信箱。本文示範使用 CDO.PersonClass (Collaboration Data Objects) 與 CDOEXM.IMailboxStore 介面，透過 LDAP 路徑在 Active Directory 建立使用者、設定屬性、建立信箱與郵件地址的完整流程。

必要參考與命名空間

• COM 參考：Microsoft CDO for Exchange Management (CDOEXM)
• COM 參考：Active DS Type Library (ADSI)
• 命名空間：using CDO; using CDOEXM; using ADODB;

完整程式碼

public int CreateUserWithMailbox(string loginName)
{
    // 管理員認證與網域參數 (實務應從設定檔讀取)
    const string adminUser = "admin";
    const string adminPwd = "P@ssw0rd";
    const string domainName = "mycompany.com";           // DNS 網域名
    const string dcPath = "DC=mycompany,DC=com";        // LDAP 基底 DN
    const string serverName = "EXCH01";                 // Exchange 伺服器名稱

    if (string.IsNullOrEmpty(loginName)) return -1;

    try
    {
        // 1. 建立 CDO Person 物件
        PersonClass user = new PersonClass();
        user.FirstName = loginName;
        user.LastName = "";

        // 2. 設定 AD 屬性
        user.Fields["userAccountControl"].Value = 66048; // PASSWD_NOTREQD | DONT_EXPIRE_PASSWD
        user.Fields["userPrincipalName"].Value = $"{loginName}@{domainName}";
        user.Fields.Update();

        // 3. 儲存至 AD (LDAP 路徑)
        string userLdap = $"LDAP://{domainName}/CN={loginName},CN=Users,{dcPath}";
        user.DataSource.SaveTo(userLdap, null, 
            ConnectModeEnum.adModeReadWrite,
            RecordCreateOptionsEnum.adCreateOverwrite,
            RecordOpenOptionsEnum.adOpenSource,
            adminUser, adminPwd);

        // 4. 建立 Exchange 信箱
        IMailboxStore mbox = (IMailboxStore)user.GetInterface("IMailboxStore");
        string mdbUrl = $@"LDAP://{domainName}/CN=Mailbox Store ({serverName})," +
            @"CN=First Storage Group,CN=InformationStore," +
            $@"CN={serverName},CN=Servers,CN=First Administrative Group," +
            @"CN=Administrative Groups,CN=First Organization," +
            @"CN=Microsoft Exchange,CN=Services,CN=Configuration," + dcPath;

        mbox.CreateMailbox(mdbUrl);

        // 5. 設定郵件屬性
        user.Email = $"SMTP:{loginName}@{domainName}";
        user.Fields["mailNickname"].Value = $"mailnickname{loginName}";
        user.Fields.Update();
        user.DataSource.Save();

        return 1; // 成功
    }
    catch (Exception ex)
    {
        // 實務應記錄 ex.ToString() 至日誌
        System.Diagnostics.Debug.WriteLine($"CreateUser failed: {ex}");
        return -1;
    }
}

關鍵參數說明

常見錯誤與排查

現代替代方案建議

• PowerShell + Exchange Management Shell：New-Mailbox -UserPrincipalName ...，原生支援、腳本化容易。
• Microsoft Graph API / Azure AD Graph：適用於 Office 365 / Azure AD 環境，RESTful、跨平台。
• System.DirectoryServices.AccountManagement：.NET 封裝 ADSI，建立使用者更簡潔 (UserPrincipal)，但建立 Exchange 信箱仍需 CDOEXM 或 PowerShell 遠端。

安全性注意事項

• 管理員密碼嚴禁硬編碼，應使用 Windows 認證 (Kerberos/NTLM) 或安全儲存 (DPAPI、Key Vault、Secret Manager)。
• 遵循最小權限原則：服務帳號僅授予建立使用者/信箱所需的委派權限。
• 記錄稽核日誌：建立時間、操作帳號、目標 OU、成功/失敗原因。

1. 上一篇文章： C# 開發實用技巧 33 則：DataGrid、WinForms、資料庫、Excel、安裝部署完全指南
2. 下一篇文章： C# 全域鍵盤鉤子實作：使用 SetWindowsHookEx 攔截鍵盤訊息

關於C語言

C# GDI+ 繪圖進階（二）— 畫筆進階、畫刷五大類型與座標變換

畫筆進階屬性與應用 屬性說明 Color顏色 Width粗

WPF/Silverlight 遊戲開發教程（二十八之五）：傷害顯示系統與物理攻擊完結

本範例主角擁 65% 命中、18% 暴擊率。攻擊流程：命中判

趣味數學題：將正整數拆分為質數之和，使乘積最大化

問題描述 給定正整數 n，將其拆分為若干質數之和（可重複使用

C 語言字串與數值轉換函數完全手冊：atof/atoi/strtol 族與 itoa/gcvt 族詳解

字串 → 數值（標準庫） 函數原型說明備註 atofdo