ALTER APPLICATION PACKAGE ... RELEASE DIRECTIVE¶

既存のアプリケーションパッケージのプロパティを変更します。リリースディレクティブを新しいバージョンやパッチに変更するには、このコマンドを使用します。

注釈

このトピックで説明する構文は、リリースチャネルを使用しないアプリケーションパッケージにのみ適用されます。リリースチャネルを使用するアプリケーションパッケージのリリースディレクティブを変更するには、 ALTER APPLICATION PACKAGE ... MODIFY RELEASE CHANNEL をご参照ください。

こちらもご参照ください。: ALTER APPLICATION PACKAGE、 ALTERAPPLICATIONPACKAGE ... VERSION

構文¶

ALTER APPLICATION PACKAGE <name>
  MODIFY RELEASE DIRECTIVE <release_directive>
  VERSION = <version_identifier>
  PATCH = <patch_num>
  [ UPGRADE_AFTER = '<timestamp>' ]
  [ UPGRADE_IN_MAINTENANCE_WINDOW = { TRUE | FALSE } ]
  [ UPGRADE_DEADLINE = '<timestamp>' ]

ALTER APPLICATION PACKAGE <name>
  SET DEFAULT RELEASE DIRECTIVE
  VERSION = <version_identifier>
  PATCH = <patch_num>
  [ UPGRADE_AFTER = '<timestamp>' ]
  [ UPGRADE_IN_MAINTENANCE_WINDOW = { TRUE | FALSE } ]
  [ UPGRADE_DEADLINE = '<timestamp>' ]

ALTER APPLICATION PACKAGE <name>
  SET RELEASE DIRECTIVE <release_directive>
  ACCOUNTS = ( <organization_name>.<account_name> [ , <organization_name>.<account_name> , ... ] )
  VERSION = <version_identifier>
  PATCH = <patch_num>
  [ UPGRADE_AFTER = '<timestamp>' ]
  [ UPGRADE_IN_MAINTENANCE_WINDOW = { TRUE | FALSE } ]
  [ UPGRADE_DEADLINE = '<timestamp>' ]

ALTER APPLICATION PACKAGE <name> UNSET RELEASE DIRECTIVE <release_directive>

パラメーター¶

name

アプリケーションパッケージの識別子を指定します。識別子にスペース、特殊文字、または大文字と小文字が混在する場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

MODIFY RELEASE DIRECTIVE release_directive . VERSION = version_identifier . PATCH = patch_num

指定されたカスタムリリースディレクティブのバージョンとパッチレベルを変更します。

SET

アプリケーションパッケージに設定する1つ（または複数）のプロパティを指定します（空白、コンマ、または改行で区切り）。設定できるプロパティの詳細については、 CREATE APPLICATION をご参照ください。

DEFAULT RELEASE DIRECTIVE VERSION = version_identifier PATCH = patch_num

デフォルトでコンシューマーにインストールされる、アプリケーションパッケージのバージョンとパッチレベルを設定します。

RELEASE DIRECTIVE release_directive . ACCOUNTS = ( organization_name.account_name [ , organization_name.account_name , ... ] ) . VERSION = version_identifier . PATCH = patch_num

指定されたアカウントのカスタムリリースディレクティブを作成します。

ACCOUNTS 句を使用して、このリリースディレクティブが適用されるアカウントのリストを指定します。

これらのアカウントにインストールするバージョン識別子とパッチ番号を指定するには、 VERSION と PATCH 句を使用します。

UPGRADE_AFTER = 'timestamp'

自動アップグレード処理を開始する日時を指定します。コンシューマーは、この日までにアプリを新しいバージョンまたはパッチに手動でアップグレードすることができます。

この値には、有効な日付と時刻の形式を指定できます。

UPGRADE_IN_MAINTENANCE_WINDOW = { TRUE | FALSE }

TRUE に設定した場合、アップグレードはコンシューマーのメンテナンスポリシーに従います。すぐにアップグレードするのではなく、コンシューマーの次のメンテナンスウィンドウまたはアップグレード期限のいずれか早い方まで延期されます。

このパラメーターを TRUE に設定すると、 UPGRADE_DEADLINE パラメーターが必須になります。

UPGRADE_AFTER および UPGRADE_IN_MAINTENANCE_WINDOW パラメーターを同時に設定することはできません。両方を設定しようとすると、コマンドはエラーで失敗します。

詳細については、コンシューマー管理のメンテナンスポリシー：プロバイダーガイドをご参照ください。

UPGRADE_DEADLINE = 'timestamp'

UPGRADE_IN_MAINTENANCE_WINDOW が TRUE に設定されている場合に必須です。アップグレードを完了する期限を指定します。この期限を過ぎると、システムはコンシューマーのメンテナンスポリシーに関係なく、アプリケーションを自動的にアップグレードします。

期限は、コンシューマーがメンテナンスウィンドウ内にアップグレードを完了するのに十分な時間を確保する日付と時刻に設定します。

UNSET

アプリケーションパッケージの設定を解除する1つ（または複数）のプロパティやセッションパラメーターを指定します。これにより、デフォルトにリセットされます。

UNSET RELEASE DIRECTIVE release_directive: アプリケーションパッケージから指定されたカスタムリリースディレクティブを削除します。

使用上の注意¶

リリースディレクティブを変更するには、アプリケーションの OWNERSHIP 権限か、 MANAGE VERSIONS グローバル権限が必要です。
オプションのプロパティの値を指定しない場合、コマンドはアプリケーションマニフェストファイルで指定された値を使用します。

コマンドとアプリケーションマニフェストファイルでプロパティに値を指定した場合は、コマンドで指定した値が優先されます。