https://github.com/PSBicep/PSBicep
This is the repo for the Bicep PowerShell Module.
https://github.com/PSBicep/PSBicep
arm arm-templates azure bicep bicep-azure bicep-cli bicep-lang bicep-powershell powershell powershell-module
Last synced: 7 months ago
JSON representation
This is the repo for the Bicep PowerShell Module.
- Host: GitHub
- URL: https://github.com/PSBicep/PSBicep
- Owner: PSBicep
- License: mit
- Created: 2021-01-12T13:17:08.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-04-27T07:31:20.000Z (8 months ago)
- Last Synced: 2025-05-09T00:46:14.280Z (7 months ago)
- Topics: arm, arm-templates, azure, bicep, bicep-azure, bicep-cli, bicep-lang, bicep-powershell, powershell, powershell-module
- Language: PowerShell
- Homepage:
- Size: 867 KB
- Stars: 136
- Watchers: 9
- Forks: 37
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- AWESOME-Azure-Bicep - PSBicep - Bicep PowerShell Module
README
# ![BicepIcon] PSBicep - Bicep PowerShell Module
[![Bicep]][BicepGallery] [![BicepDownloads]][BicepGallery]
This is the repository for the Bicep PowerShell Module. This is a community project created to enable the features provided by the [Bicep CLI](https://github.com/Azure/bicep) in PowerShell. The module provides the same functionality as Bicep CLI, plus some additional features to simplify the Bicep authoring experience.
>**Note:** When new Bicep versions are released there will be a slight delay before the PowerShell module gets tested updated with the latest assemblies. If new functionality is added to Bicep CLI before the PowerShell module supports it, use `Install-BicepCLI` to install the latest Bicep CLI version and use the CLI while waiting for an updated PowerShell module.
Commands implemented:
- [Build-Bicep](./Docs/Help/Build-Bicep.md)
- [Build-BicepParam](./Docs/Help/Build-BicepParam.md)
- [Clear-BicepModuleCache](./Docs/Help/Clear-BicepModuleCache.md)
- [Connect-Bicep](./Docs/Help/Connect-Bicep.md)
- [Convert-BicepParamsToDecoratorStyle](./Docs/Help/Convert-BicepParamsToDecoratorStyle.md)
- [Convert-JsonToBicep](./Docs/Help/Convert-JsonToBicep.md)
- [ConvertTo-Bicep](./Docs/Help/ConvertTo-Bicep.md)
- [Export-BicepResource](./Docs/Help/Export-BicepResource.md)
- [Export-BicepChildResource (**experimental**)](./Docs/Help/Export-BicepChildResource.md)
- [Find-BicepModule](./Docs/Help/Find-BicepModule.md)
- [Format-BicepFile](./Docs/Help/Format-BicepFile.md)
- [Get-BicepApiReference](./Docs/Help/Get-BicepApiReference.md)
- [Get-BicepConfig](./Docs/Help/Get-BicepConfig.md)
- [Get-BicepMetadata](./Docs/Help/Get-BicepMetadata.md)
- [Get-BicepUsedModules](./Docs/Help/Get-BicepUsedModules.md)
- [Get-BicepVersion](./Docs/Help/Get-BicepVersion.md)
- [Install-BicepCLI](./Docs/Help/Install-BicepCLI.md)
- [New-BicepMarkdownDocumentation](./Docs/Help/New-BicepMarkdownDocumentation.md)
- [New-BicepParameterFile](./Docs/Help/New-BicepParameterFile.md)
- [Publish-Bicep](./Docs/Help/Publish-Bicep.md)
- [Restore-Bicep](./Docs/Help/Restore-Bicep.md)
- [Test-BicepFile](./Docs/Help/Test-BicepFile.md)
- [Uninstall-BicepCLI](./Docs/Help/Uninstall-BicepCLI.md)
- [Update-BicepCLI](./Docs/Help/Update-BicepCLI.md)
- [Update-BicepParameterFile](./Docs/Help/Update-BicepParameterFile.md)
- [Update-BicepTypes](./Docs/Help/Update-BicepTypes.md)
## Authentication
Due to the separation of code in C# and PowerShell, we currently depend on two different authentication models. Any feature that relies on built-in functionality in Bicep uses the authentication set in bicepconfig.json while Export-BicepResource uses PSBicep authentication depending on the module AzAuth and uses the command Connect-Bicep to log in.
We hope to use Connect-Bicep as default for all commands in the future.
The following commands will communcate with Azure and requires authentication:
- [Connect-Bicep](./Docs/Help/Connect-Bicep.md)
- [Export-BicepResource](./Docs/Help/Export-BicepResource.md)
- [Export-BicepChildResource](./Docs/Help/Export-BicepChildResource.md)
- [Publish-Bicep](./Docs/Help/Publish-Bicep.md)
- [Restore-Bicep](./Docs/Help/Restore-Bicep.md)
## Installation
The Bicep PowerShell Module is published to [PowerShell Gallery](https://www.powershellgallery.com/packages/Bicep/).
```powershell
Install-Module -Name Bicep
```
### Pre-release versions
To install the latest version in development use the `-AllowPrerelease` switch.
```powershell
Install-Module -Name Bicep -AllowPrerelease
```
>**Note:** If you want to test the latest features before we've release it to PowerShell Gallery, see the [Contribution Guide](CONTRIBUTING.md) for instructions on how to manually download the dependencies and install the module manually.
## Bug report and feature requests
If you find a bug or have an idea for a new feature create an issue in the repo. Please have a look and see if a similar issue is already created before submitting.
## Contribution
If you like the Bicep PowerShell module and want to contribute you are very much welcome to do so. Please read our [Contribution Guide](CONTRIBUTING.md) before you start! ❤
## Maintainers
This project is currently maintained by the following coders:
- [StefanIvemo](https://github.com/StefanIvemo)
- [SimonWahlin](https://github.com/SimonWahlin)
- [bjompen](https://github.com/bjompen)
- [JohnRoos](https://github.com/JohnRoos)
- [PalmEmanuel](https://github.com/PalmEmanuel)
- [emilguden](https://github.com/emilguden)
[BicepIcon]: logo/BicePS_40px.png
[Bicep]: https://img.shields.io/badge/Bicep-v2.7.0-blue
[BicepDownloads]: https://img.shields.io/powershellgallery/dt/Bicep
[BicepGallery]: https://www.powershellgallery.com/packages/Bicep/