使用参数文件传递用于执行命令的值

关于参数文件

每个命令都需要自己的参数文件，因为参数因命令而异。例如，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 - 选项可启用多行输入，这允许您在多行中传递命令参数。指定所有命令参数后，在新行中输入 +（加号字符）以开始执行命令。下面是一个示例：