ALTER APPLICATION PACKAGE ...RELEASE DIRECTIVE¶

修改现有应用程序包的属性。使用此命令将发布指令修改为新版本或补丁。

备注

本主题中描述的语法仅适用于不使用发布通道的应用程序包。若要为使用发布通道的应用程序包修改发布指令，请参阅 ALTER APPLICATION PACKAGE ... MODIFY RELEASE CHANNEL。

另请参阅：: ALTER APPLICATION PACKAGE、ALTER APPLICATION PACKAGE ...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

指定要为应用程序包设置的一个（或多个）属性（用空格、逗号或换行符分隔）。有关可设置的属性的更多详细信息，请参阅 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 }

When set to TRUE, upgrades respect consumer maintenance policies. Instead of upgrading immediately, the upgrade is delayed until the consumer's next maintenance window or until the upgrade deadline is reached, whichever comes first.

When this parameter is set to TRUE, the UPGRADE_DEADLINE parameter is required.

You can't set the UPGRADE_AFTER and UPGRADE_IN_MAINTENANCE_WINDOW parameters at the same time. If you try to set both, the command fails with an error.

For more information, see 使用者控制的维护策略：提供商指南.

UPGRADE_DEADLINE = 'timestamp'

Required when UPGRADE_IN_MAINTENANCE_WINDOW is set to TRUE. Specifies the deadline by which the upgrade must be completed. After this time, the system automatically upgrades the application regardless of the consumer's maintenance policy.

Set the deadline to a date and time that allows sufficient time for consumers to complete the upgrade within their maintenance windows.

UNSET

指定要为应用程序包取消设置的一个（或多个）属性和/或会话参数，这会将它们重置为默认值。

UNSET RELEASE DIRECTIVE release_directive: 从应用程序包中移除指定的自定义发布指令。

使用说明¶

修改发布指令需要具有应用程序 OWNERSHIP 权限或全局 MANAGE VERSIONS 权限。
如未为可选属性指定值，该命令将使用应用程序清单文件中指定的值。

如果在命令和应用程序清单文件中均指定了属性值，则优先采用命令中指定的值。