cloneEnvironment

克隆当前环境和（可选）身份域对象（用户和应用程序角色分配）、数据管理记录、审核记录、作业控制台记录、应用程序属性、收件箱和发件箱的内容以及存储的快照。此命令是使用“克隆环境”功能的替代方法。

在源或目标环境的预定日常维护时间之后启动克隆操作。如果在克隆正在进行中时开始对源环境进行日常维护，则克隆过程将终止。即使在日常维护开始时克隆正在进行，目标环境上的克隆过程也不会受到影响。在这种情况下，将在克隆完成后运行日常维护。

如果克隆环境需要很长时间，请重新调度源环境上的日常维护开始时间，以避免克隆过程被终止。有关重置日常维护开始时间的信息，请参阅以下信息源。

Note:

  • 数据管理： 如果临时表包含大量记录，克隆数据管理记录可能需要很长时间。类似地，克隆收件箱和发件箱的内容以及存储的快照可能需要大量时间，尤其当它们包含大量数据时更是如此。
  • Planning：如果 Planning 业务流程包含重命名的植入期间成员而原始成员已被自定义期间成员取代，克隆可能会失败。例如，您将植入的 YearTotal 期间成员重命名为 unused_YearTotal 后，添加了使用原始植入成员名称（在此示例中为 YearTotal）的备用类型期间成员。在这种情况下，环境克隆可能会失败。

有关这些主题的详细信息，请参阅《管理迁移》中的“克隆云 EPM 环境”。

适用于

Planning、Planning 模块、自由形式、Financial Consolidation and Close、Tax Reporting、Account Reconciliation、Profitability and Cost Management、Enterprise Profitability and Cost Management、Oracle Enterprise Data Management Cloud、Narrative Reporting、销售规划和战略性人员规划。

所需角色

  • 服务管理员
  • 任何应用程序角色和“迁移 - 管理”细粒度角色

用法

epmAutomate cloneEnvironment TARGET_USERNAME TARGET_PASSWORD TARGET_URL [SnapshotName=NAME] [environmentBackup=NAME] [UsersAndPredefinedRoles=true|false] [DataManagement=true|false] [appAudit=true|false] [jobConsole=true|false] [storedSnapshotsAndFiles=true|false] [DailyMaintenanceStartTime=true|false] [ApplicationProperties=true|false]，其中：

Note:

  • dataManagement 参数不适用于 Oracle Enterprise Data Management Cloud 和 Narrative Reporting 环境。

    仅当源环境和目标环境的每月更新相同或目标环境比源环境多更新一次时，才可以克隆数据管理记录。例如，22.01 数据管理记录可以克隆到其他 22.01 环境，或者仅克隆到 22.02 环境。

  • jobConsole 参数仅适用于 Planning、Planning 模块、自由形式、Financial Consolidation and Close、Tax Reporting、Enterprise Profitability and Cost Management、销售规划和战略性人员规划。
  • appAudit 参数仅适用于 Planning、Planning 模块、自由形式、Enterprise Profitability and Cost Management、销售规划和战略性人员规划。

    默认情况下，Financial Consolidation and Close 和 Tax Reporting 的审核信息包含在快照中。

  • 如果 dataManagement、jobConsole 或 appAudit 参数不适用于环境，该命令将忽略您指定的值。
  • ApplicationProperties 参数仅适用于 Account Reconciliation。
  • TARGET_USERNAME 是目标环境中的服务管理员的 ID。您必须使用目标身份域用户名（而非 SSO 用户名）。

    Note:

    要克隆用户和角色分配，此用户必须是分配有身份域管理员角色的服务管理员。
  • TARGET_PASSWORD 是用于存储用户的加密密码或 OAuth 2.0 刷新令牌的文件的名称和位置，该用户由 TARGET_USERNAME 标识。

    Note:

    Oracle 建议使用 OAuth 2.0 进行身份验证，而不是使用基本身份验证，因为 OAuth 2.0 更安全。

  • TARGET_URL 是要成为克隆环境的环境的 CLOUD-EPM_BASE_URL。
  • SnapshotName（可选）是维护快照的名称。此快照必须存在于源环境中。使用 restoreBackup 命令复制存档的快照。指定此值或 EnvironmentBackup 的值，而不是同时指定两者。

    Note:

    使用 listBackups 命令查看环境中可用的备份快照和环境备份的列表。
  • EnvironmentBackup（可选）是 Oracle Object Storage 中存在的环境备份的名称。指定此值或 Artifact Snapshot 的值，而不是同时指定两者。

    Note:

    如果未指定 SnapshotName 或 EnvironmentBackup 的值，该命令将使用最后一个维护快照来克隆环境。
  • UsersAndPredefinedRoles（可选）标识是否克隆用户及其应用程序角色分配（始终克隆细粒度角色分配）。默认值为 false。

    要让此选项生效，TARGET_USER_NAME 标识的用户必须在目标环境中具有身份域管理员角色。

    如果在选中此复选框后，克隆环境的用户不是身份域管理员，则导入用户及其应用程序角色将失败。迁移状态报表中将记录以下错误：无法导入外部目录对象 <artifact_name>。用户 <user_name> 无权执行此操作。用户必须具有身份域管理员角色才能执行此操作。
    • 如果您不导入用户，并且源快照中的用户未分配目标环境中的应用程序角色，则将显示错误 (EPMIE-00070: 在分配的角色导入过程中无法找到用户)。
    • 不会克隆身份域管理员角色分配。仅分配了身份域管理员角色的用户不会克隆到目标环境。

      将会克隆在源环境中分配到身份域管理员角色和应用程序角色组合的用户，但在目标环境中这些用户仅分配到各自的应用程序角色。这些用户在目标环境中将没有身份域管理员角色。

    • 对用户应用程序角色的更改将根据源快照中分配的角色进行更新。但是，不会为了匹配源快照中的角色分配而删除目标中的角色分配。例如，假定 jdoe 在目标环境中分配到超级用户应用程序角色，但在源快照中只有用户角色。在这种情况下，此命令会将 jdoe 分配给用户角色，并且不会删除目标环境中的超级用户角色分配。
    • 如果源快照中不存在现有用户，此命令不会从目标环境中删除这些用户。例如，jdoe 在目标环境中有一个帐户，但此帐户在源快照中不存在。在这种情况下，目标环境中 jdoe 的该帐户不会被删除。
    • 此命令添加目标环境中不存在的用户；它不会更新目标环境中的当前用户属性，即使源快照中的这些属性不同。例如，如果源快照中 jdoe 的姓氏在目标环境中拼写不同，则不会在目标环境中进行更改。随机密码将分配给目标环境中的新用户。新用户将收到提示其更改密码的帐户激活电子邮件。
    • 此命令不会更改目标环境中现有用户的密码，即使它在源快照中有所不同。
  • dataManagement=true|false（可选）将源环境中的数据管理记录克隆到目标环境。默认值为 true，即克隆数据管理记录。如果不希望克隆数据管理记录，请将此值设置为 false。
  • appAudit=true|false（可选）将源环境中的审核记录克隆到目标环境。默认值为 true，即克隆应用程序审核数据。如果不希望将应用程序审核数据克隆到目标环境，请将此值设置为 false。
  • jobConsole=true|false（可选）将源环境中的作业控制台记录克隆到目标环境。默认值为 true。如果不希望克隆作业控制台记录，请将此值设置为 false。
  • storedSnapshotsAndFiles（可选）标识命令是否应该克隆收件箱和发件箱的内容以及存储的快照。默认值为 false。

    Note:

    仅克隆收件箱和发件箱中的顶层文件夹，而不克隆子文件夹。如果需要保留子文件夹的内容，请将它们备份到本地计算机，然后将它们上传到目标环境。
  • DailyMaintenanceStartTime（可选）将克隆的目标环境的维护开始时间重置为源环境的维护开始时间。默认值为 true。要保持目标环境的当前维护开始时间，请将此值设置为 false。
  • ApplicationProperties（可选）克隆 Account Reconciliation 应用程序设置（电子邮件通知开/关设置、Redwood 体验、主题、业务流程名称、标识图像和背景图像）。默认值为 true。

    为了使目标环境保留其当前的应用程序设置，请将此值设置为 false。

示例

  • 使用环境备份克隆环境、用户和应用程序角色分配、审核数据、作业控制台记录以及数据管理记录。此外，还将目标环境的维护开始时间更改为源环境的维护开始时间：

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com environmentBackup=2026-03-11T16:30:37/Environment_Backup UsersAndPredefinedRoles=true

  • 使用特定备份快照克隆环境、用户和应用程序角色分配、审核数据、作业控制台记录以及数据管理记录。此外，还将目标环境的维护开始时间更改为源环境的维护开始时间：

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com SnapshotName=2026-03-11T16:34:52/Artifact_Snapshot UsersAndPreDefinedRoles=true

  • 使用最后一个对象快照克隆环境（包括收件箱和发件箱的内容以及存储的快照），但不克隆用户和应用程序角色分配、数据管理记录、审核数据以及作业控制台记录，并且不更改目标环境的维护开始时间：

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com DataManagement=false appAudit=false jobConsole=false storedSnapshotsAndFiles=true DailyMaintenanceStartTime=false

  • 使用自定义快照克隆整个环境（用户和应用程序角色分配、审核数据、作业控制台记录、收件箱和发件箱内容、存储的快照以及数据管理记录）。此外，还将目标环境的维护开始时间更改为源环境的维护开始时间：

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com UsersAndPreDefinedRoles=true storedSnapshotsAndFiles=true SnapshotName=SampleSnapshot

  • 仅限 Account Reconciliation ：克隆环境、用户和应用程序角色分配，以及数据管理记录，但保留目标环境的应用程序设置：

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudarcs.arcs.epm.us.oraclecloud.com UsersAndPreDefinedRoles=true ApplicationProperties=false