J.2 使用该工具之前

本节包含下列信息：

J.2.1 在 Migrate Server 中预先配置 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 Server 的设置，调整该文件中的值。

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	显示迁移服务器的许可证信息。
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 客户端的“作业”视图中看到的信息类型相同。