Skip to content

Commit d331914

Browse files
committedOct 30, 2018
fixes MicrosoftDocs/azure-docs#17742
1 parent 78df6bb commit d331914

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed
 

‎articles/azure-resource-manager/resource-manager-templates-parameters.md

+11-11
Original file line numberDiff line numberDiff line change
@@ -12,14 +12,14 @@ ms.devlang: na
1212
ms.topic: conceptual
1313
ms.tgt_pltfrm: na
1414
ms.workload: na
15-
ms.date: 05/18/2018
15+
ms.date: 10/30/2018
1616
ms.author: tomfitz
1717

1818
---
1919
# Parameters section of Azure Resource Manager templates
20-
In the parameters section of the template, you specify which values you can input when deploying the resources. These parameter values enable you to customize the deployment by providing values that are tailored for a particular environment (such as dev, test, and production). You do not have to provide parameters in your template, but without parameters your template would always deploy the same resources with the same names, locations, and properties.
20+
In the parameters section of the template, you specify which values you can input when deploying the resources. These parameter values enable you to customize the deployment by providing values that are tailored for a particular environment (such as dev, test, and production). You don't have to provide parameters in your template, but without parameters your template would always deploy the same resources with the same names, locations, and properties.
2121

22-
You are limited to 255 parameters in a template. You can reduce the number of parameters by using objects that contain multiple properties, as shown in this article.
22+
You're limited to 256 parameters in a template. You can reduce the number of parameters by using objects that contain multiple properties, as shown in this article.
2323

2424
## Define and use a parameter
2525

@@ -93,7 +93,7 @@ The preceding example showed only some of the properties you can use in the para
9393

9494
## Template functions with parameters
9595

96-
When providing the default value for a parameter, you can use most template functions. You can use another parameter value to build a default value. The following template demonstrates the use of functions in the default value:
96+
When specifying the default value for a parameter, you can use most template functions. You can use another parameter value to build a default value. The following template demonstrates the use of functions in the default value:
9797

9898
```json
9999
"parameters": {
@@ -114,7 +114,7 @@ When providing the default value for a parameter, you can use most template func
114114
}
115115
```
116116

117-
You cannot use the `reference` function in the parameters section. Parameters are evaluated before deployment so the `reference` function cannot obtain the runtime state of a resource.
117+
You can't use the `reference` function in the parameters section. Parameters are evaluated before deployment so the `reference` function can't get the runtime state of a resource.
118118

119119
## Objects as parameters
120120

@@ -193,7 +193,7 @@ The following information can be helpful when you work with parameters:
193193
* Resource names that you want to specify for easy identification.
194194
* Values that you use frequently to complete other tasks (such as an admin user name).
195195
* Secrets (such as passwords).
196-
* The number or array of values to use when you create multiple instances of a resource type.
196+
* The number or array of values to use when you create more than one instance of a resource type.
197197
* Use camel case for parameter names.
198198
* Provide a description of every parameter in the metadata:
199199

@@ -208,7 +208,7 @@ The following information can be helpful when you work with parameters:
208208
}
209209
```
210210

211-
* Define default values for parameters (except for passwords and SSH keys). By providing a default value, the parameter becomes optional during deployment. The default value can be an empty string.
211+
* Define default values for parameters (except for passwords and SSH keys). By specifying a default value, the parameter becomes optional during deployment. The default value can be an empty string.
212212

213213
```json
214214
"parameters": {
@@ -222,7 +222,7 @@ The following information can be helpful when you work with parameters:
222222
}
223223
```
224224

225-
* Use **securestring** for all passwords and secrets. If you pass sensitive data in a JSON object, use the **secureObject** type. Template parameters with securestring or secureObject types cannot be read after resource deployment.
225+
* Use **securestring** for all passwords and secrets. If you pass sensitive data in a JSON object, use the **secureObject** type. Template parameters with securestring or secureObject types can't be read after resource deployment.
226226

227227
```json
228228
"parameters": {
@@ -235,7 +235,7 @@ The following information can be helpful when you work with parameters:
235235
}
236236
```
237237

238-
* Use a parameter to specify location, and share that parameter value as much as possible with resources that are likely to be in the same location. This approach minimizes the number of times users are asked to provide location information. If a resource type is supported in only a limited number of locations, you might want to specify a valid location directly in the template, or add another location parameter. When an organization limits the allowed regions for its users, the **resourceGroup().location** expression might prevent a user from being able to deploy the template. For example, one user creates a resource group in a region. A second user must deploy to that resource group but does not have access to the region.
238+
* Use a parameter to specify location, and share that parameter value as much as possible with resources that are likely to be in the same location. This approach minimizes the number of times users are asked to provide location information. If a resource type is supported in only a limited number of locations, you might want to specify a valid location directly in the template, or add another location parameter. When an organization limits the allowed regions for its users, the **resourceGroup().location** expression might prevent a user from deploying the template. For example, one user creates a resource group in a region. A second user must deploy to that resource group but does not have access to the region.
239239

240240
```json
241241
"resources": [
@@ -258,8 +258,8 @@ These example templates demonstrate some scenarios for using parameters. Deploy
258258

259259
|Template |Description |
260260
|---------|---------|
261-
|[parameters with functions for default values](https://github.com/Azure/azure-docs-json-samples/blob/master/azure-resource-manager/parameterswithfunctions.json) | Demonstrates how to use template functions when defining default values for parameters. The template does not deploy any resources. It constructs parameter values and returns those values. |
262-
|[parameter object](https://github.com/Azure/azure-docs-json-samples/blob/master/azure-resource-manager/parameterobject.json) | Demonstrates using an object for a parameter. The template does not deploy any resources. It constructs parameter values and returns those values. |
261+
|[parameters with functions for default values](https://github.com/Azure/azure-docs-json-samples/blob/master/azure-resource-manager/parameterswithfunctions.json) | Demonstrates how to use template functions when defining default values for parameters. The template doesn't deploy any resources. It constructs parameter values and returns those values. |
262+
|[parameter object](https://github.com/Azure/azure-docs-json-samples/blob/master/azure-resource-manager/parameterobject.json) | Demonstrates using an object for a parameter. The template doesn't deploy any resources. It constructs parameter values and returns those values. |
263263

264264
## Next steps
265265

0 commit comments

Comments
 (0)
Please sign in to comment.