使用參數檔來傳送用於執行命令的值

關於參數檔

每個命令都需要自己的參數檔，因為參數會因命令而異。例如，copyFromObjectStorage 命令與 copyFromSFTP 命令所使用的參數是不同的。

命令參數是位置性的，代表您必須以特定的順序提供參數。每個命令的參數檔，都必須遵循該命令之必要參數的用法樣式和順序。選擇性參數是在必要參數之後指定，而且可依任意順序列出。

例如，使用加密密碼來執行 login 命令時，必要參數的用法樣式如下：

epmautomate login USERNAME PASSWORD_FILE URL

serviceAdmin 
C:\mySecuredir\password.epw 
https://test-cloud-pln.pbcs.us1.oraclecloud.com

C:\mySecuredir\password.epw 
https://test-cloud-pln.pbcs.us1.oraclecloud.com

建立參數檔

參數檔的內容必須符合使用該檔案之命令的用法樣式。由於必要參數是位置性的，請確保它們的列出順序與用法樣式中指示的順序完全相同。

若要建立參數檔，請執行下列動作：

1. 使用文字編輯器建立新檔案，並將該檔案儲存在某個資料夾中。
2. 複製您要建立之參數檔所屬命令的用法樣式，然後貼到您在上一個步驟建立的文字檔中。例如，如果您要為 cloneEnvironment 命令建立參數檔，則用法樣式如下：

   epmAutomate cloneEnvironment TARGET_USERNAME TARGET_PASSWORD
   TARGET_URL [SnapshotName=NAME] [UsersAndPreDefinedRoles=true|false]
   [DataManagement=true|false] [appAudit=true|false] [jobConsole=true|false]
   [storedSnapshotsAndFiles=true|false] [DailyMaintenanceStartTime=true|false]
   [ApplicationProperties=true|false]

3. 編輯該檔案：
   1. 刪除第一個必要參數前面的文字；在此範例中，請刪除 epmAutomate cloneEnvironment
   2. 以您要使用的值取代每個必要參數。
   3. 以您要使用的值取代每個選擇性參數。
   4. 刪除您不想使用的選擇性參數。EPM Automate 將會使用其預設值。
   5. 在每個必要參數和選擇性參數值的後方插入分行符號。

      例如，您檔案的內容可能會類似：

      serviceAdmin
      Password.epw
      https://epm-test-ociarcs.epm.us.region.ocs.oc-test.com 
      UsersAndPreDefinedRoles=true
      ApplicationProperties=false
      storedSnapshotsAndFiles=true
      DailyMaintenanceStartTime=false
      

4. 儲存該參數檔。

搭配命令來使用參數檔

使用 -p FILE_NAME 選項，將參數檔傳送給命令。

-p FILE_NAME 選項在命令中的位置可決定檔案內容的使用方式。EPM Automate 會在 -p FILE_NAME 選項出現的位置插入參數檔的內容。

當您使用包含所有必要參數值的 login_encrypted.txt 參數檔 (請參閱上一節) 時，您將執行下列命令來啟動階段作業：

epmautomate login -p login_encrypted.txt

當您使用省略 username 必要參數值的 new_login_encrypted.txt 參數檔 (請參閱上一節) 時，您將執行下列命令來啟動階段作業：

epmautomate login serviceAdmin -p new_login_encrypted.txt

以多行輸入參數

使用 -p - 選項來啟用多行輸入，讓您可以多行來傳送命令參數。指定所有命令參數之後，請在新的一行中輸入 + (加號字元)，以開始執行命令。範例如下：