en-US/about_Whiskey_PublishProGetAsset_Task.help.txt
|
TOPIC
about_Whiskey_PublishProGetAsset_Task SUMMARY Publishes assets to ProGet. DESCRIPTION The `PublishProGetAsset` task adds files to a ProGet asset directory. Specify the asset directory's name with the `AssetDirectory` property. Specify the path to the file in the asset directory with the `AssetPath` parameter. Specify the path to the file to upload via the `Path` property. You can publish multiple assets. Set the `Path` property to a list of files to publish. There must be an equal number of destination paths in the `Asset-Path` property. The first item in the `Path` list will be published using the first path in the `Asset-Path` property, and so forth. If publishing to your asset directory requires credentials, pass the credential ID to the `CredentialID` parameter. Use the `Add-WhiskeyCredential` function to add the credential to your build. This task downloads and uses the [ProGetAutomation PowerShell module from the PowerShell Gallery](https://www.powershellgallery.com/packages/ProGetAutomation). PROPERTIES * `CredentialID`: The ID to the ProGet Credential. Set the `CredentialID` property to the ID of the credential to use when uploading. Add the credential with the `Add-WhiskeyCredential` function. * `Path` (Mandatory): The relative paths to the files/directories to upload to ProGet. Paths should be relative to the whiskey.yml file they were taken from. * `Uri` (Mandatory): The uri to the ProGet instance. * `AssetPath` (Mandatory): The desired Paths to the location you wish the file to be uploaded to in ProGet. The last item in the path is the asset name. The number of names provided must equal the number of file paths. * `AssetDirectory` (Mandatory): The root asset Directory you wish to upload the asset to. * `ProGetAutomationVersion`: the version of the ProGetAutomation PowerShell module to download and use. The default is the latest 0.4.* version. Be careful about changing the version. The task may not support newer/olders versions. EXAMPLES ## Example 1 Build: - PublishProGetAsset: CredentialID: ProGetCredential Path: 'path/to/file.txt' Uri: http://proget.dev.webmd.com/ AssetPath: 'exampleAsset' AssetDirectory: 'versions' Example of adding an asset named `exampleAsset` to ProGet in the `versions` directory. ## Example 2 Build: - PublishProGetAsset: CredentialID: ProGetCredential Path: - 'path/to/file.txt' - 'Path/to/anotherfile.txt' Uri: http://proget.dev.webmd.com/ AssetPath: - 'asset/path/file.txt' - 'asset/anotherfile.txt' AssetDirectory: 'exampleDirectory' Example of adding two assets named `file.txt` and `anotherfile.txt` to ProGet in the `exampleDirectory/asset/path` and `exampleDirectory/asset` directories respectively. |