J.2 使用工具之前

本節包含以下資訊：

J.2.1 在 Migrate 伺服器中預先設定 CLI 的值

在使用指令行公用程式之前，需確定已正確設定 Migrate 伺服器。您可以在 PlateSpin.Migrate.Console.exe.config 檔案 (位於指令行公用程式所在的同一路徑下) 中檢查組態。安裝 Migrate 後，下面的 .config 檔案中應已填入一些值。

<?xml version="1.0" encoding="utf-8 ?>"
<configuration>
  <appSettings>
    <add key="MigrateServerURL" value="https://localhost/PlateSpinMigrate/"/>
    <add key="ServerDomain" value=""/>
    <add key="psuser" value="administrator"/>
    <add key="pspassword" value="encoded_password"/>
    <add key ="encoded" value="yes"/>
  </appSettings>
</configuration>

該工具會在執行指令時使用這些值。您需要根據所要連接之 Migrate 伺服器的設定，調整該檔案中的值。

pspassword 鍵的值預設為空白，您必須指定一個編碼密碼做為其值。若要編碼密碼，請使用 encode 指令。如需有關指令的詳細資訊，請參閱節 J.2.2, 熟悉各項指令。

如果您選擇為來源工作負載和目標平台提供編碼密碼，請在 PlateSpin.Migrate.Console.exe.config 檔案中，將下面一行中編碼鍵的值設定為 yes，否則設定為 no。

J.2.2 熟悉各項指令

您可以在指令提示字元處，使用 Help 選項或 ? 選項來執行該工具，由此顯示該工具支援的指令。例如：

C:\Program Files\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe Help

該工具會顯示一個矩陣，其中包含類似於下表中所示的資訊：

表 J-1 可從 Migrate CLI 工具使用的指令

指令	描述
run	將設定的 .ini 檔案做為一項已排程的工作執行。當您新增 /wait=no 參數且工作開始執行時，其工作 ID 會顯示在介面中。
query	對工作執行查詢 (指定工作 ID 時) 以顯示其目前狀態。
discover	在準備移轉或「轉換」工作時，執行一項操作來清查某個受支援工作負載或目標電腦的詳細資料。
refresh	重新整理探查到的伺服器。
unDiscover	取消探查伺服器。
imageserver	對伺服器上的工作負載執行影像操作 (即安裝伺服器、解除安裝伺服器、更新工具)。
abort	中止排程的工作。
licenseInfo	顯示 Migrate 伺服器的授權資訊。
serversync	為伺服器進行伺服器同步操作準備，然後使用組態檔案執行 serversync 工作。
encode	編碼文字輸入或文字檔中的資料。
massdiscover	對來源工作負載和目標執行大量探查。探查到的工作負載和目標會在 PlateSpin Migrate 用戶端以及 PlateSpin Migrate Web 介面中顯示。若要大量探查工作負載和目標，您必須先在 CSV 檔案中列出想要探查的工作負載和目標。若要建立此 CSV 檔案，請參考位於 \PlateSpin Migrate Client\CommandLine\Sample INI\MassDiscovery.csv 的 CSV 檔案範例。

在執行上述任一指令時，您必須在指令行中包含該指令的必要參數，也可以根據需要包含一些選擇性參數。例如，使用 savejob= 參數可將工作保存到預設的位置。

若要在指令提示字元處顯示這些參數的清單，請執行不帶任何參數的指令。例如，如果執行如下所示不帶參數的 discover 指令：

C:\Program Files\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe discover

指令行介面會顯示以下內容：

[discover]                      探查伺服器 
必需的參數︰
    /machineAddress=  要探查的機器位址 
    /userName=        要使用的使用者名稱 
    /password=        要使用的密碼 
    /type=            諸如 windows、linux、vmware_esx、vmware_vcenter 
    的類型 選擇性參數︰
    /network=         要連接的網路名稱 
    /address=         要連接的伺服器位址 
    /psuser=          用於存取 PlateSpin Migrate 伺服器的使用者名稱，與登入此電腦的使用者名稱不同 
    /pspassword=      用於存取 PlateSpin Migrate 伺服器的密碼，與登入此電腦的使用者的密碼不同 
    /wait=            等待工作完成 [是，否] 
    /clusterName=     要探查的叢集名稱 
    /verbose=         詳細輸出模式 [開，關] 
    /output=          輸出檔案 
    /format=          要顯示的輸出格式 [文字、html、xml] 
    /sslcertificatewarnings=      忽略還是強制執行 SSL 證書警告 [忽略 | 執行]

附註：您應該熟悉各個 CLI 指令，及其相應的必要參數和選擇性參數。

指令行語法

如果您要執行 discover 指令 (同時也是一個工作)，可以在指令提示字元處使用如以下範例所示的語法：

C:\Program Files\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe discover /machineaddress=10.10.8.100 /username=administrator /password=password /type=windows /wait=no

請注意，此範例包含了所有必要參數和一個選擇性參數。

當 discover 指令 (工作) 啟動時，CLI 工具會顯示其工作 ID，如以下範例所示：

8be8d306-7665-4869-9795-a9dbb3ce1471

您可以利用此 ID 來瞭解工作的狀態，只需使用如下所示的 query 指令即可：

C:\Program Files\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe query /id=8be8d306-7665-4869-9795-a9dbb3ce1471

該 query 指令會產生一份狀態報告，其中包含工作的所有詳細資料。此類資訊可能與 Migrate 用戶端「工作」檢視窗中顯示的資訊相同。