@salesforce/plugin-packaging 1.0.0 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (115) hide show
  1. package/CHANGELOG.md +32 -1
  2. package/README.md +749 -9
  3. package/lib/commands/force/package/beta/convert.d.ts +13 -0
  4. package/lib/commands/force/package/beta/convert.js +61 -0
  5. package/lib/commands/force/package/beta/convert.js.map +1 -0
  6. package/lib/commands/force/package/beta/create.d.ts +15 -0
  7. package/lib/commands/force/package/beta/create.js +87 -0
  8. package/lib/commands/force/package/beta/create.js.map +1 -0
  9. package/lib/commands/force/package/beta/delete.d.ts +14 -0
  10. package/lib/commands/force/package/beta/delete.js +61 -0
  11. package/lib/commands/force/package/beta/delete.js.map +1 -0
  12. package/lib/commands/force/package/beta/install/report.d.ts +15 -0
  13. package/lib/commands/force/package/beta/install/report.js +66 -0
  14. package/lib/commands/force/package/beta/install/report.js.map +1 -0
  15. package/lib/commands/force/package/beta/install.d.ts +22 -0
  16. package/lib/commands/force/package/beta/install.js +228 -0
  17. package/lib/commands/force/package/beta/install.js.map +1 -0
  18. package/lib/commands/force/package/beta/installed/list.d.ts +17 -0
  19. package/lib/commands/force/package/beta/installed/list.js +46 -0
  20. package/lib/commands/force/package/beta/installed/list.js.map +1 -0
  21. package/lib/commands/force/package/beta/list.d.ts +21 -0
  22. package/lib/commands/force/package/beta/list.js +90 -0
  23. package/lib/commands/force/package/beta/list.js.map +1 -0
  24. package/lib/commands/force/package/beta/uninstall/report.d.ts +10 -0
  25. package/lib/commands/force/package/beta/uninstall/report.js +33 -0
  26. package/lib/commands/force/package/beta/uninstall/report.js.map +1 -0
  27. package/lib/commands/force/package/beta/uninstall.d.ts +12 -0
  28. package/lib/commands/force/package/beta/uninstall.js +52 -0
  29. package/lib/commands/force/package/beta/uninstall.js.map +1 -0
  30. package/lib/commands/force/package/beta/update.d.ts +12 -0
  31. package/lib/commands/force/package/beta/update.js +51 -0
  32. package/lib/commands/force/package/beta/update.js.map +1 -0
  33. package/lib/commands/force/package/beta/version/create/list.d.ts +12 -0
  34. package/lib/commands/force/package/beta/version/create/list.js +40 -0
  35. package/lib/commands/force/package/beta/version/create/list.js.map +1 -0
  36. package/lib/commands/force/package/beta/version/create/report.d.ts +12 -0
  37. package/lib/commands/force/package/beta/version/create/report.js +87 -0
  38. package/lib/commands/force/package/beta/version/create/report.js.map +1 -0
  39. package/lib/commands/force/package/beta/version/create.d.ts +11 -0
  40. package/lib/commands/force/package/beta/version/create.js +200 -0
  41. package/lib/commands/force/package/beta/version/create.js.map +1 -0
  42. package/lib/commands/force/package/beta/version/delete.d.ts +15 -0
  43. package/lib/commands/force/package/beta/version/delete.js +64 -0
  44. package/lib/commands/force/package/beta/version/delete.js.map +1 -0
  45. package/lib/commands/force/package/beta/version/displayancestry.d.ts +13 -0
  46. package/lib/commands/force/package/beta/version/displayancestry.js +46 -0
  47. package/lib/commands/force/package/beta/version/displayancestry.js.map +1 -0
  48. package/lib/commands/force/package/beta/version/list.d.ts +12 -0
  49. package/lib/commands/force/package/beta/version/list.js +62 -0
  50. package/lib/commands/force/package/beta/version/list.js.map +1 -0
  51. package/lib/commands/force/package/beta/version/promote.d.ts +12 -0
  52. package/lib/commands/force/package/beta/version/promote.js +40 -0
  53. package/lib/commands/force/package/beta/version/promote.js.map +1 -0
  54. package/lib/commands/force/package/beta/version/report.d.ts +24 -0
  55. package/lib/commands/force/package/beta/version/report.js +209 -0
  56. package/lib/commands/force/package/beta/version/report.js.map +1 -0
  57. package/lib/commands/force/package/beta/version/update.d.ts +12 -0
  58. package/lib/commands/force/package/beta/version/update.js +60 -0
  59. package/lib/commands/force/package/beta/version/update.js.map +1 -0
  60. package/lib/commands/force/package1/beta/version/create/get.d.ts +9 -0
  61. package/lib/commands/force/package1/beta/version/create/get.js +48 -0
  62. package/lib/commands/force/package1/beta/version/create/get.js.map +1 -0
  63. package/lib/commands/force/package1/beta/version/create.d.ts +14 -0
  64. package/lib/commands/force/package1/beta/version/create.js +116 -0
  65. package/lib/commands/force/package1/beta/version/create.js.map +1 -0
  66. package/lib/commands/force/package1/beta/version/display.d.ts +9 -0
  67. package/lib/commands/force/package1/beta/version/display.js +55 -0
  68. package/lib/commands/force/package1/beta/version/display.js.map +1 -0
  69. package/lib/commands/force/package1/beta/version/list.d.ts +10 -0
  70. package/lib/commands/force/package1/beta/version/list.js +54 -0
  71. package/lib/commands/force/package1/beta/version/list.js.map +1 -0
  72. package/messages/default.md +1127 -0
  73. package/messages/package1_version_create.md +128 -0
  74. package/messages/package1_version_create_get.md +31 -0
  75. package/messages/package1_version_display.md +19 -0
  76. package/messages/package1_version_list.md +31 -0
  77. package/messages/package2.md +87 -0
  78. package/messages/package2_create.md +56 -0
  79. package/messages/package2_list.md +35 -0
  80. package/messages/package2_update.md +45 -0
  81. package/messages/package2_version_create.md +149 -0
  82. package/messages/package2_version_create_get.md +34 -0
  83. package/messages/package2_version_create_list.md +62 -0
  84. package/messages/package2_version_get.md +14 -0
  85. package/messages/package2_version_list.md +98 -0
  86. package/messages/package2_version_update.md +89 -0
  87. package/messages/package_convert.md +72 -0
  88. package/messages/package_create.md +90 -0
  89. package/messages/package_delete.md +63 -0
  90. package/messages/package_displayancestry.md +64 -0
  91. package/messages/package_install.md +178 -0
  92. package/messages/package_install_get.md +34 -0
  93. package/messages/package_install_report.md +34 -0
  94. package/messages/package_install_request.md +34 -0
  95. package/messages/package_installed_list.md +16 -0
  96. package/messages/package_list.md +67 -0
  97. package/messages/package_uninstall.md +73 -0
  98. package/messages/package_uninstall_get.md +34 -0
  99. package/messages/package_uninstall_report.md +34 -0
  100. package/messages/package_update.md +45 -0
  101. package/messages/package_version_create.md +306 -0
  102. package/messages/package_version_create_list.md +62 -0
  103. package/messages/package_version_create_report.md +35 -0
  104. package/messages/package_version_delete.md +63 -0
  105. package/messages/package_version_list.md +135 -0
  106. package/messages/package_version_promote.md +50 -0
  107. package/messages/package_version_report.md +51 -0
  108. package/messages/package_version_update.md +74 -0
  109. package/messages/packaging.md +157 -0
  110. package/oclif.manifest.json +1 -1
  111. package/package.json +98 -15
  112. package/lib/commands/force/package/placeholder.d.ts +0 -5
  113. package/lib/commands/force/package/placeholder.js +0 -17
  114. package/lib/commands/force/package/placeholder.js.map +0 -1
  115. package/messages/org.json +0 -12
package/README.md CHANGED
@@ -1,13 +1,11 @@
1
1
  # plugin-packaging;
2
2
 
3
- > :warning: **This module is under heavy development, please do not use in production.**
3
+ > :warning: **This plugin is currently in beta. We appreciate any feedback via https://github.com/forcedotcom/cli/issues**
4
4
 
5
5
  [![NPM](https://img.shields.io/npm/v/@salesforce/plugin-packaging.svg?label=@salesforce/plugin-packaging)](https://www.npmjs.com/package/@salesforce/plugin-packaging) [![CircleCI](https://circleci.com/gh/salesforcecli/plugin-packaging/tree/main.svg?style=shield)](https://circleci.com/gh/salesforcecli/plugin-packaging/tree/main) [![Downloads/week](https://img.shields.io/npm/dw/@salesforce/plugin-packaging.svg)](https://npmjs.org/package/@salesforce/plugin-packaging) [![License](https://img.shields.io/badge/License-BSD%203--Clause-brightgreen.svg)](https://raw.githubusercontent.com/salesforcecli/plugin-packaging/main/LICENSE.txt)
6
6
 
7
7
  ## This plugin provides the sfdx cli commands that support Salesforce Packaging Platform
8
8
 
9
- ## Learn about the plugin-packaging
10
-
11
9
  ## Install
12
10
 
13
11
  ```bash
@@ -70,22 +68,764 @@ sfdx plugins
70
68
 
71
69
  <!-- commands -->
72
70
 
73
- - [`sfdx force:package:placeholder [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackageplaceholder---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
71
+ - [`sfdx force:package1:beta:version:create -i <id> -n <string> [-d <string>] [-v <string>] [-m] [-r <url>] [-p <url>] [-k <string>] [-w <minutes>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackage1betaversioncreate--i-id--n-string--d-string--v-string--m--r-url--p-url--k-string--w-minutes--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
72
+ - [`sfdx force:package1:beta:version:create:get -i <id> [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackage1betaversioncreateget--i-id--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
73
+ - [`sfdx force:package1:beta:version:display -i <id> [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackage1betaversiondisplay--i-id--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
74
+ - [`sfdx force:package1:beta:version:list [-i <id>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackage1betaversionlist--i-id--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
75
+ - [`sfdx force:package:beta:create -n <string> -t Managed|Unlocked -r <directory> [-d <string>] [-e] [--orgdependent] [-o <string>] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetacreate--n-string--t-managedunlocked--r-directory--d-string--e---orgdependent--o-string--v-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
76
+ - [`sfdx force:package:beta:delete -p <string> [-n] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetadelete--p-string--n--v-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
77
+ - [`sfdx force:package:beta:install -p <string> [-w <minutes>] [-k <string>] [-b <minutes>] [-r] [-a all|package] [-s AllUsers|AdminsOnly] [-t DeprecateOnly|Mixed|Delete] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetainstall--p-string--w-minutes--k-string--b-minutes--r--a-allpackage--s-allusersadminsonly--t-deprecateonlymixeddelete--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
78
+ - [`sfdx force:package:beta:install:report -i <id> [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetainstallreport--i-id--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
79
+ - [`sfdx force:package:beta:installed:list [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetainstalledlist--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
80
+ - [`sfdx force:package:beta:list [-v <string>] [--apiversion <string>] [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetalist--v-string---apiversion-string---verbose---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
81
+ - [`sfdx force:package:beta:uninstall [-w <minutes>] [-p <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetauninstall--w-minutes--p-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
82
+ - [`sfdx force:package:beta:uninstall:report -i <id> [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetauninstallreport--i-id--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
83
+ - [`sfdx force:package:beta:update -p <string> [-n <string>] [-d <string>] [-o <string>] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetaupdate--p-string--n-string--d-string--o-string--v-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
84
+ - [`sfdx force:package:beta:version:create [-b <string>] [-c | --skipvalidation] [-f <filepath>] [-k <string>] [-x] [-p <string>] [-d <directory>] [--postinstallscript <string>] [--postinstallurl <url>] [--releasenotesurl <url>] [--skipancestorcheck] [-t <string>] [--uninstallscript <string>] [-e <string>] [-a <string>] [-n <string>] [-w <minutes>] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetaversioncreate--b-string--c----skipvalidation--f-filepath--k-string--x--p-string--d-directory---postinstallscript-string---postinstallurl-url---releasenotesurl-url---skipancestorcheck--t-string---uninstallscript-string--e-string--a-string--n-string--w-minutes--v-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
85
+ - [`sfdx force:package:beta:version:create:list [-c <number>] [-s Queued|InProgress|Success|Error] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetaversioncreatelist--c-number--s-queuedinprogresssuccesserror--v-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
86
+ - [`sfdx force:package:beta:version:create:report -i <id> [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetaversioncreatereport--i-id--v-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
87
+ - [`sfdx force:package:beta:version:delete -p <string> [-n] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetaversiondelete--p-string--n--v-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
88
+ - [`sfdx force:package:beta:version:displayancestry -p <string> [--dotcode] [-v <string>] [--apiversion <string>] [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetaversiondisplayancestry--p-string---dotcode--v-string---apiversion-string---verbose---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
89
+ - [`sfdx force:package:beta:version:list [-c <number>] [-m <number>] [-p <array>] [-r] [-o <array>] [-v <string>] [--apiversion <string>] [--concise] [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetaversionlist--c-number--m-number--p-array--r--o-array--v-string---apiversion-string---concise---verbose---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
90
+ - [`sfdx force:package:beta:version:promote -p <string> [-n] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetaversionpromote--p-string--n--v-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
91
+ - [`sfdx force:package:beta:version:report -p <string> [-v <string>] [--apiversion <string>] [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetaversionreport--p-string--v-string---apiversion-string---verbose---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
92
+ - [`sfdx force:package:beta:version:update -p <string> [-a <string>] [-e <string>] [-b <string>] [-t <string>] [-k <string>] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcepackagebetaversionupdate--p-string--a-string--e-string--b-string--t-string--k-string--v-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
93
+
94
+ ## `sfdx force:package1:beta:version:create -i <id> -n <string> [-d <string>] [-v <string>] [-m] [-r <url>] [-p <url>] [-k <string>] [-w <minutes>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
95
+
96
+ create a first-generation package version in the release org
97
+
98
+ ```
99
+ USAGE
100
+ $ sfdx force:package1:beta:version:create -i <id> -n <string> [-d <string>] [-v <string>] [-m] [-r <url>] [-p <url>] [-k <string>] [-w
101
+ <minutes>] [-u <string>] [--apiversion <string>] [--json] [--loglevel
102
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
103
+
104
+ FLAGS
105
+ -d, --description=<value> package version description
106
+ -i, --packageid=<value> (required) ID of the metadata
107
+ package (starts with 033) of which
108
+ you’re creating a new version
109
+ -k, --installationkey=<value> installation key for key-protected
110
+ package (default: null)
111
+ -m, --managedreleased create a managed package version
112
+ -n, --name=<value> (required) package version name
113
+ -p, --postinstallurl=<value> post install URL
114
+ -r, --releasenotesurl=<value> release notes URL
115
+ -u, --targetusername=<value> username or alias for the target
116
+ org; overrides default target org
117
+ -v, --version=<value> package version in major.minor
118
+ format, for example, 3.2
119
+ -w, --wait=<value> minutes to wait for the package
120
+ version to be created (default: 2
121
+ minutes)
122
+ --apiversion=<value> override the api version used for
123
+ api requests made by this command
124
+ --json format output as json
125
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
126
+ this command invocation
127
+
128
+ DESCRIPTION
129
+ create a first-generation package version in the release org
130
+ ```
131
+
132
+ _See code: [src/commands/force/package1/beta/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package1/beta/version/create.ts)_
133
+
134
+ ## `sfdx force:package1:beta:version:create:get -i <id> [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
135
+
136
+ retrieve the status of a package version creation request
137
+
138
+ ```
139
+ USAGE
140
+ $ sfdx force:package1:beta:version:create:get -i <id> [-u <string>] [--apiversion <string>] [--json] [--loglevel
141
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
142
+
143
+ FLAGS
144
+ -i, --requestid=<value> (required) PackageUploadRequest ID
145
+ -u, --targetusername=<value> username or alias for the target
146
+ org; overrides default target org
147
+ --apiversion=<value> override the api version used for
148
+ api requests made by this command
149
+ --json format output as json
150
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
151
+ this command invocation
152
+
153
+ DESCRIPTION
154
+ retrieve the status of a package version creation request
155
+
156
+ EXAMPLES
157
+ Examples:
158
+
159
+ $ sfdx force:package1:version:create:get -i 0HD...
160
+
161
+ $ sfdx force:package1:version:create:get -i 0HD... -u devhub@example.com
162
+ ```
163
+
164
+ _See code: [src/commands/force/package1/beta/version/create/get.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package1/beta/version/create/get.ts)_
165
+
166
+ ## `sfdx force:package1:beta:version:display -i <id> [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
167
+
168
+ display details about a first-generation package version
169
+
170
+ ```
171
+ USAGE
172
+ $ sfdx force:package1:beta:version:display -i <id> [-u <string>] [--apiversion <string>] [--json] [--loglevel
173
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
174
+
175
+ FLAGS
176
+ -i, --packageversionid=<value> (required) metadata package version
177
+ ID (starts with 04t)
178
+ -u, --targetusername=<value> username or alias for the target
179
+ org; overrides default target org
180
+ --apiversion=<value> override the api version used for
181
+ api requests made by this command
182
+ --json format output as json
183
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
184
+ this command invocation
185
+
186
+ DESCRIPTION
187
+ display details about a first-generation package version
188
+ ```
189
+
190
+ _See code: [src/commands/force/package1/beta/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package1/beta/version/display.ts)_
191
+
192
+ ## `sfdx force:package1:beta:version:list [-i <id>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
193
+
194
+ list package versions for the specified first-generation package or for the org
195
+
196
+ ```
197
+ USAGE
198
+ $ sfdx force:package1:beta:version:list [-i <id>] [-u <string>] [--apiversion <string>] [--json] [--loglevel
199
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
200
+
201
+ FLAGS
202
+ -i, --packageid=<value> metadata package ID (starts with
203
+ 033)
204
+ -u, --targetusername=<value> username or alias for the target
205
+ org; overrides default target org
206
+ --apiversion=<value> override the api version used for
207
+ api requests made by this command
208
+ --json format output as json
209
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
210
+ this command invocation
211
+
212
+ DESCRIPTION
213
+ list package versions for the specified first-generation package or for the org
214
+ ```
215
+
216
+ _See code: [src/commands/force/package1/beta/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package1/beta/version/list.ts)_
217
+
218
+ ## `sfdx force:package:beta:create -n <string> -t Managed|Unlocked -r <directory> [-d <string>] [-e] [--orgdependent] [-o <string>] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
219
+
220
+ create a package
221
+
222
+ ```
223
+ USAGE
224
+ $ sfdx force:package:beta:create -n <string> -t Managed|Unlocked -r <directory> [-d <string>] [-e] [--orgdependent] [-o
225
+ <string>] [-v <string>] [--apiversion <string>] [--json] [--loglevel
226
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
227
+
228
+ FLAGS
229
+ -d, --description=<value> package description
230
+ -e, --nonamespace creates the package with no
231
+ namespace; available only for
232
+ unlocked packages.
233
+ -n, --name=<value> (required) package name
234
+ -o, --errornotificationusername=<value> active Dev Hub user designated to
235
+ receive email notifications for
236
+ package errors
237
+ -r, --path=<value> (required) path to directory that
238
+ contains the contents of the package
239
+ -t, --packagetype=(Managed|Unlocked) (required) package type
240
+ -v, --targetdevhubusername=<value> username or alias for the dev hub
241
+ org; overrides default dev hub org
242
+ --apiversion=<value> override the api version used for
243
+ api requests made by this command
244
+ --json format output as json
245
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
246
+ this command invocation
247
+ --orgdependent depends on unpackaged metadata in
248
+ the installation org. Applies to
249
+ unlocked packages only.
250
+
251
+ DESCRIPTION
252
+ create a package
253
+ ```
254
+
255
+ _See code: [src/commands/force/package/beta/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/create.ts)_
256
+
257
+ ## `sfdx force:package:beta:delete -p <string> [-n] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
258
+
259
+ delete a package
260
+
261
+ ```
262
+ USAGE
263
+ $ sfdx force:package:beta:delete -p <string> [-n] [-v <string>] [--apiversion <string>] [--json] [--loglevel
264
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
265
+
266
+ FLAGS
267
+ -n, --noprompt don’t prompt before deleting the
268
+ package
269
+ -p, --package=<value> (required) ID (starts with 0Ho) or
270
+ alias of the package to delete
271
+ -v, --targetdevhubusername=<value> username or alias for the dev hub
272
+ org; overrides default dev hub org
273
+ --apiversion=<value> override the api version used for
274
+ api requests made by this command
275
+ --json format output as json
276
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
277
+ this command invocation
278
+
279
+ DESCRIPTION
280
+ delete a package
281
+ ```
282
+
283
+ _See code: [src/commands/force/package/beta/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/delete.ts)_
284
+
285
+ ## `sfdx force:package:beta:install -p <string> [-w <minutes>] [-k <string>] [-b <minutes>] [-r] [-a all|package] [-s AllUsers|AdminsOnly] [-t DeprecateOnly|Mixed|Delete] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
286
+
287
+ install a package in the target org
288
+
289
+ ```
290
+ USAGE
291
+ $ sfdx force:package:beta:install -p <string> [-w <minutes>] [-k <string>] [-b <minutes>] [-r] [-a all|package] [-s
292
+ AllUsers|AdminsOnly] [-t DeprecateOnly|Mixed|Delete] [-u <string>] [--apiversion <string>] [--json] [--loglevel
293
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
294
+
295
+ FLAGS
296
+ -a, --apexcompile=(all|package)
297
+ [default: all] compile all Apex in the org and package, or only Apex in the package; unlocked packages only
298
+
299
+ -b, --publishwait=<value>
300
+ number of minutes to wait for subscriber package version ID to become available in the target org
301
+
302
+ -k, --installationkey=<value>
303
+ installation key for key-protected package (default: null)
304
+
305
+ -p, --package=<value>
306
+ (required) ID (starts with 04t) or alias of the package version to install
307
+
308
+ -r, --noprompt
309
+ do not prompt for confirmation
310
+
311
+ -s, --securitytype=(AllUsers|AdminsOnly)
312
+ [default: AdminsOnly] security access type for the installed package (deprecation notice: The default --securitytype
313
+ value will change from AllUsers to AdminsOnly in v47.0 or later.)
314
+
315
+ -t, --upgradetype=(DeprecateOnly|Mixed|Delete)
316
+ [default: Mixed] the upgrade type for the package installation; available only for unlocked packages
317
+
318
+ -u, --targetusername=<value>
319
+ username or alias for the target org; overrides default target org
320
+
321
+ -w, --wait=<value>
322
+ number of minutes to wait for installation status
323
+
324
+ --apiversion=<value>
325
+ override the api version used for api requests made by this command
326
+
327
+ --json
328
+ format output as json
329
+
330
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)
331
+ [default: warn] logging level for this command invocation
332
+
333
+ DESCRIPTION
334
+ install a package in the target org
335
+ ```
336
+
337
+ _See code: [src/commands/force/package/beta/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/install.ts)_
338
+
339
+ ## `sfdx force:package:beta:install:report -i <id> [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
340
+
341
+ retrieve the status of a package installation request
342
+
343
+ ```
344
+ USAGE
345
+ $ sfdx force:package:beta:install:report -i <id> [-u <string>] [--apiversion <string>] [--json] [--loglevel
346
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
347
+
348
+ FLAGS
349
+ -i, --requestid=<value> (required) ID of the package install
350
+ request you want to check
351
+ -u, --targetusername=<value> username or alias for the target
352
+ org; overrides default target org
353
+ --apiversion=<value> override the api version used for
354
+ api requests made by this command
355
+ --json format output as json
356
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
357
+ this command invocation
358
+
359
+ DESCRIPTION
360
+ retrieve the status of a package installation request
361
+ ```
362
+
363
+ _See code: [src/commands/force/package/beta/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/install/report.ts)_
364
+
365
+ ## `sfdx force:package:beta:installed:list [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
366
+
367
+ list the org’s installed packages
368
+
369
+ ```
370
+ USAGE
371
+ $ sfdx force:package:beta:installed:list [-u <string>] [--apiversion <string>] [--json] [--loglevel
372
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
373
+
374
+ FLAGS
375
+ -u, --targetusername=<value> username or alias for the target
376
+ org; overrides default target org
377
+ --apiversion=<value> override the api version used for
378
+ api requests made by this command
379
+ --json format output as json
380
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
381
+ this command invocation
382
+
383
+ DESCRIPTION
384
+ list the org’s installed packages
385
+
386
+ EXAMPLES
387
+ $ sfdx force:package:installed:list
74
388
 
75
- ## `sfdx force:package:placeholder [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
389
+ $ sfdx force:package:installed:list -u me@example.com
390
+ ```
391
+
392
+ _See code: [src/commands/force/package/beta/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/installed/list.ts)_
393
+
394
+ ## `sfdx force:package:beta:list [-v <string>] [--apiversion <string>] [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
395
+
396
+ list all packages in the Dev Hub org
76
397
 
77
398
  ```
78
399
  USAGE
79
- $ sfdx force:package:placeholder [--json] [--loglevel
80
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
400
+ $ sfdx force:package:beta:list [-v <string>] [--apiversion <string>] [--verbose] [--json] [--loglevel
401
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
81
402
 
82
- OPTIONS
403
+ FLAGS
404
+ -v, --targetdevhubusername=<value> username or alias for the dev hub
405
+ org; overrides default dev hub org
406
+ --apiversion=<value> override the api version used for
407
+ api requests made by this command
83
408
  --json format output as json
409
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
410
+ this command invocation
411
+ --verbose display extended package detail
412
+
413
+ DESCRIPTION
414
+ list all packages in the Dev Hub org
415
+ ```
416
+
417
+ _See code: [src/commands/force/package/beta/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/list.ts)_
84
418
 
419
+ ## `sfdx force:package:beta:uninstall [-w <minutes>] [-p <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
420
+
421
+ uninstall a second-generation package from the target org
422
+
423
+ ```
424
+ USAGE
425
+ $ sfdx force:package:beta:uninstall [-w <minutes>] [-p <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel
426
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
427
+
428
+ FLAGS
429
+ -p, --package=<value> ID (starts with 04t) or alias of the
430
+ package version to uninstall
431
+ -u, --targetusername=<value> username or alias for the target
432
+ org; overrides default target org
433
+ -w, --wait=<value> [default: 0 minutes] number of
434
+ minutes to wait for uninstall status
435
+ --apiversion=<value> override the api version used for
436
+ api requests made by this command
437
+ --json format output as json
85
438
  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
86
439
  this command invocation
440
+
441
+ DESCRIPTION
442
+ uninstall a second-generation package from the target org
443
+ ```
444
+
445
+ _See code: [src/commands/force/package/beta/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/uninstall.ts)_
446
+
447
+ ## `sfdx force:package:beta:uninstall:report -i <id> [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
448
+
449
+ retrieve status of package uninstall request
450
+
451
+ ```
452
+ USAGE
453
+ $ sfdx force:package:beta:uninstall:report -i <id> [-u <string>] [--apiversion <string>] [--json] [--loglevel
454
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
455
+
456
+ FLAGS
457
+ -i, --requestid=<value> (required) ID of the package
458
+ uninstall request you want to check
459
+ -u, --targetusername=<value> username or alias for the target
460
+ org; overrides default target org
461
+ --apiversion=<value> override the api version used for
462
+ api requests made by this command
463
+ --json format output as json
464
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
465
+ this command invocation
466
+
467
+ DESCRIPTION
468
+ retrieve status of package uninstall request
469
+ ```
470
+
471
+ _See code: [src/commands/force/package/beta/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/uninstall/report.ts)_
472
+
473
+ ## `sfdx force:package:beta:update -p <string> [-n <string>] [-d <string>] [-o <string>] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
474
+
475
+ update package details
476
+
477
+ ```
478
+ USAGE
479
+ $ sfdx force:package:beta:update -p <string> [-n <string>] [-d <string>] [-o <string>] [-v <string>] [--apiversion <string>]
480
+ [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
481
+
482
+ FLAGS
483
+ -d, --description=<value> new package description
484
+ -n, --name=<value> new package name
485
+ -o, --errornotificationusername=<value> active Dev Hub user designated to
486
+ receive email notifications for
487
+ package errors
488
+ -p, --package=<value> (required) ID (starts with 0Ho) or
489
+ alias of the package to update
490
+ -v, --targetdevhubusername=<value> username or alias for the dev hub
491
+ org; overrides default dev hub org
492
+ --apiversion=<value> override the api version used for
493
+ api requests made by this command
494
+ --json format output as json
495
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
496
+ this command invocation
497
+
498
+ DESCRIPTION
499
+ update package details
500
+ ```
501
+
502
+ _See code: [src/commands/force/package/beta/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/update.ts)_
503
+
504
+ ## `sfdx force:package:beta:version:create [-b <string>] [-c | --skipvalidation] [-f <filepath>] [-k <string>] [-x] [-p <string>] [-d <directory>] [--postinstallscript <string>] [--postinstallurl <url>] [--releasenotesurl <url>] [--skipancestorcheck] [-t <string>] [--uninstallscript <string>] [-e <string>] [-a <string>] [-n <string>] [-w <minutes>] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
505
+
506
+ create a package version
507
+
508
+ ```
509
+ USAGE
510
+ $ sfdx force:package:beta:version:create [-b <string>] [-c | --skipvalidation] [-f <filepath>] [-k <string>] [-x] [-p <string>] [-d
511
+ <directory>] [--postinstallscript <string>] [--postinstallurl <url>] [--releasenotesurl <url>] [--skipancestorcheck]
512
+ [-t <string>] [--uninstallscript <string>] [-e <string>] [-a <string>] [-n <string>] [-w <minutes>] [-v <string>]
513
+ [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
514
+
515
+ FLAGS
516
+ -a, --versionname=<value> the name of the package version to
517
+ be created
518
+ -b, --branch=<value> the package version’s branch
519
+ -c, --codecoverage calculate the code coverage by
520
+ running the packaged Apex tests
521
+ -d, --path=<value> path to directory that contains the
522
+ contents of the package
523
+ -e, --versiondescription=<value> the description of the package
524
+ version to be created
525
+ -f, --definitionfile=<value> path to a definition file similar to
526
+ scratch org definition file that
527
+ contains the list of features and
528
+ org preferences that the metadata of
529
+ the package version depends on
530
+ -k, --installationkey=<value> installation key for key-protected
531
+ package (either --installationkey or
532
+ --installationkeybypass is required)
533
+ -n, --versionnumber=<value> the version number of the package
534
+ version to be created
535
+ -p, --package=<value> ID (starts with 0Ho) or alias of the
536
+ package to create a version of
537
+ -t, --tag=<value> the package version’s tag
538
+ -v, --targetdevhubusername=<value> username or alias for the dev hub
539
+ org; overrides default dev hub org
540
+ -w, --wait=<value> [default: 0 minutes] minutes to wait
541
+ for the package version to be
542
+ created
543
+ -x, --installationkeybypass bypass the installation key
544
+ requirement (either
545
+ --installationkey or
546
+ --installationkeybypass is required)
547
+ --apiversion=<value> override the api version used for
548
+ api requests made by this command
549
+ --json format output as json
550
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
551
+ this command invocation
552
+ --postinstallscript=<value> post-install script name; managed
553
+ packages only
554
+ --postinstallurl=<value> post-install URL
555
+ --releasenotesurl=<value> release notes URL
556
+ --skipancestorcheck Overrides ancestry requirements.
557
+ --skipvalidation skip validation during package
558
+ version creation; you can’t promote
559
+ unvalidated package versions
560
+ --uninstallscript=<value> uninstall script name; managed
561
+ packages only
562
+
563
+ DESCRIPTION
564
+ create a package version
565
+
566
+ EXAMPLES
567
+ $ sfdx force:package:version:create -d common -k password123
568
+
569
+ $ sfdx force:package:version:create -p "Your Package Alias" -k password123
570
+
571
+ $ sfdx force:package:version:create -p 0Ho... -k password123
572
+
573
+ $ sfdx force:package:version:create -d common -k password123 --skipvalidation
574
+ ```
575
+
576
+ _See code: [src/commands/force/package/beta/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/version/create.ts)_
577
+
578
+ ## `sfdx force:package:beta:version:create:list [-c <number>] [-s Queued|InProgress|Success|Error] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
579
+
580
+ list package version creation requests
581
+
582
+ ```
583
+ USAGE
584
+ $ sfdx force:package:beta:version:create:list [-c <number>] [-s Queued|InProgress|Success|Error] [-v <string>] [--apiversion <string>]
585
+ [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
586
+
587
+ FLAGS
588
+ -c, --createdlastdays=<value> created in the last specified number
589
+ of days (starting at 00:00:00 of
590
+ first day to now; 0 for today)
591
+ -s, --status=(Queued|InProgress|Success|Error) filter the list by version creation
592
+ request status
593
+ -v, --targetdevhubusername=<value> username or alias for the dev hub
594
+ org; overrides default dev hub org
595
+ --apiversion=<value> override the api version used for
596
+ api requests made by this command
597
+ --json format output as json
598
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
599
+ this command invocation
600
+
601
+ DESCRIPTION
602
+ list package version creation requests
603
+ ```
604
+
605
+ _See code: [src/commands/force/package/beta/version/create/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/version/create/list.ts)_
606
+
607
+ ## `sfdx force:package:beta:version:create:report -i <id> [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
608
+
609
+ retrieve details about a package version creation request
610
+
611
+ ```
612
+ USAGE
613
+ $ sfdx force:package:beta:version:create:report -i <id> [-v <string>] [--apiversion <string>] [--json] [--loglevel
614
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
615
+
616
+ FLAGS
617
+ -i, --packagecreaterequestid=<value> (required) package version creation
618
+ request ID (starts with 08c)
619
+ -v, --targetdevhubusername=<value> username or alias for the dev hub
620
+ org; overrides default dev hub org
621
+ --apiversion=<value> override the api version used for
622
+ api requests made by this command
623
+ --json format output as json
624
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
625
+ this command invocation
626
+
627
+ DESCRIPTION
628
+ retrieve details about a package version creation request
629
+ ```
630
+
631
+ _See code: [src/commands/force/package/beta/version/create/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/version/create/report.ts)_
632
+
633
+ ## `sfdx force:package:beta:version:delete -p <string> [-n] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
634
+
635
+ delete a package version
636
+
637
+ ```
638
+ USAGE
639
+ $ sfdx force:package:beta:version:delete -p <string> [-n] [-v <string>] [--apiversion <string>] [--json] [--loglevel
640
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
641
+
642
+ FLAGS
643
+ -n, --noprompt don’t prompt before deleting the
644
+ package version
645
+ -p, --package=<value> (required) ID (starts with 04t) or
646
+ alias of the package to update a
647
+ version of
648
+ -v, --targetdevhubusername=<value> username or alias for the dev hub
649
+ org; overrides default dev hub org
650
+ --apiversion=<value> override the api version used for
651
+ api requests made by this command
652
+ --json format output as json
653
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
654
+ this command invocation
655
+
656
+ DESCRIPTION
657
+ delete a package version
658
+ ```
659
+
660
+ _See code: [src/commands/force/package/beta/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/version/delete.ts)_
661
+
662
+ ## `sfdx force:package:beta:version:displayancestry -p <string> [--dotcode] [-v <string>] [--apiversion <string>] [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
663
+
664
+ display the ancestry tree for a 2GP managed package version
665
+
666
+ ```
667
+ USAGE
668
+ $ sfdx force:package:beta:version:displayancestry -p <string> [--dotcode] [-v <string>] [--apiversion <string>] [--verbose] [--json]
669
+ [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
670
+
671
+ FLAGS
672
+ -p, --package=<value> (required) ID or alias of the
673
+ package (starts with 0Ho) or package
674
+ version (starts with 04t) to display
675
+ ancestry for
676
+ -v, --targetdevhubusername=<value> username or alias for the dev hub
677
+ org; overrides default dev hub org
678
+ --apiversion=<value> override the api version used for
679
+ api requests made by this command
680
+ --dotcode display the ancestry tree in DOT
681
+ code
682
+ --json format output as json
683
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
684
+ this command invocation
685
+ --verbose display both the package version ID
686
+ (starts with 04t) and the version
687
+ number (major.minor.patch.build) in
688
+ the ancestry tree
689
+
690
+ DESCRIPTION
691
+ display the ancestry tree for a 2GP managed package version
692
+ ```
693
+
694
+ _See code: [src/commands/force/package/beta/version/displayancestry.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/version/displayancestry.ts)_
695
+
696
+ ## `sfdx force:package:beta:version:list [-c <number>] [-m <number>] [-p <array>] [-r] [-o <array>] [-v <string>] [--apiversion <string>] [--concise] [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
697
+
698
+ list all package versions in the Dev Hub org
699
+
700
+ ```
701
+ USAGE
702
+ $ sfdx force:package:beta:version:list [-c <number>] [-m <number>] [-p <array>] [-r] [-o <array>] [-v <string>] [--apiversion
703
+ <string>] [--concise] [--verbose] [--json] [--loglevel
704
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
705
+
706
+ FLAGS
707
+ -c, --createdlastdays=<value> created in the last specified number
708
+ of days (starting at 00:00:00 of
709
+ first day to now; 0 for today)
710
+ -m, --modifiedlastdays=<value> list items modified in the specified
711
+ last number of days (starting at
712
+ 00:00:00 of first day to now; 0 for
713
+ today)
714
+ -o, --orderby=<value> order by the specified package
715
+ version fields
716
+ -p, --packages=<value> filter results on specified
717
+ comma-delimited packages (aliases or
718
+ 0Ho IDs)
719
+ -r, --released display released versions only
720
+ -v, --targetdevhubusername=<value> username or alias for the dev hub
721
+ org; overrides default dev hub org
722
+ --apiversion=<value> override the api version used for
723
+ api requests made by this command
724
+ --concise display limited package version
725
+ details
726
+ --json format output as json
727
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
728
+ this command invocation
729
+ --verbose display extended package version
730
+ details
731
+
732
+ DESCRIPTION
733
+ list all package versions in the Dev Hub org
734
+ ```
735
+
736
+ _See code: [src/commands/force/package/beta/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/version/list.ts)_
737
+
738
+ ## `sfdx force:package:beta:version:promote -p <string> [-n] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
739
+
740
+ promote a package version to released
741
+
742
+ ```
743
+ USAGE
744
+ $ sfdx force:package:beta:version:promote -p <string> [-n] [-v <string>] [--apiversion <string>] [--json] [--loglevel
745
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
746
+
747
+ FLAGS
748
+ -n, --noprompt no prompt to confirm setting the
749
+ package version as released
750
+ -p, --package=<value> (required) ID (starts with 04t) or
751
+ alias of the package version to
752
+ promote
753
+ -v, --targetdevhubusername=<value> username or alias for the dev hub
754
+ org; overrides default dev hub org
755
+ --apiversion=<value> override the api version used for
756
+ api requests made by this command
757
+ --json format output as json
758
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
759
+ this command invocation
760
+
761
+ DESCRIPTION
762
+ promote a package version to released
763
+ ```
764
+
765
+ _See code: [src/commands/force/package/beta/version/promote.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/version/promote.ts)_
766
+
767
+ ## `sfdx force:package:beta:version:report -p <string> [-v <string>] [--apiversion <string>] [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
768
+
769
+ retrieve details about a package version in the Dev Hub org
770
+
771
+ ```
772
+ USAGE
773
+ $ sfdx force:package:beta:version:report -p <string> [-v <string>] [--apiversion <string>] [--verbose] [--json] [--loglevel
774
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
775
+
776
+ FLAGS
777
+ -p, --package=<value> (required) ID (starts with 04t) or
778
+ alias of the package to retrieve
779
+ details for
780
+ -v, --targetdevhubusername=<value> username or alias for the dev hub
781
+ org; overrides default dev hub org
782
+ --apiversion=<value> override the api version used for
783
+ api requests made by this command
784
+ --json format output as json
785
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
786
+ this command invocation
787
+ --verbose displays extended package version
788
+ details
789
+
790
+ DESCRIPTION
791
+ retrieve details about a package version in the Dev Hub org
792
+ ```
793
+
794
+ _See code: [src/commands/force/package/beta/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/version/report.ts)_
795
+
796
+ ## `sfdx force:package:beta:version:update -p <string> [-a <string>] [-e <string>] [-b <string>] [-t <string>] [-k <string>] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
797
+
798
+ update a package version
799
+
800
+ ```
801
+ USAGE
802
+ $ sfdx force:package:beta:version:update -p <string> [-a <string>] [-e <string>] [-b <string>] [-t <string>] [-k <string>] [-v
803
+ <string>] [--apiversion <string>] [--json] [--loglevel
804
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
805
+
806
+ FLAGS
807
+ -a, --versionname=<value> new package version name
808
+ -b, --branch=<value> new package version branch
809
+ -e, --versiondescription=<value> new package version description
810
+ -k, --installationkey=<value> new installation key for
811
+ key-protected package (default:
812
+ null)
813
+ -p, --package=<value> (required) ID (starts with 04t) or
814
+ alias of the package to update a
815
+ version of
816
+ -t, --tag=<value> new package version tag
817
+ -v, --targetdevhubusername=<value> username or alias for the dev hub
818
+ org; overrides default dev hub org
819
+ --apiversion=<value> override the api version used for
820
+ api requests made by this command
821
+ --json format output as json
822
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
823
+ this command invocation
824
+
825
+ DESCRIPTION
826
+ update a package version
87
827
  ```
88
828
 
89
- _See code: [src/commands/force/package/placeholder.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.0.0/src/commands/force/package/placeholder.ts)_
829
+ _See code: [src/commands/force/package/beta/version/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/v1.2.1/src/commands/force/package/beta/version/update.ts)_
90
830
 
91
831
  <!-- commandsstop -->