Merge pull request #1061 from salesforcecli/jn-edit-package-version-retrieve-message

W-19842308: Update package_version_retrieve.md

Author: jshackell-sfdc

messages/package_version_retrieve.md

@@ -1,18 +1,20 @@
 # summary
 
-Retrieve package metadata for a specified package version. Package metadata can be retrieved for converted second-generation managed package versions only.
+Retrieve package metadata for a specified package version. Package metadata can be retrieved for second-generation managed package versions or unlocked packages only.
 
 # description
 
 Retrieving a package version downloads the metadata into the directory you specify.
 
-Specify the subscriber package version ID (starts with 04t) and the path to an empty directory when you run this command.
+When you run this command, specify the subscriber package version ID (starts with 04t) and the path to an empty directory.
+
+By default, the package version retrieve command is available to 2GP managed packages that were converted from 1GP. To use this command with a managed package created using 2GP (not converted from 1GP) or with an unlocked package, specify IsDevUsePkgZipRequested = true in the Package2VersionCreateRequest Tooling API object. If you run this command and the zip folder with the package version’s source files is missing, confirm that IsDevUsePkgZipRequested is set to true.
 
 # examples
 
-- Retrieve package metadata for a converted subscriber package version ID (starts with 04t) into my-folder/ within your Salesforce DX project directory:
+Retrieve package metadata for a converted subscriber package version ID (starts with 04t) into my-directory/ within your Salesforce DX project directory:
 
-  <%= config.bin %> <%= command.id %> --package 04t... --output-dir my-folder –-target-dev-hub my-devhub
+  <%= config.bin %> <%= command.id %> --package 04tXXX --output-dir my-directory/ --target-dev-hub devhub@example.com
 
 # flags.package.summary
 
@@ -22,6 +24,14 @@ Subscriber package version ID (starts with 04t).
 
 Path within your Salesforce DX project directory in which to download the metadata. This directory must be empty.
 
+# flags.target-dev-hub.summary
+
+Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.
+
+# flags.api-version.summary
+
+Override the API version used for requests made by this command. 
+
 # headers.fullName
 
 FULL NAME