Sun Java System Communications Services 6 2005Q4 Delegated Administrator 指南

指令說明

本小節提供指令行工具的說明、語法及範例。

必要的 commadmin 選項

以下是用於認證管理員或使用者的必要的選項。

選項	說明
`-D` `userid`	用於連結至目錄的使用者 ID。
`-w` `password`	用於認證目錄的使用者 ID 的密碼。也可以透過文字檔 `password.txt` 指定 `password`。
`-n` `domain`	管理員所屬的網域。

選項

說明

-D userid

用於連結至目錄的使用者 ID。

-w password

用於認證目錄的使用者 ID 的密碼。

也可以透過文字檔 password.txt 指定 password。

-n domain

管理員所屬的網域。

Access Manager 主機 (-X)、Access Manager 連接埠 (-p) 及預設網域 (-n) 值在安裝期間指定，並儲存於 cli-userprefs.properties 檔案中。

備註 –

如果 -X、-p 及 -n 選項未在執行 commadmin 指令時指定，則將從 cli-userprefs.properties 檔案中取得這些選項的值。

commadmin admin add

commadmin admin add 指令將授予特定網域的使用者組織管理員權限。只有頂層管理員或 ISP 管理員可以執行此指令。

語法

commadmin admin add -D login -l  login -n domain -w password -d domain [-h] 
[-i inputfile] [-p AM port] [-X  AM host] [-?] [-s] [-v] [-V]

選項

以下選項是必要的：

選項	說明
`-D` `login`	頂層管理員的使用者 ID。
`-l` `login`	要授予組織管理權限的使用者之使用者 ID。使用者應該存在於目錄中，且是由 `-d` 選項指定之網域的一部分。
`-n` `domain`	頂層管理員所在的網域。如果未指定，則使用 `cli-userprefs.properties` 檔案中儲存的預設網域。
`-w` `password`	頂層管理員的密碼。
`-d` `domain`	要授予其管理權限的網域。如果未指定，則使用由 `-n` 選項指定的網域。

以下選項是非必要的：

選項	說明
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-p` `AM port`	使用此選項指定 Access Manager 偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`
`-h`、`-?`	顯示指令用法語法。
`-V`	顯示有關公用程式及其版本的資訊。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-v`	啟用除錯輸出。

範例

以下指令授予使用者 ID 為 admin1 的使用者組織管理員權限。

commadmin admin add -D chris -n sesta.com -w bolton -l admin1 \
-d florizel.com

以下指令授予網域 florizel.com 中使用者 ID 為 admin2 的使用者組織管理員權限。

commadmin add admin -D chris -w bolton -l admin2 -n varrius.com \
-d florizel.com

commadmin admin remove

commadmin admin remove 指令可移除現有組織管理員的組織管理員權限。只有頂層管理員可以執行此指令。

若要移除多個使用者的組織管理員權限，請使用 -i 選項。

語法

commadmin admin remove -D login -l  login -n domain -w password -d domain name [-h] 
[-?] [-i inputfile] [-p AM port] [-X AM host] [-s] [-v] [-V]

選項

以下選項是必要的：

選項	說明
`-D` `login`	頂層管理員的使用者 ID。
`-l` `login`	需要撤銷其管理員權限的使用者之使用者 ID。
`-n` `domain`	頂層管理員所在的網域。
`-w` `password`	頂層管理員的密碼。
-d `domain name`	要撤銷其管理員權限的網域。如果未指定 `-d`，則使用由 `-n` 指定的網域。

以下選項是非必要的：

選項	說明
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-p` `AM port`	使用此選項指定 Access Manager 偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。

範例

以下指令可撤銷使用者 ID 為 admin5 的管理員的組織管理員權限：

commadmin admin remove -D chris -n sesta.com -w bolton -l admin5 -d test.com

commadmin admin search

commadmin admin search 指令搜尋並顯示網域的特定或全部組織管理員。

語法

commadmin admin search -D login -n  domain -w password [-l login] [-d domain]

選項

以下選項是必要的：

選項	說明
`-D` `login`	有權執行此指令的使用者之使用者 ID。
`-n` `domain`	使用 `-D` 選項指定的使用者所在的網域。
`-w` `password`	使用 `-D` 選項指定的使用者的密碼。

以下選項是非必要的：

選項	說明
`-l` `login`	搜尋的組織管理員的使用者 ID。如果未指定 `-l`，或使用萬用字元運算子 (`-l\\` 或 `-l ’’`) 指定 `-l`，則顯示網域的所有組織管理員。
`-d` `domain`	搜尋擁有指定網域組織管理員權限的使用者。如果未指定 `-d`，則使用由 `-n` 指定的網域。

範例

若要搜尋 test.com 網域的所有組織管理員，請執行以下指令：

commadmin admin search -D chris -n sesta.com -w bolton -d test.com

commadmin domain create

commadmin domain create 指令可在 Access Manager 上建立單一網域。若要建立多個網域，請使用 -i 選項。

語法

commadmin domain create -D login -d  domain name -n domain -w password [-A [+] 
attributename:value] [-h] [-?] [-i  inputfile] [-o organization RDN] [-p AM port] 
[-s] [-v] [-V] [-X AM host] [-S mail -H preferred mailhost] [-S cal 
[-B backend calendar data server] [-C  searchable domains] [-g access control string] 
[-P propertyname[value]] [-R  right[:value]] [-T calendar time zone string]]

選項

以下選項是必要的：

選項	說明
`-D` `login`	頂層管理員的使用者 ID。
`-d` `domain name`	將建立之網域的 DNS 網域名稱。
`-n` `domain`	頂層管理員所在的網域。
`-w` `password`	頂層管理員的密碼。

以下選項是非必要的：

選項	說明
`-A` [+ ]`attributename`:`value`	要修改的屬性。`attributename` 在 LDAP 模式中定義，指定的 `value` 將替代目錄中此屬性的任意或所有目前值。重複此選項可同時修改多個屬性，或為同一屬性指定多個值。 `attributename` 前面的「+」指示將該值增加至目前屬性清單。如果未指定動作值 (+)，則預設動作為增加現有值。
`-h、-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-o` `organization RDN`	指定網域的組織 RDN。例如，`o=varrius.florizel.com`。如果未指定此選項，則在 `osi` `suffix` 下建立組織，`o=`網域名稱為 `o=osiSuffix`。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。
`-S` `service`	指定要增加至網域的服務。 `service` 值可以為一個服務或多個服務。有效的 `service` 值為 `mail` 和 `cal。`這些值大小寫不須相符。如果指定 `-S mail` 選項，則必須指定 `-H` 選項。可以以逗號分隔的清單列出。例如： `-S mail,cal` 根據 Identity Sever 配置檔案中的特定服務定義值，使用提到的服務建立網域。
只有在指定 `-S` `mail` 選項時，才允許以下選項：
`-H` `preferred` `mailhost`	喜好的網域郵件主機。主機必須具有完全合格的主機名稱，如 `mailhost.sesta.com`。如果指定 `-S mail` 選項，則此選項為必要的。
只有在指定 `-S` `cal` 選項時，才允許以下選項：
`-B` `backend calendar data server`	指定在網域中指定給使用者或資源的預設後端主機。
`-C` `searchable domains`	指定查找行事曆或使用者時要搜尋的網域。
`-g` `access control string`	指定新建立的使用者行事曆之存取控制清單 (ACL)。
`-P` `propertyname`[:`value`]	設定多值屬性及位元屬性的值。請參閱屬性值表，以取得屬性、屬性說明及屬性值。
`-R` `right`[:`value`]	設定行事曆網域屬性 `icsAllowRights`。該屬性具有點陣圖值。請參閱屬性值，以取得屬性、屬性值及屬性說明清單。
`-T` `calendar time zone string`	指定匯入檔案時使用的時區 ID。請參閱行事曆時區字串，以取得有效時區字串清單。

範例

若要使用郵件和行事曆服務建立新的網域，請輸入：

commadmin domain create -D chris -d florizel.com -n sesta.com -w bolton \
-S mail,cal -H mailhost.sesta.com

commadmin domain delete

commadmin domain delete 指令將單一托管網域標記為已從伺服器中刪除。若要將多個托管網域標記為已刪除，請使用 -i 選項。

commadmin domain purge指令將永久性移除網域。

若要禁止組織管理員使用服務 (如行事曆服務或郵件服務)，請使用 -S 選項。此處，S 為大寫。

語法

commadmin domain delete -D login -d  domain name -n domain -w password [-h] [-?] 
[-i inputfile] [-p AM port] [-s] [-S  service] [-v] [-V] [-X AM host]

選項

以下選項是必要的：

選項	說明
`-D` `login`	頂層管理員的使用者 ID。
`-d` `domain name`	要刪除的 DNS 網域名稱。如果未指定 `-d`，則使用由 `-n` 指定的網域。
`-n` `domain`	頂層管理員所在的網域。
`-w` `password`	頂層管理員的密碼。

以下選項是非必要的：

選項	說明
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-S` `service`	將指定的服務狀態屬性值修改為「已刪除」。以逗號分隔多個服務。有效的 `service` 值為 `mail` 和 `cal。`這些值大小寫不須相符。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。

範例

若要刪除現有網域，請執行以下指令：

commadmin domain delete -D chris -w bolton -d florizel.com -n sesta.com

若要從 florizel.com 網域中僅刪除郵件服務，請執行以下指令：

commadmin domain delete -D chris -w bolton -d florizel.com -n sesta.com \
-S mail

commadmin domain modify

commadmin domain modify 指令可修改單一網域的目錄項目屬性。若要修改多個網域，請使用 -i 選項。

語法

commadmin domain modify -D login -d  domain -n domain -w password [-A [+|-]
attributename:value] [-h] [?] [-i  inputfile] [-p AM port] 
[-s] [-v] [-V] [-X AM host] [-S mail -H preferred mailhost] [-S cal [-g access string] 
[-C cross domain search domains] [-B backend calendar data server] 
[-P [action]propertyname[: value]] [-R propertyname[:value]] [-T calendar time zone string]]

選項

以下選項是必要的：

選項	說明
`-D` `login`	頂層管理員的使用者 ID。
`-d` `domain`	要修改的 DNS 網域名稱。如果未指定 `-d`，則使用由 `-n` 指定的網域。
`-n` `domain`	頂層管理員所在的網域。
`-w` `password`	頂層管理員的密碼。

以下選項是非必要的：

選項	說明
`-A` [+ \| -]`attributename`:`value`	要修改的屬性。`attributename` 在 LDAP 模式下定義，其值可替代目錄中此屬性的任意或所有現有值。重複此選項可同時修改多個屬性，或為同一屬性指定多個值。 `attributename` 前面的「+」指示將該值增加至目前屬性清單。「-」指示移除值。如果使用「-」，則在指令行上指定指令時，必須在指令前加兩個反斜線。如果該選項在輸入檔案中提供，則必須在「-」符號前加一個反斜線。如果未指定動作值 (`+` 或 `-`)，則預設動作將替代現有值。
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。
`-S` `service`	修改期間將指定的服務增加至網域。有效的 `service` 值為 `mail` 和 `cal。`這些值大小寫不須相符。用逗號將使用 `-S` 選項列出的服務分隔。如果指定 `-S mail`，則必須指定 `-H` 選項。
增加服務時，只有在指定 `-S` `mail` 選項時，才允許以下選項：
`-H` `preferred mailhost`	喜好的網域郵件主機。如果指定了 `-S mail` 選項，則此選項為必要的。
增加服務時，只有在指定 `-S` `cal` 選項時，才允許以下選項：
`-B` `backend calendar data server`	指定給網域中的使用者或資源的預設後端主機。
`-C` `cross domain search domains`	指定查找行事曆或使用者時要搜尋的網域。
`-g` `access string`	指定新建立的使用者行事曆之存取控制清單 (ACL)。
`-P` [`action`]`propertyname` [:`value`]	設定多值屬性及位元屬性的值。請參閱屬性值表，以取得 `propertyname` 說明及其值。
`-T` `calendar time zone string`	匯入檔案時使用的時區 ID。請參閱行事曆時區字串，以取得有效時區字串清單。
`-R` `propertyname`[:`value`]	設定行事曆網域屬性 `icsAllowRights`。該屬性具有點陣圖值。請參閱屬性值，以取得特性名稱、特性值以及特性說明清單。

範例

若要修改現有網域，請執行以下指令：

commadmin domain modify -D chris -w bolton -n sesta.com -d varrius.com \
-A preferredmailhost:test.siroe.com

commadmin domain purge

commadmin domain purge 指令可永久性移除已標記為可移除的所有項目或項目之服務。這可以包含網域、使用者、群組及資源。

請使用 commadmin domain purge 指令，移除其刪除時間已超過指定寬限期的所有項目，以進行定期維護作業。

可以透過手動呼叫指令隨時執行清除。

呼叫指令時，會搜尋目錄並建立網域清單，該目錄項目包含標記為刪除時間超過指定的寬限期的網域。寬限期的預設值設定為 5 天。

如果指定 -d* 選項，則會搜尋所有網域中標記為已刪除的使用者及網域。標記為已刪除的使用者將從其網域中清除，但是不會清除該網域，除非其也標記為已刪除。如果網域標記為已刪除，則將一起清除該網域及其所有使用者。

服務標記為已刪除後，必須先執行可移除資源 (如電子信箱或行事曆) 的公用程式，才能從目錄中清除該服務。對於郵件服務，該程式為 msuserpurge。請參閱「Sun Java System Messaging Server Administration Reference」，以取得有關 msuserpurge 公用程式的資訊。對於行事曆服務，該程式為 csclean。請參閱「 Sun Java System Calendar Server Administration Guide」，以取得有關 csclean 公用程式的資訊。

備註 –

commadmin domain purge 指令必須由頂層管理員執行。

語法

commadmin domain purge -D login -n  domain -w password -d domain [-g grace] [-h] [-?] 
[-i inputfile] [-p AM port] [-s] [-S  service] [-v] [-V] [-X AM host]

選項

以下選項是必要的：

選項	說明
`-D` `login`	頂層管理員的使用者 ID。
`-n` `domain`	頂層管理員所在的網域。
`-w` `password`	頂層管理員的密碼。
`-d` `domain`	清除指定的網域。* 運算子 (`-d*`) 可以用於搜尋式樣。

以下選項是非必要的：

選項	說明
`-g` `grace`	網域清除之前的寬限期 (以天為單位)。不會刪除標記為刪除時間短於 `grace` 天的網域。0 指示立即清除。預設值為 5 天。永遠不能變更預設值。只能使用 `commadmin domain purge` 指令中的 `-g` (寬限期) 選項變更寬限期。
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-S` `service`	從網域中移除服務相關的物件類別和屬性。如果網域包含使用者和資源，則將從目錄中移除這些使用者和資源的特定服務資料。用逗號 (,) 分隔符將服務清單分隔。有效的 `service` 值為 `mail` 和 `cal。`這些值大小寫不須相符。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。

範例

在以下範例中，將清除 siroe.com 網域，並移除其中的所有項目：

commadmin domain purge -D chris -d siroe.com -n sesta.com -w bolton

commadmin domain search

commadmin domain search 指令可取得與單一網域相關的所有目錄特性。若要取得多個網域的所有目錄特性，請使用 -i 選項。在此指令中指定 - S 時，將僅顯示具有使用中指定服務的網域。

語法

commadmin domain search -D login -n  domain -w password [-d domain] [-h] [-?] 
[-i inputfile] [-p AM port] [-s] [-S  service] [-t Search Template] [-v] [-V] [-X AM host]

選項

以下選項是必要的：

選項	說明
`-D` `login`	有權執行此指令的使用者之使用者 ID。
`-n` `domain`	使用 `-D` 選項指定的使用者所在的網域。
`-w` `password`	使用 `-D` 選項指定的使用者的密碼。

以下選項是非必要的：

選項	說明
`-d` `domain`	搜尋此網域。如果未指定 `-d`，或指定了 `-d*`，則將顯示所有網域。
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-S` `service`	指定要在使用中網域中搜尋的服務。 `service` 值可以為一個服務或多個服務。有效的 `service` 值為 `mail` 和 `cal。`這些值大小寫不須相符。用逗號 (,) 分隔符將服務清單分隔。例如： `-S mail,cal`
`-t` `Search template`	指定要使用的搜尋範本名稱，而非預設搜尋範本名稱。搜尋後將僅顯示使用中網域。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。

commadmin group create

commadmin group create 指令可將單一群組增加至 Access Manager。若要建立多個群組，請使用 -i 選項。

如果建立的群組中無成員，則依預設，該群組為靜態群組。

備註 –

群組無法同時包含靜態和動態成員。

電子郵件發行清單是一種群組類型。郵件傳送至群組位址時，Access Manager 會將該郵件傳送給群組中的所有成員。

語法

commadmin group create -D login -G  groupname -n domain -w password [-A [+]
attributename:value] [-d  domain] [-f ldap-filter] [-h] [-?] [-i inputfile] 
[-m internal-member] [-p  AM port][-s] [-v] [-V] [-X AM host] [-S service 
[-H mailhost] [-E  email] [-M external-member] [-o  owner] 
[-rs moderator]]

選項

以下選項是必要的：

選項	說明
`-D` `login`	有權執行此指令的使用者之使用者 ID。
`-n` `domain`	由 `-D` 選項指定的使用者所在的網域。
`-G` `groupname`	群組名稱 (例如 `mktg-list`)。
`-w` `password`	由 `-D` 選項指定的使用者密碼。

以下選項是非必要的：

選項	說明
`-A` [+ ]`attributename`:`value`	要修改的屬性。`attributename` 在 LDAP 模式中定義，`value` 將替代目錄中此屬性的任意和所有目前值。重複此選項可同時修改多個屬性，或為同一屬性指定多個值。 `attributename` 前面的「+」指示將該值增加至目前屬性清單。
`-d` `domain`	群組完全合格的網域名稱 (例如 `varrius.com`)。預設為本地網域。如果未指定 `-d`，則使用由 `-n` 指定的網域。
`-f` `ldap-filter`	建立動態群組。透過指定屬性或屬性組合，設定 LDAP 篩選器。可以指定多個 `-f` 指令來定義多個群組成員 LDAP 篩選器。
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-m` `internal -member`	增加至此群組的內部成員之使用者 ID。若要增加多個成員，請使用多個 `-m` 選項。應使用此選項建立靜態群組。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-S` `service`	指定要增加至群組的服務。 `service` 值可以為一個服務或多個服務。有效的服務值為 mail 和 cal。這些值大小寫不須相符。用逗號 (,) 分隔符將服務清單分隔。例如： `-S mail,cal`
只有在指定 `-S` `mail` 選項時，才允許以下選項：
`-H` `mailhost`	此群組回應的郵件主機 (如 `mailhost.varrius.com`)。預設為本地郵件主機。
`-E` `email`	群組的電子郵件位址。
`-M` `external-member`	增加至此群組的外部成員之使用者 ID。若要增加多個成員，請使用多個 `-M` 選項。
`-o` `owner`	群組所有者的電子郵件位址。所有者為負責發行清單的個人。所有者可以增加或刪除發行清單成員。
`-r` `moderator`	管理者的電子郵件位址。

範例

若要在網域 sesta.com 中建立群組 testgroup，請執行以下指令：

commadmin group create -D chris -n sesta.com -w bolton -G testgroup \
-d sesta.com -m lorca@sesta.com -S mail -M achiko@varrius.com

commadmin group delete

commadmin group delete 指令可將單一群組標記為已刪除。若要將多個群組標記為已刪除，請使用 -i 選項。

若要停用群組使用的服務 (例如 Calendar Server 或 Messaging Server)，請使用 -S 選項。此處，S 為大寫。

備註 –

若要永久性移除群組，必須執行以下指令：commadmin domain purge。

語法

commadmin group delete -D login -G  groupname -n domain -w password [-d domain] 
[-h] [-?] [-i inputfile] [-p AM port] [-s] [-S  service] [-v] [-V] [-X AM host]

選項

以下是必要的選項：

選項	說明
`-D` `login`	有權執行此指令的使用者之使用者 ID。
`-G` `groupname`	要標記為已刪除的群組之名稱。例如，`mktg-list`。
`-n` `domain`	由 `-D` 選項指定的使用者所在的網域。
`-w` `password`	由 `-D` 選項指定的使用者密碼。

以下是非必要的選項：

選項	說明
`-d` `domain`	群組所在的網域。如果未指定 `-d`，則使用由 `-n` 選項指定的網域。
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-S` `service`	將指定的服務狀態屬性值修改為「已刪除」。用逗號將使用 `-S` 選項列出的服務分隔。有效的 `service` 值為 `mail` 和 `cal。`這些值大小寫不須相符。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。

範例

以下範例將群組 testgroup@varrius.com 標記為已刪除：

commadmin group delete -D chris -n sesta.com -w bolton -G testgroup \
-d varrius.com

以下範例將 testgroup@varrius.com 的郵件服務標記為已刪除：

commadmin group delete -D chris -n sesta.com -w bolton -G testgroup \
-d varrius.com -S mail

commadmin group modify

commadmin group modify 指令可變更 Access Manager 中單一群組的屬性。若要變更多個群組的屬性，請使用 -i 選項。

郵件收信人清單是一種群組類型。郵件傳送至群組位址時，Access Manager 會將該郵件傳送給群組中的所有成員。

語法

commadmin group modify -D login -G  groupname -n domain -w password [-A [+|-]
attributename:value] [-d  domain] [-f [action]ldap-filter] [-h] [-?] 
[-i inputfile] [-m [+|-]internal-member] [-p AM port] [-s] [-v] [-V] 
[-X  AM host] [-S mail [-o owner] [-E email] [-H  mailhost] [-M external-member] 
[-r  moderator]]

選項

以下是必要的選項：

選項	說明
`-D` `login`	有權執行此指令的使用者之使用者 ID。
`-G` `groupname`	要修改的群組之名稱。例如，`mktg-list`。
`-n` `domain`	由 `-D` 選項指定的使用者所在的網域。
`-w` `password`	由 `-D` 選項指定的使用者密碼。

以下是非必要的選項：

選項	說明
`-A` [+ \| -]`attributename`:`value`	要修改的屬性。`attributename` 在 LDAP 模式下定義，其值可替代目錄中此屬性的任意或所有現有值。重複此選項可同時修改多個屬性，或為同一屬性指定多個值。 `attributename` 前面的「+」指示將該值增加至目前屬性清單。「-」指示移除值。如果使用「-」，則在指令行上指定指令時，必須在指令前加兩個反斜線，或者用引號引起來。如果該選項在輸入檔案中提供，則必須在「-」符號前加一個反斜線。
`-d` `domain`	群組所在的網域。如果未指定 `-d`，則使用由 `-n` 選項指定的網域。
`-` `f` [`action`] `ldap-filter`	指示是否將 lDAP 篩選器增加至群組或從群組中將其移除 `ldap-filter` 前面的「+」指示其將被增加至現有篩選器。「-」指示移除該現有篩選器。鍵入 `-f-*` 以移除所有篩選器。如果使用「-」，則在指令行上指定指令時，必須在指令前加兩個反斜線，或者用引號引起來。如果未指定 `action`，則依預設，增加該篩選器 (假設尚未存在)。否則，會顯示錯誤訊息。
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-m` [`action`] `internal -member`	指示是否增加或移除內部成員。內部 `-member` 的值為郵件位址或使用者 ID。 `action` 值為： +，向現有內部成員清單增加成員。 -，從現有內部成員清單中移除成員。如果使用「-」，則在指令行上指定指令時，必須在指令前加兩個反斜線，或者用引號引起來。 `-m-*` 可移除所有內部成員。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。
`-S mail`	驗證完郵件服務是否存在後，在修改期間向群組增加郵件服務。如果服務已存在，則會顯示錯誤訊息。 `-S` 的唯一有效值為 `mail`。
只有在指定 `-S` `mail` 選項時，才允許以下選項：
`-o` `owner`	群組所有者的電子郵件位址。所有者為負責發行清單的個人。所有者可以增加或刪除發行清單成員。
`-E` `email`	群組的電子郵件位址。
`-H` `mailhost`	群組的郵件主機。預設為本地郵件主機。
`-M` `external -member`	增加外部成員。 `external-member` 的值為使用者郵件位址。
`-r` `moderator`	管理者的使用者 ID。如果該管理者位於其他網域中，則鍵入電子郵件位址。必須使用此選項指定 `-S mail` 選項。

範例

若要從網域 varrius.com 的群組 testgroup 中移除內部成員 (jsmith)，請執行以下指令：

commadmin group modify -D chris -d varrius.com -G testgroup -n sesta.com \
-w bolton -m \\-jsmith

commadmin group search

commadmin group search 指令可取得與單一群組相關的所有目錄特性。若要取得多個群組的所有目錄特性，請使用 -i 選項。

語法

commadmin group search -D login -n  domain -w password [-d domain] [-E string] 
[-G string] [-h] [-?] [-i inputfile] [-p  AM port] [-s] [-S service] [-t search 
template] [-v] [-V] [-X AM host]

選項

以下選項是必要的：

選項	說明
`-D` `login`	有權執行此指令的使用者之使用者 ID。
`-n` `domain`	由 `-D` 選項指定的使用者所在的網域。
`-w` `password`	由 `-D` 選項指定的使用者密碼。

以下選項是非必要的：

選項	說明
`-d` `domain`	要搜尋的群組所在的網域。如果未指定 `-d`，則將搜尋所有網域。
`-E` `string`	群組的電子郵件位址。可以在字串的任何部位使用萬用字元運算子 (*)。
`-G` `string`	要搜尋的群組之名稱。例如，`mktg-list`。如果未指定 `-G`，則顯示由 `-d` 指定的網域中的所有群組。可以在字串的任何部位使用萬用字元運算子 (*)。
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-p` `AM port`	指定 IS 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-S` `service`	指定要搜尋的服務。 `service` 的唯一有效值為 `mail。`此值大小寫不須相符。例如： `-S mail` 僅顯示包含使用中服務的群組。
`-t` `Search Template`	指定要使用的搜尋範本名稱，而非預設搜尋範本名稱。這是定義搜尋篩選器目錄中的項目。僅搜尋使用中群組。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。

範例

若要在 siroe.com 網域中搜尋名為 developers 的群組，請執行以下指令：

commadmin group search -D chris -n sesta.com -w password -G developers \
-d siroe.com

commadmin resource create

commadmin resource create 指令可建立資源目錄項目。

如需有關建立資源的說明，請參閱建立資源。

語法

commadmin resource create -D login -n  domain -w password -u identifier -N name 
-o owner [-c calendar identifier] [-A [+] attributename:value] [-C DWPHost] 
[-d domainname ] [-h] [-?] [-i inputfile][-p AM port] [-s] [-T time zone] [-v] 
[-V] [-X AM host]

選項

以下選項是必要的：

選項	說明
`-D` `login`	有權執行此指令的使用者之使用者 ID。
`-n` `domain`	使用 `-D` 選項指定的使用者所在的網域。
`-w` `password`	使用 `-D` 選項指定的使用者密碼。
`-u` `identifier`	資源的唯一識別碼。此 `identifier` 值應在網域名稱空間，或行事曆模式下行事曆管理的所有使用者和資源中是唯一的。
`-N` `name`	用於顯示行事曆 GUI 中的資源之易於識別的名稱。
`-o` `owner`	資源的所有者。此使用者 ID 必須位於在其中建立資源的網域中。
`-c` `calendar identifier`	此資源行事曆的識別碼。此識別碼值應在由 Calendar Server 管理的所有行事曆中為唯一值。

以下選項是非必要的：

選項	說明
`-A` [+ ] `attributename`:`value`	要修改的屬性。`attributename` 在 LDAP 模式中定義，`value` 將替代目錄中此屬性的任意和所有目前值。重複此選項可同時修改多個屬性，或為同一屬性指定多個值。 `attributename` 前面的「+」指示將該值增加至目前屬性清單。
`-C` `DWPHost`	託管此使用者行事曆的後端行事曆伺服器之 DNS 名稱。如果未指定後端行事曆伺服器的 DNS 名稱，則儲存於伺服器 ics.conf 檔案中的值將用做預設值。
`-d` `domain name`	資源所在的網域。如果未指定 `-d`，則使用由 `-n` 指定的網域。
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-T` `time zone`	用於顯示行事曆使用者介面中的資源行事曆之時區。請參閱行事曆時區字串，以取得有效時區字串清單。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。

範例

若要在網域 varrius.com 下的行事曆 cal.siroe.com 中建立名為 peter 的資源，請執行以下指令：

commadmin resource create -D chris -n sesta.com -w bolton -o ownerid \
-d varrius.com -u id -c calid -N peter -C cal.siroe.com

建立資源

資源由兩個資料說明組成：Calendar Server 資料庫中的目錄項目和行事曆。目錄項目具有屬性 icsCalendar，其值為與資源相關的行事曆之名稱。

可以使用以下方法之一，建立具有這兩個資料說明的資源：

使用 csresource 公用程式本身。csresource 公用程式可建立目錄項目和行事曆。

但是，僅當目錄在 Schema 1 環境中且您未使用 Access Manager 時，才建議使用 csresource 同時建立目錄項目和行事曆。

使用 commadmin resource create 建立目錄項目，使用 csresource 公用程式建立行事曆。例如：

使用 commadmin resource create 建立目錄項目：

commadmin resource create -D amadmin -w ampassword -n blink.sesta.com
 -X blink -p 5555 -d varrius.com -o test1 -u resourceOne
 -N firstResource -c resourceOneCalendar

目錄項目如下：

dn: uid=resourceONE,ou=People,o=varrius,o=domainroot
uid: resrouceONE
objectClass: icsCalendarResource
objectClass: top
cn: firstResource
icsStatus: active
icsCalendar: test1@varrius.com:resourceOne

使用 csresource 建立行事曆。

備註：呼叫 csresource 中的 create 指令時，輸入的資源名稱值必須與用於 commadmin resource create 中 -u 選項的值相同。

現在即可以以任何使用者身份登入，並邀請資源參加事件。

如需有關 csresource 公用程式的詳細說明，請參閱「Sun Java System Calendar Server Administration Guide」中的「Calendar Server Command-Line Utilities」。

commadmin resource delete

commadmin resource delete 指令可將資源標記為已刪除。

備註 –

若要永久性移除資源，請執行commadmin domain purge。

語法

commadmin resource delete -D login -u  identifier -n domain -w password [-d domainname] 
[-h] [-?] [-i inputfile] [-p AM port] [-s] [-v] [-V] [-X  AM host]

選項

以下選項是必要的：

選項	說明
`-D` `login`	有權執行此指令的使用者之使用者 ID。
`-n` `domain`	使用 `-D` 選項指定的使用者所在的網域。
`-w` `password`	使用 `-D` 選項指定的使用者密碼。
`-u` `identifier`	資源的唯一識別碼。

以下選項是非必要的：

選項	說明
`-d` `domainname`	資源所在的網域。如果未指定 `-d`，則使用由 `-n` 指定的網域。
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。

範例

若要將資源標記為已刪除，請執行以下指令：

commadmin resource delete -D chris -n sesta.com -w bolton -u bill023

commadmin resource modify

commadmin resource modify 指令可修改資源。

語法

commadmin resource modify -D login -n  domain -w password -u identifier [-A [+|-]
attributename:value] [-d  domainname ] [-h] [-?] [-i inputfile] [-N name] 
[-p AM port] [-s] [-T  time zone] [-v] [-V] [-X sAM host]

選項

以下選項是必要的：

選項	說明
`-D` `login`	有權執行此指令的使用者之使用者 ID。
`-n` `domain`	使用 `-D` 選項指定的使用者所在的網域。
`-w` `password`	使用 `-D` 選項指定的使用者密碼。
`-u` `identifier`	資源的唯一識別碼。

以下選項是非必要的：

選項	說明
`-A` [+ \| -]`attributename`:`value`	要修改的屬性。`attributename` 在 LDAP 模式下定義，其值可替代目錄中此屬性的任意或所有現有值。重複此選項可同時修改多個屬性，或為同一屬性指定多個值。 `attributename` 前面的「+」指示將該值增加至目前屬性清單。「-」指示移除值。如果使用「-」，則在指令行上指定指令時，必須在指令前加兩個反斜線。如果該選項在輸入檔案中提供，則必須在「-」符號前加一個反斜線。
`-d` `domainname`	資源所在的網域。如果未指定 `-d`，則使用由 `-n` 指定的網域。
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-N` `name`	用於顯示行事曆使用者介面中的資源之一般名稱。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-T` `time zone`	用於顯示行事曆 GUI 中的資源行事曆之時區。請參閱行事曆時區字串，以取得有效時區字串清單。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。

範例

若要修改唯一識別碼為 bill023 的資源，使其新的一般名稱為 bjones，請執行以下指令：

commadmin resource modify -D chris -n sesta.com -w bolton -d test.com \
-u bill023 -N bjones

commadmin resource search

commadmin resource search 指令可搜尋資源。

語法

commadmin resource search -D login -n  domain -w password [-d domain] [-h] [-?] 
[-i inputfile] [-N string] [-p  AM port] [-s] [-t Search Template] [-u  string] 
[-V] [-v] [-X AM host]

選項

以下選項是必要的：

選項	說明
`-D` `login`	有權執行此指令的使用者之使用者 ID。
`-n` `domain`	使用 `-D` 選項指定的使用者所在的網域。
`-w` `password`	使用 `-D` 選項指定的使用者密碼。

以下選項是非必要的：

選項	說明
`-d` `domain`	資源所在的網域。僅在網域中執行搜尋。如果未指定 `-d`，或指定了 `-d*`，則將顯示所有網域。
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-N` `string`	輸入資源的一般名稱。可以在字串的任何部位使用萬用字元運算子 (*)。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-t` `Search Template`	指定要使用的搜尋範本名稱，而非預設搜尋範本名稱。這是定義搜尋篩選器目錄中的項目。僅搜尋使用中資源。
`-u` `string`	指定的資源識別碼對於網域名稱空間，或由行事曆管理的所有使用者和資源必須是唯一的。可以在字串的任何部位使用萬用字元運算子 ()。如果未指定該識別碼，或指定了 `-l`，則將在搜尋期間顯示所有資源。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。

範例

若要在網域 sesta.com 中搜尋資源 arabella，請執行以下指令：

commadmin resource search -D serviceadmin -w serviceadmin -n sesta.com \s
-d sesta.com -u arabella

commadmin user create

commadmin user create 指令可在 Access Manager 系統中建立單一使用者。若要建立多個使用者，請使用 -i 選項。

語法

commadmin user create -D login -F  firstname -n domain -L lastname -l userid -w password 
-W password [-A [+] attributename:value] [-d domain] [-I initial] [-h] [-?] [-i inputfile] 
[-p  AM port] [-s] [-v] [-V] [-X AM host] [-S mail [-E email] [-H mailhost]] [-S cal 
[-B DWPHost] [-E email] [-k  calid_type] [-J First Day of Week] [-T  time zone]

選項

以下選項是必要的：

選項	說明
`-D` `login`	有權執行此指令的使用者之使用者 ID。
`-F` `firstname`	使用者的名字必須是沒有空格的單個詞。
`-n` `domain`	使用 `-D` 選項指定的使用者所在的網域。
`-l` `userid`	使用者的登入名稱。
`-w` `password`	使用 `-D` 選項指定的使用者密碼。
`-W` `password`	要建立的使用者之密碼。也可以透過文字檔 `password.txt` 指定 `password`。
`-L` `lastname`	使用者的姓氏。

以下選項是非必要的：

選項	說明
`-A` [+ ]`attributename`:`value`	要修改的屬性。`attributename` 在 LDAP 模式中定義，`value` 將替代目錄中此屬性的任意和所有目前值。重複此選項可同時修改多個屬性，或為同一屬性指定多個值。 `attributename` 前面的「+」指示將該值增加至目前屬性清單。
`-d` `domain`	使用者所在的網域。如果未指定 `-d`，則使用由 `-n` 指定的網域。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-I` `initial`	使用者中間名字的首字母。
`-h`、`-?`	顯示指令用法語法。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。
`-S` `service`	建立期間向使用者增加指定的服務。`service` 值可以為一個服務或多個服務。有效的 `service` 值為 `mail` 和 `cal`。這些值大小寫不須相符。用逗號 (,) 分隔符將服務清單分隔。例如： `-S mail,cal`
只有在指定 `-S` `mail` 選項時，才允許以下選項：
`-E` `emai`l	使用者的電子郵件位址。
`-H` `mailhost`	使用者的郵件主機。
只有在指定 `-S cal` 選項時，才允許以下選項：
`-B` `DWPHost`	託管使用者行事曆的後端行事曆之 DNS 名稱。
`-E` `email`	行事曆使用者的電子郵件位址。
`-J` `First Day of Week`	在行事曆伺服器使用者介面中顯示行事曆時的週的第一天。有效值為 0-6 (0 為星期日，1 為星期一，以此類推)。
`-k` `calid_type`	指定建立的行事曆 ID 的類型。接受的值為 `legacy` 和 `hosted`。如果指定了 `-k legacy`，則僅使用行事曆 ID (例如 `jsmith`)。如果指定了 `-k hosted`，則使用行事曆 ID 和網域 (例如 `jsmith@sesta.com`)。如果未指定 `-k` 選項，則依預設使用行事曆 ID 和網域 (`hosted`)。如果未指定 `-k` 選項，則可以設定建立的行事曆 ID 類型值。若要執行此作業，請將以下參數增加至 `resource.properties` 檔案： `switch-caltype=`value 其中，value 為「`hosted`」\|「`legacy`」。 `resource.properties` 檔案位於以下目錄中： da_base`/data/WEB-INF/classes/sun/comm/cli/ \ server/servlet/resource.properties`
`-T` `time zone`	使用者行事曆顯示的時區。請參閱行事曆時區字串，以取得有效時區字串清單。

範例

若要建立新使用者 smith，請輸入：

commadmin user create -D chris -n sesta.com -w secret -F smith -l john \
-L major -W secret -S mail -H mailhost.siroe.com

commadmin user delete

commadmin user delete 指令可將單一使用者標記為已刪除。若要將多個使用者標記為已刪除，請使用 -i 選項。

無取消刪除公用程式。但是，在清除寬限期到期且將清除設定為對項目執行之前，可以隨時使用 ldapmodify 指令將使用者項目的狀態屬性變更為 active。

移除使用者

步驟

透過執行 commadmin user delete 指令可將使用者標記為已刪除。

移除使用者資源。

資源可以是電子信箱或行事曆。

對於郵件服務，該程式為 msuserpurge。請參閱「Sun Java System Messaging Server Administration Reference」，以取得有關 msuserpurge 公用程式的資訊。

對於行事曆服務，該程式為 csclean。請參閱「 Sun Java System Calendar Server Administration Guide」，以取得有關 csclean 公用程式的資訊。

透過呼叫以下指令可以永久性移除使用者：commadmin domain purge。

語法

commadmin user delete -D login -n  domain -l login name -w password [-d domain] [-h] 
[-?] [-i inputfile] [-p AM port] [-s] [-S  service] [-v] [-V] [-X AM host]

選項

以下選項是必要的：

選項	說明
`-D` `login`	有權執行此指令的使用者之使用者 ID。
`-n` `domain`	使用 `-D` 選項指定的使用者所在的網域。
`-w` `password`	使用 `-D` 選項指定的使用者密碼。
`-l` `userid`	要刪除的使用者之使用者 ID。

以下選項是非必要的：

選項	說明
`-d` `domain`	使用者所在的網域。如果未指定 `-d`，則使用由 `-n` 指定的網域。
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-S` `service`	指定要移除的使用者服務。使用者保持使用中狀態，僅關閉指定的服務。如果未指定 `-S`，則刪除該使用者。 `service` 值可以為一個服務或多個服務。有效的 `service` 值為 `mail` 和 `cal`。這些值大小寫不須相符。用逗號 (,) 分隔符將服務清單分隔。例如： `-S mail,cal`
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。

範例

若要將現有使用者標記為已刪除，請執行以下指令：

commadmin user delete -D chris -n sesta.com -w bolton -l smith

若要僅刪除使用者 smith 的郵件服務，請執行以下指令：

commadmin user delete -D chris -n sesta.com -w bolton -l smith -S mail

commadmin user modify

commadmin user modify 指令可修改單一使用者的目錄項目屬性。若要修改多個使用者，請使用 -i 選項。

語法

commadmin user modify -D login -n  domain -l userid -w password [-A [+|-]
attributename:value] [-d  domain] [-h] [-?] [-i inputfile] [-p  AM port] 
[-s] [-v] [-V] [-X AM host] [-S mail -H mailhost [-E email]] [-S cal [-B DWPHost] 
[-E email] [-k  calid_type] [-J First Day of Week] [-T time zone]]

選項

以下選項是必要的：

選項	說明
`-D` `login`	有權執行此指令的使用者之使用者 ID。
`-n` `domain`	使用 `-D` 選項指定的使用者所在的網域。
`-w` `password`	使用 `-D` 選項指定的使用者密碼。
`-l` `userid`	使用者的登入 ID。

以下選項是非必要的：

選項	說明
`-A` [+ \| -]`attributename`:`value`	要修改的屬性。`attributename` 在 LDAP 模式下定義，其值可替代目錄中此屬性的任意或所有現有值。重複此選項可同時修改多個屬性，或為同一屬性指定多個值。 `attributename` 前面的「+」指示將該值增加至目前屬性清單。「-」指示移除值。如果使用「-」，則在指令行上指定指令時，必須在指令前加兩個反斜線。如果該選項在輸入檔案中提供，則必須在「-」符號前加一個反斜線。
`-d` `domain`	使用者或群組所在的網域。如果未指定 `-d`，則使用由 `-n` 指定的網域。
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-p` `AM port`	指定 Access Manager 要偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。
`-S` `service`	驗證是否提供使用者使用 `-S` 選項指定的服務後，向使用者增加指定的服務。如果已經向使用者提供了該服務，則會顯示錯誤訊息。 `services` 值可以為一個服務或多個服務。有效的 `service` 值為 `mail` 和 `cal。`這些值大小寫不須相符。用逗號 (,) 分隔符將服務清單分隔。例如： `-S mail,cal`
只有在指定 `-S` `mail` 選項時，才允許以下選項：
`-E` `email`	指定使用者的電子郵件位址。
`-H` `mailhost`	使用者的郵件主機。如果指定 `-S mail` 選項，則此選項為必要的。
只有在指定 `-S cal` 選項時，才允許以下選項：
`-B` `DWPHost`	指定託管此使用者行事曆的後端行事曆伺服器之 DNS 名稱。備註只能增加、不能修改 (如果已存在) 此屬性。
`-E` `email`	指定行事曆使用者的電子郵件位址。
`-J` `First Day of Week`	在行事曆伺服器使用者介面中顯示行事曆時的週的第一天。有效值為 0-6 (0 為星期日，1 為星期一，以此類推)。
`-k` `calid_type`	指定建立的行事曆 ID 的類型 (增加行事曆服務時)。接受的值為 `legacy` 和 `hosted`。如果指定了 `-k legacy`，則僅使用行事曆 ID (例如 `jsmith`)。如果指定了 `-k hosted`，則使用行事曆 ID 和網域 (例如 `jsmith@sesta.com`)。如果未指定 `-k` 選項，則依預設使用行事曆 ID 和網域 (`hosted`)。如果未指定 `-k` 選項，則可以設定建立的行事曆 ID 類型值。若要執行此作業，請將以下參數增加至 `resource.properties` 檔案： `switch-caltype=`value 其中，value 為「`hosted`」\|「`legacy`」。 `resource.properties` 檔案位於以下目錄中： da_base`/data/WEB-INF/classes/sun/comm/cli/ \ server/servlet/resource.properties`
`-T` `time zone`	使用者行事曆將顯示的時區為此時區。請參閱行事曆時區字串，以取得有效時區字串清單。

範例

以下範例可為使用者 smith 增加郵件服務：

commadmin user modify -D chris -n sesta.com -w bolton -l smith \
-A description:"new description" -S mail -H mailhost.siroe.com

在以下範例中，可為使用者 smith 增加郵件轉寄位址：

commadmin user modify -D chris -n sesta.com -w bolton -l smith \
-A +mailforwardingaddress:tsmith@siroe.com

commadmin user search

commadmin user search 指令可取得與單一使用者相關的所有目錄特性。若要取得多個使用者的所有目錄特性，請使用 -i 選項。搜尋後將僅顯示使用中的使用者。

語法

commadmin user search -D login -n  domain -w password [-d domain] [-E string] [-F string] 
[-h] [-?] [-i inputfile] [-L  string] [-l string] [-p AM port] [-s] [-S service] 
[-t Search Template] [-v] [-V] [-X  AM host]

選項

以下選項是必要的：

選項	說明
`-D` `login`	有權執行此指令的使用者之使用者 ID。
`-n` `domain`	使用 `-D` 選項指定的使用者所在的網域。
`-w` `password`	使用 `-D` 選項指定的使用者密碼。

以下選項是非必要的：

選項	說明
`-d` `domain`	使用者所在的網域。僅在指定的網域中搜尋該使用者。如果未指定 `-d`，則搜尋所有網域。
`-E` `string`	搜尋使用者的郵件位址。可以在字串的任何部位使用萬用字元運算子 (*)。
`-F` `string`	搜尋使用者的名字。可以在字串的任何部位使用萬用字元運算子 (*)。
`-h`、`-?`	顯示指令用法語法。
`-i` `inputfile`	參閱檔案而非指令行中的指令資訊。
`-L` `string`	搜尋使用者的姓氏。可以在字串的任何部位使用萬用字元運算子 (*)。
`-l` `string`	搜尋使用者的登入名稱。可以在字串的任何部位使用萬用字元運算子 (*)。
`-p` `AM port`	使用此選項指定 Access Manager 偵聽的替代 TCP 連接埠。如果未指定，則使用預設 `AM port`；或者如果在安裝時未配置預設連接埠，則使用連接埠 80。
`-s`	使用 SSL (安全通訊端層) 連線 Access Manager。
`-S` `service`	指定與使用者搜尋相符的服務。 `services` 值可以為一個服務或多個服務。有效的 `service` 值為 `mail` 和 `cal。`這些值大小寫不須相符。用逗號 (,) 分隔符將服務清單分隔。例如： `-S mail,cal`
`-t` `Search template`	指定要使用的搜尋範本名稱，而非預設搜尋範本名稱。這是定義搜尋篩選器目錄中的項目。僅搜尋使用中的使用者。
`-v`	啟用除錯輸出。
`-V`	顯示有關公用程式及其版本的資訊。
`-X` `AM host`	指定執行 Access Manager 的主機。如果未指定，則使用預設 `AM host`；或者如果在安裝時未配置預設主機，則使用本地主機。

範例

以下範例可在 varrius.com 網域中搜尋使用者：

commadmin user search -D chris -w bolton -d varrius.com -n sesta.com