Skip to content

Commit 9da59ed

Browse files
committed
updates1
1 parent 55b6242 commit 9da59ed

File tree

5 files changed

+20
-20
lines changed

5 files changed

+20
-20
lines changed

articles/azure-resource-manager/bicep/deploy-cli.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Deploy resources with Azure CLI and Bicep files | Microsoft Docs
33
description: Use Azure Resource Manager and Azure CLI to deploy resources to Azure. The resources are defined in a Bicep file.
44
ms.topic: how-to
5-
ms.date: 03/22/2024
5+
ms.date: 12/06/2024
66
ms.custom: devx-track-azurecli, seo-azure-cli, devx-track-arm-template, devx-track-bicep
77
---
88

@@ -174,11 +174,11 @@ However, if you're using Azure CLI with Windows Command Prompt (CMD) or PowerShe
174174

175175
The evaluation of parameters follows a sequential order, meaning that if a value is assigned multiple times, only the last assigned value is used. To ensure proper parameter assignment, it's advised to provide your parameters file initially and selectively override specific parameters using the _KEY=VALUE_ syntax. It's important to mention that if you're supplying a `bicepparam` parameters file, you can use this argument only once.
176176

177-
### Bicep parameter files
177+
### Bicep parameters files
178178

179179
Rather than passing parameters as inline values in your script, you might find it easier to use a parameters file, either a [Bicep parameters file](#bicep-parameter-files) or a [JSON parameters file](#json-parameter-files) that contains the parameter values. The parameters file must be a local file. External parameters files aren't supported with Azure CLI. For more information about the parameters file, see [Create Resource Manager parameters file](./parameter-files.md).
180180

181-
With Azure CLI version 2.53.0 or later, and [Bicep CLI version 0.22.X or higher](./install.md), you can deploy a Bicep file by utilizing a Bicep parameter file. With the `using` statement within the Bicep parameters file, there's no need to provide the `--template-file` switch when specifying a Bicep parameter file for the `--parameters` switch. Including the `--template-file` switch will result in an "Only a .bicep template is allowed with a .bicepparam file" error.
181+
With Azure CLI version 2.53.0 or later, and [Bicep CLI version 0.22.X or higher](./install.md), you can deploy a Bicep file by utilizing a Bicep parameters file. With the `using` statement within the Bicep parameters file, there's no need to provide the `--template-file` switch when specifying a Bicep parameters file for the `--parameters` switch. Including the `--template-file` switch will result in an "Only a .bicep template is allowed with a .bicepparam file" error.
182182

183183
The following example shows a parameters file named _storage.bicepparam_. The file is in the same directory where the command is run.
184184

@@ -189,7 +189,7 @@ az deployment group create \
189189
--parameters storage.bicepparam
190190
```
191191

192-
### JSON parameter files
192+
### JSON parameters files
193193

194194
The following example shows a parameters file named _storage.parameters.json_. The file is in the same directory where the command is run.
195195

articles/azure-resource-manager/bicep/deploy-powershell.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Deploy resources with PowerShell and Bicep
33
description: Use Azure Resource Manager and Azure PowerShell to deploy resources to Azure. The resources are defined in a Bicep file.
44
ms.topic: how-to
55
ms.custom: devx-track-arm-template, devx-track-bicep, devx-track-azurepowershell
6-
ms.date: 06/14/2024
6+
ms.date: 12/06/2024
77
---
88

99
# Deploy resources with Bicep and Azure PowerShell
@@ -137,11 +137,11 @@ New-AzResourceGroupDeployment -ResourceGroupName testgroup `
137137
-exampleArray $subnetArray
138138
```
139139

140-
### Bicep parameter files
140+
### Bicep parameters files
141141

142142
Rather than passing parameters as inline values in your script, you might find it easier to use a parameters file, either a `.bicepparam` file or a JSON parameters file, that contains the parameter values. The Bicep parameters file must be a local file.
143143

144-
With Azure PowerShell version 10.4.0 or later, and [Bicep CLI version 0.22.X or higher](./install.md), you can deploy a Bicep file by utilizing a Bicep parameter file. With the `using` statement within the Bicep parameters file, there is no need to provide the `-TemplateFile` switch when specifying a Bicep parameter file for the `-TemplateParameterFile` switch.
144+
With Azure PowerShell version 10.4.0 or later, and [Bicep CLI version 0.22.X or higher](./install.md), you can deploy a Bicep file by utilizing a Bicep parameters file. With the `using` statement within the Bicep parameters file, there is no need to provide the `-TemplateFile` switch when specifying a Bicep parameters file for the `-TemplateParameterFile` switch.
145145

146146
The following example shows a parameters file named _storage.bicepparam_. The file is in the same directory where the command is run.
147147

articles/azure-resource-manager/bicep/deploy-vscode.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Deploy Bicep files with Visual Studio Code
33
description: Deploy Bicep files from Visual Studio Code.
44
ms.topic: how-to
55
ms.custom: devx-track-bicep
6-
ms.date: 12/03/2024
6+
ms.date: 12/06/2024
77
---
88

99
# Deploy Bicep files from Visual Studio Code
@@ -32,19 +32,19 @@ After you select the command, you follow the wizard to enter the values:
3232

3333
1. Select or create a resource group.
3434

35-
1. Select a parameter file or select **None** to enter the parameter values.
35+
1. Select a parameters file or select **None** to enter the parameter values.
3636

37-
:::image type="content" source="./media/deploy-vscode/bicep-deploy-select-parameter-file.png" alt-text="Screenshot of Select parameter file.":::
37+
:::image type="content" source="./media/deploy-vscode/bicep-deploy-select-parameter-file.png" alt-text="Screenshot of Select parameters file.":::
3838

3939
1. If you choose **None**, enter the parameter values.
4040

4141
:::image type="content" source="./media/deploy-vscode/bicep-deploy-enter-parameter-values.png" alt-text="Screenshot of Enter parameter values.":::
4242

4343
After you enter the values, you have the option to create a parameters file from values used in this deployment:
4444

45-
:::image type="content" source="./media/deploy-vscode/bicep-deploy-create-parameter-file.png" alt-text="Screenshot of Create parameter file.":::
45+
:::image type="content" source="./media/deploy-vscode/bicep-deploy-create-parameter-file.png" alt-text="Screenshot of Create parameters file.":::
4646

47-
If you select **Yes**, a parameter file with the file name **<Bicep-file-name>.parameters.json** is created in the same folder.
47+
If you select **Yes**, a parameters file with the file name **<Bicep-file-name>.parameters.json** is created in the same folder.
4848

4949
For more information about VS Code commands, see [Visual Studio Code](./visual-studio-code.md).
5050

articles/azure-resource-manager/bicep/diagnostics/bcp338.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ title: BCP338
33
description: Failed to evaluate parameter <parameter-name>.
44
ms.topic: reference
55
ms.custom: devx-track-bicep
6-
ms.date: 08/09/2024
6+
ms.date: 12/06/2024
77
---
88

99
# Bicep diagnostic code - BCP338
1010

11-
This diagnostic occurs when Bicep can't resolve a parameter name in the Bicep parameter file.
11+
This diagnostic occurs when Bicep can't resolve a parameter name in the Bicep parameters file.
1212

1313
## Description
1414

@@ -24,7 +24,7 @@ Check the parameter value.
2424

2525
## Examples
2626

27-
The following Bicep parameter file raises the diagnostic because _testEnvironmentVariable_ can't be found:
27+
The following Bicep parameters file raises the diagnostic because _testEnvironmentVariable_ can't be found:
2828

2929
```bicep
3030
using 'main.bicep'

articles/azure-resource-manager/bicep/key-vault-parameter.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Key Vault secret with Bicep
33
description: Shows how to pass a secret from a key vault as a parameter during Bicep deployment.
44
ms.topic: conceptual
55
ms.custom: devx-track-azurepowershell, devx-track-azurecli, devx-track-bicep
6-
ms.date: 05/06/2024
6+
ms.date: 12/06/2024
77
---
88

99
# Use Azure Key Vault to pass secure parameter value during Bicep deployment
@@ -155,7 +155,7 @@ When using a key vault with the Bicep file for a [Managed Application](../manage
155155

156156
You can use the [getSecret function](./bicep-functions-resource.md#getsecret) in Bicep files to obtain a key vault secret. Note that the `getSecret` function is exclusively applicable to a `Microsoft.KeyVault/vaults` resource. Additionally, it's restricted to usage within the `params` section of a module and can only be used with parameters with the `@secure()` decorator.
157157

158-
Another function called `az.getSecret()` function can be used in Bicep parameter files to retrieve key vault secrets. For more information, see [Retrieve secrets in parameters file](#retrieve-secrets-in-parameters-file).
158+
Another function called `az.getSecret()` function can be used in Bicep parameters files to retrieve key vault secrets. For more information, see [Retrieve secrets in parameters file](#retrieve-secrets-in-parameters-file).
159159

160160
Because the `getSecret` function can only be used in the `params` section of a module. Let's create a *sql.bicep* in the same directory as the *main.bicep* file with the following content:
161161

@@ -207,7 +207,7 @@ module sql './sql.bicep' = {
207207

208208
## Retrieve secrets in parameters file
209209

210-
If you don't want to use a module, you can retrieve key vault secrets in parameters file. However, the approach varies depending on whether you're using a JSON parameter file or a Bicep parameter file.
210+
If you don't want to use a module, you can retrieve key vault secrets in parameters file. However, the approach varies depending on whether you're using a JSON parameters file or a Bicep parameters file.
211211

212212
The following Bicep file deploys a SQL server that includes an administrator password. The password parameter is set to a secure string. But the Bicep doesn't specify where that value comes from.
213213

@@ -232,7 +232,7 @@ resource sqlServer 'Microsoft.Sql/servers@2023-08-01-preview' = {
232232

233233
Now, create a parameters file for the preceding Bicep file.
234234

235-
### Bicep parameter file
235+
### Bicep parameters file
236236

237237
[`az.getSecret`](./bicep-functions-parameters-file.md#getsecret) function can be used in a `.bicepparam` file to retrieve the value of a secret from a key vault.
238238

@@ -244,7 +244,7 @@ param adminLogin = '<your-admin-login>'
244244
param adminPassword = az.getSecret('<subscription-id>', '<rg-name>', '<key-vault-name>', '<secret-name>', '<secret-version>')
245245
```
246246

247-
### JSON parameter file
247+
### JSON parameters file
248248

249249
In the JSON parameters file, specify a parameter that matches the name of the parameter in the Bicep file. For the parameter value, reference the secret from the key vault. You reference the secret by passing the resource identifier of the key vault and the name of the secret:
250250

0 commit comments

Comments
 (0)