迁移先决条件

在开始迁移之前，请确保您满足以下先决条件：

.NET Runtime 6.0

运行 UiPath.OrganizationMigrationApp 工具需要 .NET Runtime 6.0 或更高版本。在运行 UiPath.OrganizationMigrationApp 之前，您必须下载并安装它。

Linux

如果 .NET Runtime 6.0 或更高版本不存在，请先下载并安装适用于 Linux 的 .NET Runtime，然后再使用 UiPath.OrganizationMigrationApp。

要在 RHEL 上安装 .NET Runtime 6.0，请运行以下命令：

sudo yum install dotnet-sdk-6.0 -ysudo yum install dotnet-sdk-6.0 -y

Windows

UiPath.OrganizationMigrationApp 工具至少需要 .NET Runtime 6.0。如果 .NET Runtime 6.0 及更高版本不存在，请先下载并安装适用于 Windows 的 .NET Runtime 6.0，然后再使用 UiPath.OrganizationMigrationApp。

UiPath.OrganizationMigrationApp

UiPath.OrganizationMigrationApp 工具可帮助您执行操作，例如将所有租户的身份数据从独立移动到 Automation Suite 以及合并组织。

要下载 UiPath.OrganizationMigrationApp，请参阅下载安装包。

要查看哪个 UiPath.OrganizationMigrationApp 版本与您的环境兼容，请参阅兼容性矩阵。

用于管理 Microsoft SQL Server 的工具

您必须下载并安装 SQL Server Management Studio (SSMS) 或类似工具才能管理 Microsoft SQL Server。此工具可帮助您将 Orchestrator 数据库还原到 Automation Suite SQL Server 实例或其他 SQL Server 实例。

下载并安装 SQL Server Management Studio。
使用独立 SQL 连接字符串登录独立 SQL Server。
打开源数据库和目标数据库的端口 1433 。

连接字符串密码的特殊字符转义规则

在大多数情况下，连接密码都包含在单引号 (') 中。但是，当密码包含特殊字符（例如 ` 或 $）时，则需要采用不同的方法。

在这些情况下，密码的格式必须为 \`"<password>\`"，并将 <password> 替换为实际密码。此外，您还必须遵守下表中详述的转义规则：

ADDU 中的原始格式	PowerShell 字符串中的转义格式
`cn=James $ Smith`	"cn=James `$ Smith"
`cn=Sally Wilson + Jones`	`"cn=Sally Wilson \+ Jones"`
`cn=William O'Brian`	`"cn=William O'Brian"`
cn=William O`Brian	"cn=William O``Brian"
`cn=Richard #West`	`"cn=Richard #West"`
`cn=Roy Johnson$`	`"cn=Roy Johnson$"`

示例

假设原始密码为 7'8:<=XMe$y[@vC?_4ZeY8c-~y'W!1dU4gnczuf'/p>j<I。遵循特殊字符转义规则，它将变为：Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`"。

在目标连接字符串中配置了密码的完整命令如下所示：

./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "Server=tcp:abc.com,1433;Initial Catalog=UiPath_20230531;Persist Security Info=False;User ID=username;Password=asiodhyf;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;" -d "Server=tcp:cde.net,1433;Initial Catalog=AutomationSuite_Platform;Persist Security Info=False;User Id=testadmin@sfdev3980732-sql.database.windows.net;Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`""./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "Server=tcp:abc.com,1433;Initial Catalog=UiPath_20230531;Persist Security Info=False;User ID=username;Password=asiodhyf;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;" -d "Server=tcp:cde.net,1433;Initial Catalog=AutomationSuite_Platform;Persist Security Info=False;User Id=testadmin@sfdev3980732-sql.database.windows.net;Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`""