cloneEnvironment

複製目前環境和 (選擇性) 識別網域物件 (使用者和應用程式角色指派)、資料管理記錄、稽核記錄、工作主控台記錄、應用程式特性、收件匣和寄件匣的內容以及儲存的快照。此命令是使用「複製環境」功能的替代方法。

在來源與目標環境的排定每日維護之後起始複製。如果來源環境的每日維護在複製程序執行時啟動，則複製程序將會終止。即使每日維護在複製程序執行時啟動，目標環境上的複製程序也不會受影響。在此案例中，每日維護將會在複製完成後執行。

如果複製您的環境花費很長的時間，請在來源環境上重新排程每日維護開始時間，以避免發生複製程序終止的情況。請參閱這些資訊來源以取得重設每日維護開始時間的資訊。

Note:

  • 資料管理：如果臨時資料表包含大量記錄，則複製資料管理記錄可能需要很長時間。同樣，複製收件匣和寄件匣的內容以及儲存的快照可能需要相當長的時間，尤其是當它們包含大量的資料。
  • Planning：如果 Planning 商業程序包含已重新命名並被自訂期間成員取代的內建期間成員，則複製可能會失敗。例如，您將內建的 YearTotal 期間成員重新命名為 unused_YearTotal，然後新增具有原始內建成員名稱 (在此範例中為 YearTotal) 的替代類型期間成員。在此情況下，複製環境時可能會失敗。

如需有關這些主題的詳細資訊，請參閱管理移轉 中的複製 Cloud EPM 環境。

適用於

Planning、Planning 模組、FreeForm、Financial Consolidation and Close、Tax Reporting、Account Reconciliation、Profitability and Cost Management、Enterprise Profitability and Cost Management、Oracle Enterprise Data Management Cloud、Narrative Reporting、Sales Planning 及 Strategic Workforce Planning。

必要角色

  • 服務管理員
  • 任何應用程式角色與「移轉 - 管理」精細角色

用法

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 模組、FreeForm、Financial Consolidation and Close、Tax Reporting、Enterprise Profitability and Cost Management、Sales Planning 和 Strategic Workforce Planning。
  • appAudit 參數僅適用於 Planning、Planning 模組、FreeForm、Enterprise Profitability and Cost Management、Sales Planning 和 Strategic Workforce Planning。

    Financial Consolidation and Close 和 Tax Reporting 的稽核資訊是預設包含在快照中。

  • 如果 dataManagement、jobConsole 或 appAudit參數不適用於某個環境，則命令會忽略您指定的值。
  • ApplicationProperties 參數僅適用於 Account Reconciliation。
  • TARGET_USERNAME 是目標環境服務管理員的 ID。您必須使用目標身分識別網域使用者名稱 (而非 SSO 使用者名稱)。

    Note:

    若要複製使用者和角色指派，此使用者必須是指派給識別網域管理員角色的服務管理員。
  • TARGET_PASSWORD 是儲存由 TARGET_USERNAME 所識別之使用者的加密密碼或 OAuth 2.0 重新整理憑證的檔案名稱與位置。

    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