目錄服務命令行工具

目錄服務命令行工具是用于管理 href="HELP=glossary.hlp TOPIC=gls_activedirectory">Active Directory 中各種id=wPopup title=查看定義
href="HELP=glossary.hlp TOPIC=gls_object">對象并對目錄中的信息執(zhí)行查詢的一套工具。下面的列表對每個命令行工具及其功能進行了簡短描述：

• dsadd — 向目錄中添加對象。詳細信息，請參閱 href="MS-ITS:ntcmds.chm::/Dsadd.htm">Dsadd。
  
• dsget — 顯示目錄中的對象的屬性。詳細信息，請參閱 href="MS-ITS:ntcmds.chm::/Dsget.htm">Dsget。
  
• dsmod — 修改目錄中的現(xiàn)有對象的選定屬性。詳細信息，請參閱 href="MS-ITS:ntcmds.chm::/dsmod.htm">Dsmod。
  
• dsquery — 在目錄中查找匹配指定搜索條件的對象。詳細信息，請參閱 href="MS-ITS:ntcmds.chm::/dsquery.htm">Dsquery。
  
• dsmove — 將對象從其當前位置移到一個新的父位置。詳細信息，請參閱 href="MS-ITS:ntcmds.chm::/dsmove.htm">Dsmove。
  
• dsrm — 刪除對象，或目錄中一個對象下面完整的子目錄樹，或兩者都刪除。詳細信息，請參閱 href="MS-ITS:ntcmds.chm::/dsrm.htm">Dsrm。

目標對象類型

目標對象的標識在對象類型后面指定，格式為href="HELP=glossary.hlp TOPIC=gls_dn">可分辨名稱（對象的可分辨名稱屬性的值）。例如，用戶對象的可分辨名稱可能為 CN=Jeff Smith,OU=Sales,DC=microsoft,DC=com。

在以下命令中，computer 指定正被修改的對象類型，而 CN=Jeff Smith,OU=Sales,DC=microsoft,DC=com 標識要修改的目標對象：

dsmod computer CN=Jeff Smith,OU=Sales,DC=microsoft,DC=com
-disabled yes

在網(wǎng)絡上運行命令

每個工具都有一些參數(shù)，以允許您指定在運行命令時使用的服務器、域、用戶名和密碼。例如，下面是 dsadd computer 命令的語法：

dsadd computer ObjectDN

    ???? [-samid SAMName]

???? [-desc Description]

???? [-loc Location]

???? [-memberof Group ...]

???? [(-s Server | -d Domain)]

???? [-u UserName]

???? [-p (Password | *)]

???? [-q]

如果未輸入這些參數(shù)，則工具會使用本地服務器、域、用戶名和密碼。

命令語法

下面的約定可用于描述目錄服務命令行工具的語法：

• 當可以指定多個對象時，目標對象的可分辨名稱屬性的選項顯示為 ObjectDN 或 ObjectDN ...。
  
• 若沒有對象類型（如 computer）和該對象類型所需的任何參數(shù)（如目標對象的可分辨名稱，ObjectDN），則命令不會執(zhí)行任何操作。
  
• 對于特定命令，如果用戶未在命令提示符處指定目標對象，則會從標準輸入中獲取目標對象。從標準輸入中獲取值可允許將一個命令的輸出以管道方式輸送到另一個命令中。
   
  
• 使用“...”（省略號）字符的目標對象語法表明可指定一列可分辨名稱，每個可分辨名稱之間用空格分隔（除非另有指明）。例如，以下參數(shù)接受多個可分辨名稱：
     

  -memberof Group ...

  
     

  如果可分辨名稱本身包含空格，則應將它們用引號 (" ") 括起來。

  
     

  可分辨名稱中不用作分隔符的逗號必須用反斜扛 (\) 字符進行轉義（例如，"CN=Company\, Inc.,CN=Users,DC=microsoft,DC=com"）?？煞直婷Q中使用的反斜扛必須用反斜扛進行轉義（例如，"CN=Sales\\ Latin America,OU=Distribution Lists,DC=microsoft,DC=com"）。

  
  

命令輸入

• 所有參數(shù)都不區(qū)分大小寫。
  
• 命令行參數(shù)可以用連字符 (-) 或正斜杠 (/) 字符來指定。
  
• 命令行參數(shù)和參數(shù)的任何對應的值應至少用一個空格來分隔。
  
• 當從標準輸入中讀取時，空格和換行字符都作為參數(shù)分隔符來處理。
  
• 空字符串值或 Null 字符串值可以用引號 (" ") 指定，且引號之間不括起字符。指定的空字符串值不同于缺少的值。參數(shù)值 ""（NULL 字符串）將作為刪除目標對象中屬性值的請求來處理。
  
• 有關任何命令的幫助都可以用 /? 來獲得（例如，dsadd computer /?）。

命令輸出

下面是顯示由運行命令產生的數(shù)據(jù)、狀態(tài)消息、錯誤和警告所遵循的約定：

• 成功的命令完成狀態(tài)消息寫入標準輸出中。
  
• 命令顯示的任何數(shù)據(jù)寫入標準輸出中。
  
• 任何警告或錯誤信息寫入標準錯誤中。
  
• 退出代碼（錯誤級別）使用 0 表示成功。如果操作不成功，則退出代碼將是 HRESULT 格式的值。例如，HRESULT E_FAIL 的值是 0x80004005。
  
• 如果為命令指定了安靜模式（使用 -q 參數(shù)），則將取消所有對標準輸出的輸出。但是，任何寫入標準錯誤的消息都不會由于安靜模式而被取消。