https://github.com/dsccommunity/xwebdeploy
https://github.com/dsccommunity/xwebdeploy
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dsccommunity/xwebdeploy
- Owner: dsccommunity
- License: mit
- Created: 2015-04-15T22:43:09.000Z (over 11 years ago)
- Default Branch: dev
- Last Pushed: 2018-09-22T14:34:25.000Z (almost 8 years ago)
- Last Synced: 2024-03-14T13:02:28.361Z (over 2 years ago)
- Language: PowerShell
- Size: 53.7 KB
- Stars: 7
- Watchers: 19
- Forks: 13
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://ci.appveyor.com/project/PowerShell/xwebdeploy/branch/master)
# xWebDeploy
The **xWebDeploy** module contains the **xWebPackageDeploy** and **xWebDeploy** DSC resources for installing an IIS site using the WebDeploy IIS extension (MSWebDeploy version 3.5).
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
## Contributing
Please check out common DSC Resources [contributing guidelines](https://github.com/PowerShell/DscResource.Kit/blob/master/CONTRIBUTING.md).
## Resources
* **xWebDeploy** is a composite configuration that installs the WebDeploy 3.5 IIS extensions and deploys an IIS site from a given web package that was exported from a reference server suing MSWebDeploy 3.0 or 3.5.
xWebDeploy supports Web Deploy sync, dump verbs, and iisApp and contentPath parameters.
Note: This composite resource requires the **Package** resource that ships with PowerShell 4.0.
* **xWebPackageDeploy** installs an IIS site from a given web deploy package formatted as a zip file.
### xWebDeploy
* **SourcePath**: The full path on the filesystem where the web deploy package (as a zip file) is located.
* **Destination**: The IIS content path or IIS site name to install the WebDeploy Zip package.
* **WebDeployMsi**: The URI to download WebDeploy version 3.5.
### xWebPackageDeploy
* **SourcePath**: The full path on the filesystem where the web deploy package (as a zip file) is located.
* **Destination**: The IIS content path or IIS site name to install the WebDeploy zip package.
* **Ensure**: Ensures that the web package is installed: { Present | Absent }
## Versions
### Unreleased
* Update appveyor.yml to use the default template.
* Activated the GitHub App Stale on the GitHub repository.
* Updated manifest property PowerShellVersion to '4.0' to pass tests.
* Added unit_template.ps1 to Tests\Unit folder.
* Added default template files .codecov.yml, .gitattributes, and .gitignore, and
.vscode folder.
### 1.2.0.0
* xWebPackageDeploy: Fixed comparison to check if Destination contains any backslash
### 1.1.0.0
* Added WebdeployMsi setting to make xWebDeploy work without internet access
### 1.0.0.0
* Initial release with the following resources
- xWebDeploy
- xWebPackageDeploy
## Examples
### Deploy IIS site from the given zip package using the WebDeploy composite resource
```powershell
# You need to provide $SourcePath and $Destination parameter values to be able to run this sample Sample
# Note that xWebDeploy is installing WebDeploy extension from default install location "$env:ProgramFiles\WindowsPowerShell\Modules\xWebDeploy\InstallerMsi.
# Run xWebDeploySample.ps1 from xWebDeploy\Samples
```