1. コマンドライン・インタフェース
  2. Verbリファレンス
  3. EM CLI Verb
  4. update_swlib_directive_entity

update_swlib_directive_entity

ソフトウェア・ライブラリのディレクティブ・タイプのエンティティを変更します。デフォルトでは、エンティティの新しいリビジョンが作成されます。

書式

emcli update_swlib_directive_entity
      -entity_rev_id="entity_rev_id"
      [-arg]="[<arg prefix>;]<arg prop name>[;<arg suffix>]"
      [-shell_type]="<shell type>"
      -[not_]run_privileged
      -file="<abs/relative file path>[;<new file name>]" | [-removefile="<existing file name>"]
      [-upload_storage="<storage location name>;<storage type>"] | [-refer_ storage="<storage location name>;<storage type>"]
      [[-host="hostname"]
      [-credential_set_name="setname"] | [-credential_name="name" -credential_owner="owner"]
      [-desc="entity_desc"]
      [-attr="<attr name>:<attr value>"]
      [-note="note text"]
      [-use_latest_revision]
      [-show_entity_rev_guid]
      [-show_cmd_line_and_exit]

[ ] indicates that the parameter is optional.

パラメータ

  • entity_rev_id

    エンティティ・リビジョンの識別子。ソフトウェア・ライブラリ・ホームページには、フォルダとエンティティのIDがカスタム列(内部ID)として表示されます。ただし、これはデフォルトでは非表示です。

  • arg

    オプションの接頭辞または接尾辞(あるいはその両方)付きで指定したコマンドライン引数のプロパティ名。複数の引数を指定するには、オプションを繰り返します。

  • shell_type

    シェル・タイプは次のいずれかにすることができます。

    • SUB_Exec - スクリプト内に指定

    • SUB_Perl - Perl

    • SUB_Bash - Bash

      デフォルト値はSUB_Bash - Bashです。

  • run_privileged

    これは、ディレクティブを権限付きの資格証明で実行する必要があるかどうかを指定するオプションです。デフォルトでは、標準資格証明で実行されます。

  • file

    -upload_storageが指定されている場合、これはアップロードされるファイルの絶対パスです。-refer_storageが指定されている場合、これは指定した記憶域の場所から参照されるファイルの相対パスです。ファイルのアップロード後にソフトウェア・ライブラリに格納されているファイル名は、デフォルトで、アップロードまたは参照されるファイルの名前になります。オプションで「;」で区切って別のファイル名を指定できます。コマンドラインに指定した最初のファイルは、メイン・ファイルとしてデフォルト設定され、ディレクティブの実行時に実行されます。

  • removefile

    削除するファイルの名前。ここには、指定のエンティティ・リビジョンから継承された既存ファイルを指定します。または、次の値を指定できます。

    • ALL - すべての既存のファイルを削除します

    • NONE - すべての継承されたファイルを保持します

      デフォルト値はNONEです。

  • host

    ファイルが使用可能なホストのターゲット名。これは、-upload_storageオプションと組み合せて使用する必要があります。

  • credential_set_name

    管理リポジトリに格納されているホスト・ターゲット用の優先資格証明のセット名。これは、次のいずれかです。

    • HostCredsNormal: デフォルトの権限のない資格証明セット

    • HostCredsPriv: 権限付きの資格証明セット

      これは、upload_storageオプションと組み合せて使用する必要があります。

  • credential_name

    管理リポジトリに格納されている名前付き資格証明。このオプションは、-credential_ownerオプションとともに指定する必要があります。これは、-upload_storageオプションと組み合せて使用する必要があります。

  • credential_owner

    管理リポジトリに格納されている名前付き資格証明の所有者。このオプションは、-credential_nameオプションとともに指定する必要があります。これは、-upload_storageオプションと組み合せて使用する必要があります。

  • upload_storage

    「;」で区切られた、アップロード先の記憶域の場所とタイプ。指定した場所のステータスはアクティブである必要があります。デフォルトで、ソフトウェア・ライブラリ用に構成された最初のアップロード場所の記憶域のタイプと場所に設定されます。ストレージ・タイプは次のいずれかにすることができます。

    • OmsShared (OMS共有ファイル・システム)

    • OmsAgent (OMSエージェント・ファイル・システム)

  • refer_storage

    「;」で区切られた、ファイルを参照するための記憶域の場所とタイプ。指定した場所のステータスはアクティブである必要があります。ストレージ・タイプは次のいずれかにすることができます。

    • http

    • NFS

    • ExtAgent

    指定した場合、このオプションは-upload_storageオプションより優先されます。

  • desc

    エンティティの説明。新しい説明はすべての既存のリビジョンで表示できます。

  • attr

    属性とその値は「:」で区切ります。複数の属性を指定するには、オプションを繰り返します。

  • note

    エンティティについてのノート。複数のノートを指定するには、オプションを繰り返します。

  • use_latest_revision

    エンティティの最新リビジョンまたはentity_rev_idで識別されるリビジョンを更新するかどうかを指定するオプション。

  • show_entity_rev_guid

    新しいエンティティ・リビジョンの内部GUIDの出力を有効にするかどうかを指定するオプション。

  • show_cmd_line_and_exit

    コマンドラインを出力し、新しいエンティティ・リビジョンを作成せずに終了することを可能にするかどうかを指定するオプション。

例

次の例では、entity_rev_idで識別されるディレクティブ・エンティティを変更します。エンティティ・リビジョンのIDの値は、ソフトウェア・ライブラリのホームページで確認できます。ソフトウェア・ライブラリ・ホームページには、フォルダとエンティティのIDがカスタム列として表示されます。ただし、これはデフォルトでは非表示です。 

emcli update_swlib_directive_entity
     -entity_rev_id="oracle:defaultService:em:provisioning:1:cmp:COMP_        Directives:none:06865A85D99C5340E0530AD5F00A4E0F:0.6"
     -arg="-home :oh_home"
     -shell_type=SUB_Perl
     -file=/u01/scripts/myscript.pl
     -file=/u01/scripts/mymodule.pm;common.pm