目錄服務(wù)命令行工具
目錄服務(wù)命令行工具是用于管理 href="HELP=glossary.hlp TOPIC=gls_activedirectory">Active Directory 中各種id=wPopup title=查看定義
href="HELP=glossary.hlp TOPIC=gls_object">對(duì)象并對(duì)目錄中的信息執(zhí)行查詢的一套工具。下面的列表對(duì)每個(gè)命令行工具及其功能進(jìn)行了簡(jiǎn)短描述:
- dsadd — 向目錄中添加對(duì)象。詳細(xì)信息,請(qǐng)參閱 href="MS-ITS:ntcmds.chm::/Dsadd.htm">Dsadd。
- dsget — 顯示目錄中的對(duì)象的屬性。詳細(xì)信息,請(qǐng)參閱 href="MS-ITS:ntcmds.chm::/Dsget.htm">Dsget。
- dsmod — 修改目錄中的現(xiàn)有對(duì)象的選定屬性。詳細(xì)信息,請(qǐng)參閱 href="MS-ITS:ntcmds.chm::/dsmod.htm">Dsmod。
- dsquery — 在目錄中查找匹配指定搜索條件的對(duì)象。詳細(xì)信息,請(qǐng)參閱 href="MS-ITS:ntcmds.chm::/dsquery.htm">Dsquery。
- dsmove — 將對(duì)象從其當(dāng)前位置移到一個(gè)新的父位置。詳細(xì)信息,請(qǐng)參閱 href="MS-ITS:ntcmds.chm::/dsmove.htm">Dsmove。
- dsrm — 刪除對(duì)象,或目錄中一個(gè)對(duì)象下面完整的子目錄樹,或兩者都刪除。詳細(xì)信息,請(qǐng)參閱 href="MS-ITS:ntcmds.chm::/dsrm.htm">Dsrm。
目標(biāo)對(duì)象類型
所有的命令行工具都可作用于目錄中的各種對(duì)象類型。對(duì)于每一個(gè)接受對(duì)象特定參數(shù)的命令,允許輸入作為參數(shù)的目標(biāo)對(duì)象類型,命令將作用于它以及目標(biāo)對(duì)象的標(biāo)識(shí)。目標(biāo)對(duì)象類型指定為預(yù)定義的字符串文字集中表示對(duì)象類的字符串文字。例如,在命令 dsmod computer 中,computer 是指定對(duì)象類型的字符串文字。
目標(biāo)對(duì)象的標(biāo)識(shí)在對(duì)象類型后面指定,格式為href="HELP=glossary.hlp TOPIC=gls_dn">可分辨名稱(對(duì)象的可分辨名稱屬性的值)。例如,用戶對(duì)象的可分辨名稱可能為 CN=Jeff Smith,OU=Sales,DC=microsoft,DC=com。
在以下命令中,computer 指定正被修改的對(duì)象類型,而 CN=Jeff Smith,OU=Sales,DC=microsoft,DC=com 標(biāo)識(shí)要修改的目標(biāo)對(duì)象:
dsmod computer CN=Jeff Smith,OU=Sales,DC=microsoft,DC=com
-disabled yes
在網(wǎng)絡(luò)上運(yùn)行命令
每個(gè)工具都有一些參數(shù),以允許您指定在運(yùn)行命令時(shí)使用的服務(wù)器、域、用戶名和密碼。例如,下面是 dsadd computer 命令的語(yǔ)法:
dsadd computer ObjectDN
???? [-samid SAMName]
???? [-desc Description]
???? [-loc Location]
???? [-memberof Group ...]
???? [(-s Server | -d Domain)]
???? [-u UserName]
???? [-p (Password | *)]
???? [-q]
如果未輸入這些參數(shù),則工具會(huì)使用本地服務(wù)器、域、用戶名和密碼。
命令語(yǔ)法
下面的約定可用于描述目錄服務(wù)命令行工具的語(yǔ)法:
- 當(dāng)可以指定多個(gè)對(duì)象時(shí),目標(biāo)對(duì)象的可分辨名稱屬性的選項(xiàng)顯示為 ObjectDN 或 ObjectDN ...。
- 若沒有對(duì)象類型(如 computer)和該對(duì)象類型所需的任何參數(shù)(如目標(biāo)對(duì)象的可分辨名稱,ObjectDN),則命令不會(huì)執(zhí)行任何操作。
- 對(duì)于特定命令,如果用戶未在命令提示符處指定目標(biāo)對(duì)象,則會(huì)從標(biāo)準(zhǔn)輸入中獲取目標(biāo)對(duì)象。從標(biāo)準(zhǔn)輸入中獲取值可允許將一個(gè)命令的輸出以管道方式輸送到另一個(gè)命令中。
- 使用“...”(省略號(hào))字符的目標(biāo)對(duì)象語(yǔ)法表明可指定一列可分辨名稱,每個(gè)可分辨名稱之間用空格分隔(除非另有指明)。例如,以下參數(shù)接受多個(gè)可分辨名稱:
-memberof Group ...
如果可分辨名稱本身包含空格,則應(yīng)將它們用引號(hào) (" ") 括起來(lái)。
可分辨名稱中不用作分隔符的逗號(hào)必須用反斜扛 (\) 字符進(jìn)行轉(zhuǎn)義(例如,"CN=Company\, Inc.,CN=Users,DC=microsoft,DC=com")??煞直婷Q中使用的反斜扛必須用反斜扛進(jìn)行轉(zhuǎn)義(例如,"CN=Sales\\ Latin America,OU=Distribution Lists,DC=microsoft,DC=com")。
命令輸入
- 所有參數(shù)都不區(qū)分大小寫。
- 命令行參數(shù)可以用連字符 (-) 或正斜杠 (/) 字符來(lái)指定。
- 命令行參數(shù)和參數(shù)的任何對(duì)應(yīng)的值應(yīng)至少用一個(gè)空格來(lái)分隔。
- 當(dāng)從標(biāo)準(zhǔn)輸入中讀取時(shí),空格和換行字符都作為參數(shù)分隔符來(lái)處理。
- 空字符串值或 Null 字符串值可以用引號(hào) (" ") 指定,且引號(hào)之間不括起字符。指定的空字符串值不同于缺少的值。參數(shù)值 ""(NULL 字符串)將作為刪除目標(biāo)對(duì)象中屬性值的請(qǐng)求來(lái)處理。
- 有關(guān)任何命令的幫助都可以用 /? 來(lái)獲得(例如,dsadd computer /?)。
命令輸出
下面是顯示由運(yùn)行命令產(chǎn)生的數(shù)據(jù)、狀態(tài)消息、錯(cuò)誤和警告所遵循的約定:
- 成功的命令完成狀態(tài)消息寫入標(biāo)準(zhǔn)輸出中。
- 命令顯示的任何數(shù)據(jù)寫入標(biāo)準(zhǔn)輸出中。
- 任何警告或錯(cuò)誤信息寫入標(biāo)準(zhǔn)錯(cuò)誤中。
- 退出代碼(錯(cuò)誤級(jí)別)使用 0 表示成功。如果操作不成功,則退出代碼將是 HRESULT 格式的值。例如,HRESULT E_FAIL 的值是 0x80004005。
- 如果為命令指定了安靜模式(使用 -q 參數(shù)),則將取消所有對(duì)標(biāo)準(zhǔn)輸出的輸出。但是,任何寫入標(biāo)準(zhǔn)錯(cuò)誤的消息都不會(huì)由于安靜模式而被取消。