BinPlace 命令行語法
BinPlace 在命令行使用下列語法：
binplace [Options] File [ [Options] [@PlaceFile] File [...] ]
參數
選項
這可包含下列任一參數。 參數前面應該有連字元 （-） 或斜線 （/）。 在一個連字元或斜線之後，可以結合數個選項，但採用其他參數的選項應該後面接著空格。 因此，下列兩個命令相等：
binplace -q -k -g LCFile -v -s SymbolRoot File
binplace -qkg LCFile -vs SymbolRoot File
以下是可用的參數：
-a
讓 BinPlace 在放置私用符號檔時，將私用符號從符號檔移除。 這會建立包含公用符號但不包含私用符號的等量符號檔。 使用 -a 參數時，您也必須使用 -s 和 -x 。 使用 -a 時，已移除的符號檔會放在 -sSymbolRoot 所指定的路徑中。 如果 -nFullSymbolRoot 也存在，則完整符號檔會放在 FullSymbolRoot 中。 否則，它們不會放在任何地方。
-b ExtraSubdirectory
導致 BinPlace 將檔案放在與平常不同的位置。 串連根目的地目錄、類別子目錄和文件類型子目錄之後，BinPlace 接著會將 ExtraSubdirectory 附加至此路徑，以建立最終目的地目錄。 ExtraSubdirectory 不應該以反斜杠開頭或結尾。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。
-e
如果無法放置檔案，則會導致 BinPlace 繼續執行。 根據預設，BinPlace 會在發生此錯誤時結束。
-f
強制 BinPlace 放置檔案，即使它覆寫了較新的檔案也一樣。 根據預設，當 BinPlace 嘗試放置檔案時，它會覆寫較舊的版本，但不會覆寫較新版本。
-g LCFile
導致 BinPlace 驗證可執行檔。 LCFile 指定要用於此驗證的當地語系化條件約束檔案。
-h
導致 BinPlace 建立硬式連結，而不是在放置檔案時複製檔案。 這個選項僅適用於 NTFS 檔案系統。
-j
讓 BinPlace 在複製任何可執行檔之前，先確認適當的符號存在。 若要使用此選項，SymChk 工具必須位於您的路徑中。 （SymChk 是 Windows 套件偵錯工具的一部分。如需詳細資訊，請參閱 Windows 偵 錯。
-k
導致 BinPlace 保留檔案屬性。 根據預設，BinPlace 會關閉封存屬性。
-n FullSymbolRoot
指定完整符號檔的根目錄（包含公用和私人符號的符號檔）。 這也需要 -a、 -x 和 -s 參數。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。
-o RootSubdirectory
指定要使用之根目的地目錄的子目錄。 建立目的地目錄時， RootSubdirectory 會在根目的地目錄和類別子目錄之前插入。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。
-p PlaceFile
指定位置檔案的路徑和檔名。 如果未使用 -p 參數，BinPlace 會使用名為 \tools\placefil.txt的位置。 如需位置檔案內容的說明，請參閱 放置檔案語法 。
注意 -p 參數和放置檔案現在已過時，不應使用。
-q
防止 BinPlace 使用記錄檔。 如果省略 -q 參數，BINPLACE_LOG環境變數指定的檔案會當做記錄檔使用。
-r RootDestinationPath
指定根目的地目錄。 如果省略此專案，則預設值是由 x86 型、Itanium 型或 x64 型電腦上的_NT386TREE、_NTIA64TREE或_NTAMD64TREE環境變數所決定。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。
-s SymbolRoot
指定符號檔的根目錄。 如果也使用 -a 和 -x 參數，則會將私人符號從符號檔中去除，而等量符號檔會放在 SymbolRoot 所指定的目錄中。 如果您想要將帶狀符號檔和完整符號檔放在一起，您應該使用 -a -x -s SymbolRoot -n FullSymbolRoot。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。
-t
測試模式。 使用此參數時，不會複製任何檔案，但 BinPlace 會顯示警告和錯誤訊息，就像放置檔案一樣。 您也可以使用 -v 參數來增加訊息數目。
-u
導致 BinPlace 將 \up 附加至類別子目錄。 這適用於分離出單處理器 （UP） 驅動程式。 此外，每當使用此參數時，BinPlace 將不會分割包含符號的可執行檔。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。
-v
詳細資訊模式。 導致 BinPlace 顯示更詳細的錯誤、警告和進度訊息。
-w
導致 BinPlace 將 Windows 95 符號檔 （.sym） 新增至符號樹狀結構。
-x
如果 BinPlace 遇到使用 舊符號系統的檔案，這個參數會使它從可執行檔中移除所有符號，並將此資訊移至不同的符號檔。 如需詳細資訊，請參閱 符號文件系統 。 使用 -x 參數時，您也必須使用 -s 和 -a 。
-y
防止 BinPlace 使用任何類別子目錄。 目的地目錄只會從根目的地目錄加上文件類型子目錄建立。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。
-z
取消 -x 參數。 如果您在數個目標上使用 BinPlace，您可以使用 binplace 自變數Target1argumentsTarget2 的命令，而且命令行是從左至右剖析，Target1 和 Target2 將受到不同自變數的影響。 （請參閱下列剖析順序一節）。 如果遇到 -z 參數，這會取消任何先前 -x 參數的效果。
-ci ReturnCode，Application，Argument，Argument， ...
導致 BinPlace 使用自訂應用程式來驗證所有可執行檔。 如果您想要 BinPlace 使用其他應用程式來執行驗證，可以使用 -ci 參數。
ReturnCode 應該是這個應用程式在可執行檔中找到錯誤時所傳回的值。 其他參數是用來啟動此應用程式。 這些都必須以逗號分隔。 應用程式 會指定程序的名稱。 這後面可以接著任意數目的命令行自變數。 程式會以包含Application的命令行開始，後面接著所有自變數（以空格分隔，而不是逗號），最後以要檢查的可執行檔名稱結尾。
-：弧
讓 BinPlace 只放置封存屬性已設定的檔案。
-:D BG
防止 BinPlace 放置 .dbg 檔案。 如果也使用 -j 參數，這會防止 BinPlace 放置指向 .dbg 檔案的二進位檔。 若要使用此選項，SymChk 工具必須位於您的路徑中。 （SymChk 是 Windows 套件偵錯工具的一部分。如需詳細資訊，請參閱 Windows 偵 錯。
-:D EST ClassPath
導致 BinPlace 忽略放置檔案，並使用指定的 ClassPath 做為類別子目錄。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。
-：LOGPDB
導致 BinPlace 在記錄檔中包含完整的 .pdb 路徑。
-：任 NewName
導致 BinPlace 重新命名放置的檔案。 源檔名稱，包括擴展名，將會取代為 NewName。 （如果源檔是正在分割的可執行檔，新的符號檔會提供源檔名稱加上擴展名 .dbg。
-：TMF
讓 BinPlace 從 PDB 符號檔擷取追蹤訊息格式指示，以建立追蹤訊息格式 （.tmf） 檔案。 TMF 檔案會放在 BinPlace TRACE_FORMAT_PATH 環境變數所指定的目錄中。 請參閱 BinPlace 宏和環境變數。
-ChangeAsmsToRetailForSymbols
如果字串 「retail」 發生在符號檔的目的地目錄中，則會導致 BinPlace 將字串 「asms」 取代為 「retail」。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。
檔
指定 BinPlace 將執行之檔案的完整路徑和檔名。 您可以列出任意數目的檔案，並以空格分隔。 如果路徑和檔名包含空格，您必須以引弧括住路徑和檔名。
@PlaceFile
如果有任何檔名前面加上 at sign （ @ ，則檔名代表位置檔案的名稱。 如需詳細資訊，請參閱下列檔案一節中的提供參數。
剖析順序
BinPlace 會從左至右剖析命令行。 您可以指定數個選項、檔案參數、新選項、另一個 File 參數等等。 每次 BinPlace 遇到新的選項時，都會採用它，覆寫任何先前看到的矛盾選項。 每當遇到 檔案 規範時，它會使用已在命令行上遇到的累積選項，對該檔案採取行動。
在檔案中提供參數
您可以從文字文件將參數傳遞至 BinPlace。 作法有二：
您可以在BINPLACE_OVERRIDE_FLAGS環境變數中指定檔名。 每當執行 BinPlace 時，就會讀取此檔案及其內容作為參數。 此檔案中的參數會在實際出現在 BinPlace 命令行的參數之前剖析。
您可以在 BinPlace 命令列上指定檔名，方法是在前面加上符號 （ @ ）。 當 BinPlace 在其命令行上看到開頭為此符號的字串時，它會取得字串、移除 at sign，然後尋找具有此名稱的檔案。 如果它找到這個檔案，它會將其文字插入命令行，正好位於原始參數開頭為 at 符號的位置。 由於 BinPlace 會從左至右剖析參數，因此您可以使用這項技術以及多個 File 實例，在具有不同選項的數個檔案上使用 BinPlace，而不需要每次輸入所有選項。 （如果找不到此檔案，BinPlace 會將原始字串，包括 at 符號 視為檔案 參數。）