Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Resource Manager biedt de volgende functies voor het werken met tekenreeksen in uw Azure Resource Manager-sjabloon (ARM-sjabloon):
- base64
- base64ToJson
- base64ToString
- concat
- Bevat
- dataUri
- dataUriToString
- empty
- endsWith
- eerste
- format
- Guid
- indexOf
- join
- json
- laatste
- lastIndexOf
- length
- newGuid
- padLeft
- replace
- skip
- split
- startsWith
- snaar
- Subtekenreeks
- nemen
- toLower
- toUpper
- trim
- uniqueString
- Uri
- uriComponent
- uriComponentToString
Tip
Bicep wordt aanbevolen omdat het dezelfde mogelijkheden biedt als ARM-sjablonen en de syntaxis gemakkelijker te gebruiken is. Zie tekenreeksfuncties voor meer informatie.
base64
base64(inputString)
Retourneert de base64-weergave van de invoertekenreeks.
Gebruik in Bicep de base64 functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| inputString | Ja | tekenreeks | De waarde die moet worden geretourneerd als een base64-weergave. |
Retourwaarde
Een tekenreeks met de base64-weergave.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de base64 functie gebruikt:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"storageResourceGroup": {
"type": "string"
},
"storageAccountName": {
"type": "string"
}
},
"resources": [],
"outputs": {
"ExistingStorage": {
"type": "object",
"value": "[reference(resourceId(parameters('storageResourceGroup'), 'Microsoft.Storage/storageAccounts', parameters('storageAccountName')), '2021-04-01')]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| base64Output | String | b25lLCB0d28sIHRocmVl |
| toStringOutput | String | Een twee drie |
| toJsonOutput | Object | {"one": "a", "two": "b"} |
base64ToJson
base64ToJson(base64Value)
Converteert een base64-weergave naar een JSON-object.
Gebruik in Bicep de base64ToJson functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| base64Value | Ja | tekenreeks | De base64-weergave die moet worden geconverteerd naar een JSON-object. |
Retourwaarde
Een JSON-object.
Voorbeelden
In het volgende voorbeeld wordt de base64ToJson functie gebruikt om een base64-waarde te converteren:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"storageResourceGroup": {
"type": "string"
},
"storageAccountName": {
"type": "string"
}
},
"resources": [],
"outputs": {
"ExistingStorage": {
"type": "object",
"value": "[reference(resourceId(parameters('storageResourceGroup'), 'Microsoft.Storage/storageAccounts', parameters('storageAccountName')), '2021-04-01')]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| base64Output | String | b25lLCB0d28sIHRocmVl |
| toStringOutput | String | Een twee drie |
| toJsonOutput | Object | {"one": "a", "two": "b"} |
base64ToString
base64ToString(base64Value)
Converteert een base64-weergave naar een tekenreeks.
Gebruik in Bicep de base64ToString functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| base64Value | Ja | tekenreeks | De base64-weergave die moet worden geconverteerd naar een tekenreeks. |
Retourwaarde
Een tekenreeks van de geconverteerde base64-waarde.
Voorbeelden
In het volgende voorbeeld wordt de base64ToString functie gebruikt om een base64-waarde te converteren:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"storageResourceGroup": {
"type": "string"
},
"storageAccountName": {
"type": "string"
}
},
"resources": [],
"outputs": {
"ExistingStorage": {
"type": "object",
"value": "[reference(resourceId(parameters('storageResourceGroup'), 'Microsoft.Storage/storageAccounts', parameters('storageAccountName')), '2021-04-01')]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| base64Output | String | b25lLCB0d28sIHRocmVl |
| toStringOutput | String | Een twee drie |
| toJsonOutput | Object | {"one": "a", "two": "b"} |
concat
concat(arg1, arg2, arg3, ...)
Combineert meerdere tekenreekswaarden en retourneert de samengevoegde tekenreeks, of combineert meerdere matrices en retourneert de samengevoegde matrix.
Gebruik in Bicep tekenreeksinterpolatie in plaats van de functie om de concat() leesbaarheid te verbeteren. In sommige gevallen, zoals het vervangen van tekenreeksen in tekenreeksen met meerdere regels, moet u mogelijk terugvallen op het gebruik van de concat() functie of de replace() functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| arg1 | Ja | tekenreeks of matrix | De eerste tekenreeks of matrix voor samenvoeging. |
| meer argumenten | Nee | tekenreeks of matrix | Meer tekenreeksen of matrices in opeenvolgende volgorde voor samenvoeging. |
Deze functie kan een willekeurig aantal argumenten aannemen en kan tekenreeksen of matrices voor de parameters accepteren. U kunt echter niet zowel matrices als tekenreeksen opgeven voor parameters. Tekenreeksen worden alleen samengevoegd met andere tekenreeksen.
Retourwaarde
Een tekenreeks of matrix met samengevoegde waarden.
Voorbeelden
In het volgende voorbeeld ziet u hoe u twee tekenreekswaarden combineert en een samengevoegde tekenreeks retourneert:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"prefix": {
"type": "string",
"defaultValue": "prefix"
}
},
"resources": [],
"outputs": {
"concatOutput": {
"type": "string",
"value": "[concat(parameters('prefix'), '-', uniqueString(resourceGroup().id))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| concatOutput | String | prefix-5yj4yjf5mbg72 |
In het volgende voorbeeld ziet u hoe u twee matrices combineert:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"firstArray": {
"type": "array",
"defaultValue": [
"1-1",
"1-2",
"1-3"
]
},
"secondArray": {
"type": "array",
"defaultValue": [
"2-1",
"2-2",
"2-3"
]
}
},
"resources": [
],
"outputs": {
"return": {
"type": "array",
"value": "[concat(parameters('firstArray'), parameters('secondArray'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| enter | Matrix | ["1-1", "1-2", "1-3", "2-1", "2-2", "2-3"] |
bevat
contains(container, itemToFind)
Hiermee wordt gecontroleerd of een matrix een waarde bevat, een object een sleutel bevat of een tekenreeks een subtekenreeks bevat. De tekenreeksvergelijking is hoofdlettergevoelig. Wanneer u echter test of een object een sleutel bevat, is de vergelijking niet hoofdlettergevoelig.
Gebruik in Bicep de contains functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| container | Ja | matrix, object of tekenreeks | De waarde die de te zoeken waarde bevat. |
| itemToFind | Ja | tekenreeks of int | De te vinden waarde. |
Retourwaarde
True als het item wordt gevonden; anders, False.
Voorbeelden
In het volgende voorbeeld ziet u hoe u deze kunt gebruiken contains met verschillende typen:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stringToTest": {
"type": "string",
"defaultValue": "OneTwoThree"
},
"objectToTest": {
"type": "object",
"defaultValue": {
"one": "a",
"two": "b",
"three": "c"
}
},
"arrayToTest": {
"type": "array",
"defaultValue": [ "one", "two", "three" ]
}
},
"resources": [
],
"outputs": {
"stringTrue": {
"type": "bool",
"value": "[contains(parameters('stringToTest'), 'e')]"
},
"stringFalse": {
"type": "bool",
"value": "[contains(parameters('stringToTest'), 'z')]"
},
"objectTrue": {
"type": "bool",
"value": "[contains(parameters('objectToTest'), 'one')]"
},
"objectFalse": {
"type": "bool",
"value": "[contains(parameters('objectToTest'), 'a')]"
},
"arrayTrue": {
"type": "bool",
"value": "[contains(parameters('arrayToTest'), 'three')]"
},
"arrayFalse": {
"type": "bool",
"value": "[contains(parameters('arrayToTest'), 'four')]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| stringTrue | Bool | Waar |
| stringFalse | Bool | Onwaar |
| objectTrue | Bool | Waar |
| objectFalse | Bool | Onwaar |
| arrayTrue | Bool | Waar |
| arrayFalse | Bool | Onwaar |
dataUri
dataUri(stringToConvert)
Converteert een waarde naar een gegevens-URI.
Gebruik in Bicep de dataUri functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| stringToConvert | Ja | tekenreeks | De waarde die moet worden geconverteerd naar een gegevens-URI. |
Retourwaarde
Een tekenreeks die is opgemaakt als een gegevens-URI.
Voorbeelden
In het volgende voorbeeld wordt een waarde geconverteerd naar een gegevens-URI en een gegevens-URI naar een tekenreeks:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stringToTest": {
"type": "string",
"defaultValue": "Hello"
},
"dataFormattedString": {
"type": "string",
"defaultValue": "data:;base64,SGVsbG8sIFdvcmxkIQ=="
}
},
"resources": [],
"outputs": {
"dataUriOutput": {
"value": "[dataUri(parameters('stringToTest'))]",
"type": "string"
},
"toStringOutput": {
"type": "string",
"value": "[dataUriToString(parameters('dataFormattedString'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| dataUriOutput | String | data:text/plain; charset=utf8; base64,SGVsbG8= |
| toStringOutput | String | Hallo wereld! |
dataUriToString
dataUriToString(dataUriToConvert)
Converteert een gegevens-URI-opgemaakte waarde naar een tekenreeks.
Gebruik in Bicep de dataUriToString functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| dataUriToConvert | Ja | tekenreeks | De gegevens-URI-waarde die moet worden geconverteerd. |
Retourwaarde
Een tekenreeks met de geconverteerde waarde.
Voorbeelden
Met de volgende voorbeeldsjabloon wordt een waarde geconverteerd naar een gegevens-URI en een gegevens-URI naar een tekenreeks:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stringToTest": {
"type": "string",
"defaultValue": "Hello"
},
"dataFormattedString": {
"type": "string",
"defaultValue": "data:;base64,SGVsbG8sIFdvcmxkIQ=="
}
},
"resources": [],
"outputs": {
"dataUriOutput": {
"value": "[dataUri(parameters('stringToTest'))]",
"type": "string"
},
"toStringOutput": {
"type": "string",
"value": "[dataUriToString(parameters('dataFormattedString'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| dataUriOutput | String | data:text/plain; charset=utf8; base64,SGVsbG8= |
| toStringOutput | String | Hallo wereld! |
empty
empty(itemToTest)
Bepaalt of een matrix, object of tekenreeks leeg is.
Gebruik in Bicep de empty functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| itemToTest | Ja | matrix, object of tekenreeks | De waarde om te controleren of deze leeg is. |
Retourwaarde
Retourneert True als de waarde leeg is; Falseanders.
Voorbeelden
In het volgende voorbeeld wordt gecontroleerd of een matrix, object en tekenreeks leeg zijn:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"testArray": {
"type": "array",
"defaultValue": []
},
"testObject": {
"type": "object",
"defaultValue": {}
},
"testString": {
"type": "string",
"defaultValue": ""
}
},
"resources": [
],
"outputs": {
"arrayEmpty": {
"type": "bool",
"value": "[empty(parameters('testArray'))]"
},
"objectEmpty": {
"type": "bool",
"value": "[empty(parameters('testObject'))]"
},
"stringEmpty": {
"type": "bool",
"value": "[empty(parameters('testString'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| arrayEmpty | Bool | Waar |
| objectEmpty | Bool | Waar |
| stringEmpty | Bool | Waar |
endsWith
endsWith(stringToSearch, stringToFind)
Bepaalt of een tekenreeks eindigt op een waarde. De vergelijking is niet hoofdlettergevoelig.
Gebruik in Bicep de endsWith functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| stringToSearch | Ja | tekenreeks | De waarde die het item bevat dat moet worden gevonden. |
| stringToFind | Ja | tekenreeks | De te vinden waarde. |
Retourwaarde
True als het laatste teken of de laatste tekens van de tekenreeks overeenkomen met de waarde; anders, False.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de startsWith functies en endsWith functies gebruikt:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [],
"outputs": {
"startsTrue": {
"type": "bool",
"value": "[startsWith('abcdef', 'ab')]"
},
"startsCapTrue": {
"type": "bool",
"value": "[startsWith('abcdef', 'A')]"
},
"startsFalse": {
"type": "bool",
"value": "[startsWith('abcdef', 'e')]"
},
"endsTrue": {
"type": "bool",
"value": "[endsWith('abcdef', 'ef')]"
},
"endsCapTrue": {
"type": "bool",
"value": "[endsWith('abcdef', 'F')]"
},
"endsFalse": {
"type": "bool",
"value": "[endsWith('abcdef', 'e')]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| startsTrue | Bool | Waar |
| startsCapTrue | Bool | Waar |
| startsFalse | Bool | Onwaar |
| endsTrue | Bool | Waar |
| endsCapTrue | Bool | Waar |
| endsFalse | Bool | Onwaar |
Eerste
first(arg1)
Retourneert het eerste teken van de tekenreeks of het eerste element van de matrix. Als er een lege tekenreeks wordt gegeven, resulteert de functie in een lege tekenreeks. In het geval van een lege matrix retourneert nullde functie .
Gebruik in Bicep de first functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| arg1 | Ja | matrix of tekenreeks | De waarde voor het ophalen van het eerste element of teken. |
Retourwaarde
Een tekenreeks van het eerste teken of het type (tekenreeks, int, matrix of object) van het eerste element in een matrix.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de first functie gebruikt met een matrix en een tekenreeks:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"arrayToTest": {
"type": "array",
"defaultValue": [ "one", "two", "three" ]
}
},
"resources": [
],
"outputs": {
"arrayOutput": {
"type": "string",
"value": "[first(parameters('arrayToTest'))]"
},
"stringOutput": {
"type": "string",
"value": "[first('One Two Three')]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| arrayOutput | String | één |
| stringOutput | String | O |
indeling
format(formatString, arg1, arg2, ...)
Hiermee maakt u een opgemaakte tekenreeks op basis van invoerwaarden.
Gebruik in Bicep de format functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| formatString | Ja | tekenreeks | De tekenreeks voor samengestelde notatie. |
| arg1 | Ja | tekenreeks, geheel getal of Booleaanse waarde | De waarde die moet worden opgenomen in de opgemaakte tekenreeks. |
| meer argumenten | Nee | tekenreeks, geheel getal of Booleaanse waarde | Meer waarden die moeten worden opgenomen in de opgemaakte tekenreeks. |
Opmerkingen
Gebruik deze functie om een tekenreeks in uw sjabloon op te maken. Er worden dezelfde opmaakopties gebruikt als de methode System.String.Format in .NET.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de format functie gebruikt:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"greeting": {
"type": "string",
"defaultValue": "Hello"
},
"name": {
"type": "string",
"defaultValue": "User"
},
"numberToFormat": {
"type": "int",
"defaultValue": 8175133
}
},
"resources": [
],
"outputs": {
"formatTest": {
"type": "string",
"value": "[format('{0}, {1}. Formatted number: {2:N0}', parameters('greeting'), parameters('name'), parameters('numberToFormat'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| formatTest | String | Hallo, gebruiker. Opgemaakt getal: 8.175.133 |
guid
guid(baseString, ...)
Hiermee maakt u een waarde in de notatie van een globaal unieke id op basis van de waarden die als parameters zijn opgegeven.
Gebruik in Bicep de guid functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| baseString | Ja | tekenreeks | De waarde die wordt gebruikt in de hash-functie om de GUID te maken. |
| meer parameters indien nodig | Nee | tekenreeks | U kunt zoveel tekenreeksen toevoegen als nodig is om de waarde te maken die het uniekheidsniveau aangeeft. |
Opmerkingen
Deze functie is handig wanneer u een waarde moet maken in de indeling van een globally unique identifier. U geeft parameterwaarden op waarmee het bereik van uniekheid voor het resultaat wordt beperkt. U kunt opgeven of de naam uniek is voor abonnement, resourcegroep of implementatie.
De geretourneerde waarde is geen willekeurige tekenreeks, maar eerder het resultaat van een hash-functie op de parameters. De geretourneerde waarde is 36 tekens lang. Het is niet wereldwijd uniek. Als u een nieuwe GUID wilt maken die niet is gebaseerd op die hashwaarde van de parameters, gebruikt u de newGuid functie.
In de volgende voorbeelden ziet u hoe guid u een unieke waarde maakt voor veelgebruikte niveaus:
Uniek bereik voor abonnement
"[guid(subscription().subscriptionId)]"
Uniek bereik voor resourcegroep
"[guid(resourceGroup().id)]"
Uniek bereik voor implementatie voor een resourcegroep
"[guid(resourceGroup().id, deployment().name)]"
De guid functie implementeert het algoritme van RFC 4122 §4.3. De oorspronkelijke bron is te vinden in GuidUtility met enkele wijzigingen. In de guid() functie-implementatie is het namespaceId ingesteld op 11fb06fb-712d-4ddd-98c7-e71bbd588830, en de version is ingesteld op 5. De waarde wordt gegenereerd door elke parameter van de guid() functie te converteren naar een tekenreeks en deze samen te voegen als - scheidingstekens.
Retourwaarde
Een tekenreeks met 36 tekens in de notatie van een globally unique identifier.
Voorbeelden
Het volgende voorbeeld retourneert resultaten van guid:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {},
"variables": {},
"resources": [],
"outputs": {
"guidPerSubscription": {
"type": "string",
"value": "[guid(subscription().subscriptionId)]"
},
"guidPerResourceGroup": {
"type": "string",
"value": "[guid(resourceGroup().id)]"
},
"guidPerDeployment": {
"type": "string",
"value": "[guid(resourceGroup().id, deployment().name)]"
}
}
}
indexOf
indexOf(stringToSearch, stringToFind)
Retourneert de eerste positie van een waarde binnen een tekenreeks. De vergelijking is niet hoofdlettergevoelig.
Gebruik in Bicep de indexOf functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| stringToSearch | Ja | tekenreeks | De waarde die het item bevat dat moet worden gevonden. |
| stringToFind | Ja | tekenreeks | De te vinden waarde. |
Retourwaarde
Een geheel getal dat de positie van het item aangeeft dat moet worden gevonden. De waarde is gebaseerd op nul. Als het item niet wordt gevonden, wordt -1 geretourneerd.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de indexOf functies en lastIndexOf functies gebruikt:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [],
"outputs": {
"firstT": {
"type": "int",
"value": "[indexOf('test', 't')]"
},
"lastT": {
"type": "int",
"value": "[lastIndexOf('test', 't')]"
},
"firstString": {
"type": "int",
"value": "[indexOf('abcdef', 'CD')]"
},
"lastString": {
"type": "int",
"value": "[lastIndexOf('abcdef', 'AB')]"
},
"notFound": {
"type": "int",
"value": "[indexOf('abcdef', 'z')]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| firstT | Int | 0 |
| lastT | Int | 3 |
| firstString | Int | 2 |
| lastString | Int | 0 |
| notFound | Int | -1 |
join
join(inputArray, delimiter)
Hiermee wordt een tekenreeksmatrix samengevoegd tot één tekenreeks, gescheiden met behulp van een scheidingsteken.
Gebruik in Bicep de join functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| inputArray | Ja | tekenreeksmatrix | Een matrix met tekenreeks die moet worden samengevoegd. |
| scheidingsteken | Ja | Het scheidingsteken dat moet worden gebruikt voor het splitsen van de tekenreeks. |
Retourwaarde
Een tekenreeks.
Voorbeelden
In het volgende voorbeeld wordt de invoertekenreeksmatrix samengevoegd tot tekenreeksen die worden gescheiden door verschillende scheidingstekens:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"variables": {
"arrayString": [
"one",
"two",
"three"
]
},
"resources": [],
"outputs": {
"firstOutput": {
"type": "string",
"value": "[join(variables('arrayString'), ',')]"
},
"secondOutput": {
"type": "string",
"value": "[join(variables('arrayString'), ';')]"
}
}
}
De uitvoer uit het voorgaande voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| firstOutput | String | "één,twee,drie" |
| secondOutput | String | "één; Twee; drie" |
json
json(arg1)
Converteert een geldige JSON-tekenreeks naar een JSON-gegevenstype. Zie de functie voor meer informatie json .
Gebruik in Bicep de json functie.
Laatste
last(arg1)
Retourneert het laatste teken van de tekenreeks of het laatste element van de matrix.
Gebruik in Bicep de last functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| arg1 | Ja | matrix of tekenreeks | De waarde voor het ophalen van het laatste element of teken. |
Retourwaarde
Een tekenreeks van het laatste teken of het type (tekenreeks, int, matrix of object) van het laatste element in een matrix.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de last functie gebruikt met een matrix en een tekenreeks:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"arrayToTest": {
"type": "array",
"defaultValue": [ "one", "two", "three" ]
}
},
"resources": [
],
"outputs": {
"arrayOutput": {
"type": "string",
"value": "[last(parameters('arrayToTest'))]"
},
"stringOutput": {
"type": "string",
"value": "[last('One Two Three')]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| arrayOutput | String | drie |
| stringOutput | String | e |
lastIndexOf
lastIndexOf(stringToSearch, stringToFind)
Retourneert de laatste positie van een waarde binnen een tekenreeks. De vergelijking is niet hoofdlettergevoelig.
Gebruik in Bicep de lastIndexOf functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| stringToSearch | Ja | tekenreeks | De waarde die het item bevat dat moet worden gevonden. |
| stringToFind | Ja | tekenreeks | De te vinden waarde. |
Retourwaarde
Een geheel getal dat de laatste positie van het item aangeeft dat moet worden gevonden. De waarde is gebaseerd op nul. Als het item niet wordt gevonden, wordt -1 geretourneerd.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de indexOf functies en lastIndexOf functies gebruikt:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [],
"outputs": {
"firstT": {
"type": "int",
"value": "[indexOf('test', 't')]"
},
"lastT": {
"type": "int",
"value": "[lastIndexOf('test', 't')]"
},
"firstString": {
"type": "int",
"value": "[indexOf('abcdef', 'CD')]"
},
"lastString": {
"type": "int",
"value": "[lastIndexOf('abcdef', 'AB')]"
},
"notFound": {
"type": "int",
"value": "[indexOf('abcdef', 'z')]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| firstT | Int | 0 |
| lastT | Int | 3 |
| firstString | Int | 2 |
| lastString | Int | 0 |
| notFound | Int | -1 |
length
length(string)
Retourneert het aantal tekens in een tekenreeks, elementen in een matrix of eigenschappen op hoofdniveau in een object.
Gebruik in Bicep de length functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| arg1 | Ja | matrix, tekenreeks of object | De matrix die moet worden gebruikt voor het ophalen van het aantal elementen, de tekenreeks die moet worden gebruikt voor het ophalen van het aantal tekens of het object dat moet worden gebruikt voor het ophalen van het aantal eigenschappen op hoofdniveau. |
Retourwaarde
Een int.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de length functie gebruikt met een matrix en een tekenreeks:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"arrayToTest": {
"type": "array",
"defaultValue": [
"one",
"two",
"three"
]
},
"stringToTest": {
"type": "string",
"defaultValue": "One Two Three"
},
"objectToTest": {
"type": "object",
"defaultValue": {
"propA": "one",
"propB": "two",
"propC": "three",
"propD": {
"propD-1": "sub",
"propD-2": "sub"
}
}
}
},
"resources": [],
"outputs": {
"arrayLength": {
"type": "int",
"value": "[length(parameters('arrayToTest'))]"
},
"stringLength": {
"type": "int",
"value": "[length(parameters('stringToTest'))]"
},
"objectLength": {
"type": "int",
"value": "[length(parameters('objectToTest'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| arrayLength | Int | 3 |
| stringLength | Int | 13 |
| objectLength | Int | 4 |
newGuid
newGuid()
Retourneert een waarde in de notatie van een globaal unieke id. Deze functie kan alleen worden gebruikt in de standaardwaarde voor een parameter.
Gebruik in Bicep de newGuid functie.
Opmerkingen
U kunt deze functie alleen gebruiken in een expressie voor de standaardwaarde van een parameter. Als u deze functie ergens anders in een sjabloon gebruikt, wordt een fout geretourneerd. De functie is niet toegestaan in andere delen van de sjabloon, omdat deze elke keer dat deze wordt aangeroepen een andere waarde retourneert. Het implementeren van dezelfde sjabloon met dezelfde parameters zou niet betrouwbaar dezelfde resultaten opleveren.
De functie newGuid verschilt van de guid functie omdat deze geen parameters accepteert. Wanneer u guid aanroept met dezelfde parameter, wordt elke keer dezelfde id geretourneerd. Gebruik guid wanneer u op betrouwbare wijze dezelfde GUID voor een specifieke omgeving moet genereren. Gebruik newGuid wanneer u elke keer een andere id nodig hebt, zoals het implementeren van resources in een testomgeving.
De functie newGuid maakt gebruik van de GUID-structuur in .NET Framework om de globally unique identifier te genereren.
Als u de optie gebruikt om een eerdere geslaagde implementatie opnieuw te implementeren waarbij de eerdere implementatie een parameter bevat die wordt gebruikt newGuid, wordt de parameter niet opnieuw geëvalueerd. In plaats daarvan wordt met de implementatie van terugdraaien automatisch de parameterwaarde van de eerdere implementatie opnieuw gebruikt.
In een testomgeving moet u resources die slechts korte tijd actief zijn, herhaaldelijk implementeren. In plaats van unieke namen te maken, kunt u newGuid uniqueString gebruiken om unieke namen te maken.
Wees voorzichtig met het opnieuw implementeren van een sjabloon die afhankelijk is van de newGuid functie voor een standaardwaarde. Wanneer u de parameter opnieuw implementeert en geen waarde opgeeft, wordt de functie opnieuw geëvalueerd. Als u een bestaande resource wilt bijwerken in plaats van een nieuwe resource te maken, geeft u de parameterwaarde van de eerdere implementatie door.
Retourwaarde
Een tekenreeks met 36 tekens in de notatie van een globally unique identifier.
Voorbeelden
In het volgende voorbeeld ziet u een parameter met een nieuwe id:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"guidValue": {
"type": "string",
"defaultValue": "[newGuid()]"
}
},
"resources": [
],
"outputs": {
"guidOutput": {
"type": "string",
"value": "[parameters('guidValue')]"
}
}
}
De uitvoer van het vorige voorbeeld varieert voor elke implementatie, maar is vergelijkbaar met:
| Name | Type | Weergegeven als |
|---|---|---|
| guidOutput | tekenreeks | b76a51fc-bd72-4a77-b9a2-3c29e7d2e551 |
In het volgende voorbeeld wordt de newGuid functie gebruikt om een unieke naam voor een opslagaccount te maken. Deze sjabloon werkt mogelijk voor een testomgeving waarin het opslagaccount gedurende korte tijd bestaat en niet opnieuw wordt geïmplementeerd:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"guidValue": {
"type": "string",
"defaultValue": "[newGuid()]"
}
},
"variables": {
"storageName": "[concat('storage', uniqueString(parameters('guidValue')))]"
},
"resources": [
{
"type": "Microsoft.Storage/storageAccounts",
"apiVersion": "2021-04-01",
"name": "[variables('storageName')]",
"location": "West US",
"sku": {
"name": "Standard_LRS"
},
"kind": "StorageV2",
"properties": {}
}
],
"outputs": {
"nameOutput": {
"type": "string",
"value": "[variables('storageName')]"
}
}
}
De uitvoer van het vorige voorbeeld varieert voor elke implementatie, maar is vergelijkbaar met:
| Name | Type | Weergegeven als |
|---|---|---|
| nameOutput | tekenreeks | storagenziwvyru7uxie |
padLeft
padLeft(valueToPad, totalLength, paddingCharacter)
Retourneert een rechts uitgelijnde tekenreeks door tekens aan de linkerkant toe te voegen totdat de totale opgegeven lengte is bereikt.
Gebruik in Bicep de padLeft functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| valueToPad | Ja | tekenreeks of int | De waarde om rechts uit te lijnen. |
| totalLength | Ja | int | Het totale aantal tekens in de geretourneerde tekenreeks. |
| paddingCharacter | Nee | enkel teken | Het teken dat moet worden gebruikt voor linkeropvulling totdat de totale lengte is bereikt. De standaardwaarde is een spatie. |
Als de oorspronkelijke tekenreeks langer is dan het aantal tekens dat moet worden opgevuld, worden er geen tekens toegevoegd.
Retourwaarde
Een tekenreeks met ten minste het aantal opgegeven tekens.
Voorbeelden
In het volgende voorbeeld ziet u hoe u het nulteken toevoegt totdat het totale aantal tekens wordt bereikt dat de door de gebruiker opgegeven parameterwaarde opvult:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"testString": {
"type": "string",
"defaultValue": "123"
}
},
"resources": [],
"outputs": {
"stringOutput": {
"type": "string",
"value": "[padLeft(parameters('testString'),10,'0')]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| stringOutput | String | 0000000123 |
replace
replace(originalString, oldString, newString)
Retourneert een nieuwe tekenreeks met alle exemplaren van een tekenreeks die wordt vervangen door een andere tekenreeks.
Gebruik in Bicep de replace functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| originalString | Ja | tekenreeks | De waarde met alle exemplaren van één tekenreeks vervangen door een andere tekenreeks. |
| oldString | Ja | tekenreeks | De tekenreeks die moet worden verwijderd uit de oorspronkelijke tekenreeks. |
| newString | Ja | tekenreeks | De tekenreeks die moet worden toegevoegd in plaats van de verwijderde tekenreeks. |
Retourwaarde
Een tekenreeks met de vervangen tekens.
Voorbeelden
In het volgende voorbeeld ziet u hoe u alle streepjes verwijdert uit een door de gebruiker opgegeven tekenreeks en hoe u een deel van de tekenreeks vervangt door een andere tekenreeks:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"testString": {
"type": "string",
"defaultValue": "123-123-1234"
}
},
"resources": [],
"outputs": {
"firstOutput": {
"type": "string",
"value": "[replace(parameters('testString'),'-', '')]"
},
"secondOutput": {
"type": "string",
"value": "[replace(parameters('testString'),'1234', 'xxxx')]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| firstOutput | String | 1231231234 |
| secondOutput | String | 123-123-xxxx |
skip
skip(originalValue, numberToSkip)
Retourneert een tekenreeks met alle tekens na het opgegeven aantal tekens of een matrix met alle elementen na het opgegeven aantal elementen.
Gebruik in Bicep de skip functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| originalValue | Ja | matrix of tekenreeks | De matrix of tekenreeks die moet worden gebruikt voor het overslaan. |
| numberToSkip | Ja | int | Het aantal elementen of tekens dat moet worden overgeslagen. Als deze waarde 0 of minder is, worden alle elementen of tekens in de waarde geretourneerd. Als deze groter is dan de lengte van de matrix of tekenreeks, wordt een lege matrix of tekenreeks geretourneerd. |
Retourwaarde
Een matrix of tekenreeks.
Voorbeelden
In het volgende voorbeeld wordt het opgegeven aantal elementen in de matrix en het opgegeven aantal tekens in een tekenreeks overgeslagen:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"testArray": {
"type": "array",
"defaultValue": [
"one",
"two",
"three"
]
},
"elementsToSkip": {
"type": "int",
"defaultValue": 2
},
"testString": {
"type": "string",
"defaultValue": "one two three"
},
"charactersToSkip": {
"type": "int",
"defaultValue": 4
}
},
"resources": [],
"outputs": {
"arrayOutput": {
"type": "array",
"value": "[skip(parameters('testArray'),parameters('elementsToSkip'))]"
},
"stringOutput": {
"type": "string",
"value": "[skip(parameters('testString'),parameters('charactersToSkip'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| arrayOutput | Matrix | ["drie"] |
| stringOutput | String | twee drie |
split
split(inputString, delimiter)
Retourneert een matrix met tekenreeksen die de subtekenreeksen van de invoertekenreeks bevat die worden gescheiden door de opgegeven scheidingstekens.
Gebruik in Bicep de split functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| inputString | Ja | tekenreeks | De tekenreeks die moet worden gesplitst. |
| scheidingsteken | Ja | tekenreeks of matrix met tekenreeksen | Het scheidingsteken dat moet worden gebruikt voor het splitsen van de tekenreeks. |
Retourwaarde
Een matrix met tekenreeksen.
Voorbeelden
In het volgende voorbeeld wordt de invoertekenreeks gesplitst met een komma en de volgende tekenreeks met een komma of een puntkomma:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"firstString": {
"type": "string",
"defaultValue": "one,two,three"
},
"secondString": {
"type": "string",
"defaultValue": "one;two,three"
}
},
"variables": {
"delimiters": [ ",", ";" ]
},
"resources": [],
"outputs": {
"firstOutput": {
"type": "array",
"value": "[split(parameters('firstString'),',')]"
},
"secondOutput": {
"type": "array",
"value": "[split(parameters('secondString'),variables('delimiters'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| firstOutput | Matrix | ["één", "twee", "drie"] |
| secondOutput | Matrix | ["één", "twee", "drie"] |
startsWith
startsWith(stringToSearch, stringToFind)
Bepaalt of een tekenreeks begint met een waarde. De vergelijking is niet hoofdlettergevoelig.
Gebruik in Bicep de startsWith functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| stringToSearch | Ja | tekenreeks | De waarde die het item bevat dat moet worden gevonden. |
| stringToFind | Ja | tekenreeks | De te vinden waarde. |
Retourwaarde
True als het eerste teken of de eerste tekens van de tekenreeks overeenkomen met de waarde; anders, False.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de startsWith functies en endsWith functies gebruikt:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [],
"outputs": {
"startsTrue": {
"type": "bool",
"value": "[startsWith('abcdef', 'ab')]"
},
"startsCapTrue": {
"type": "bool",
"value": "[startsWith('abcdef', 'A')]"
},
"startsFalse": {
"type": "bool",
"value": "[startsWith('abcdef', 'e')]"
},
"endsTrue": {
"type": "bool",
"value": "[endsWith('abcdef', 'ef')]"
},
"endsCapTrue": {
"type": "bool",
"value": "[endsWith('abcdef', 'F')]"
},
"endsFalse": {
"type": "bool",
"value": "[endsWith('abcdef', 'e')]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| startsTrue | Bool | Waar |
| startsCapTrue | Bool | Waar |
| startsFalse | Bool | Onwaar |
| endsTrue | Bool | Waar |
| endsCapTrue | Bool | Waar |
| endsFalse | Bool | Onwaar |
tekenreeks
string(valueToConvert)
Converteert de opgegeven waarde naar een tekenreeks.
Gebruik in Bicep de string functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| valueToConvert | Ja | Alle | De waarde die moet worden geconverteerd naar een tekenreeks. Elk type waarde kan worden geconverteerd, inclusief objecten en matrices. |
Retourwaarde
Een tekenreeks van de geconverteerde waarde.
Voorbeelden
In het volgende voorbeeld ziet u hoe u verschillende typen waarden converteert naar tekenreeksen:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"testObject": {
"type": "object",
"defaultValue": {
"valueA": 10,
"valueB": "Example Text"
}
},
"testArray": {
"type": "array",
"defaultValue": [
"a",
"b",
"c"
]
},
"testInt": {
"type": "int",
"defaultValue": 5
}
},
"resources": [],
"outputs": {
"objectOutput": {
"type": "string",
"value": "[string(parameters('testObject'))]"
},
"arrayOutput": {
"type": "string",
"value": "[string(parameters('testArray'))]"
},
"intOutput": {
"type": "string",
"value": "[string(parameters('testInt'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| objectOutput | String | {"valueA":10,"valueB":"Example Text"} |
| arrayOutput | String | ["a","b","c"] |
| intOutput | String | 5 |
Subtekenreeks
substring(stringToParse, startIndex, length)
Retourneert een subtekenreeks die begint bij de opgegeven tekenpositie en het opgegeven aantal tekens bevat.
Gebruik in Bicep de substring functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| stringToParse | Ja | tekenreeks | De oorspronkelijke tekenreeks waaruit de subtekenreeks wordt geëxtraheerd. |
| startIndex | Nee | int | De op nul gebaseerde begintekenpositie voor de subtekenreeks. |
| length | Nee | int | Het aantal tekens voor de subtekenreeks. Moet verwijzen naar een locatie in de tekenreeks. Moet nul of groter zijn. Als u dit weglaat, wordt de rest van de tekenreeks vanaf de beginpositie geretourneerd. |
Retourwaarde
De subtekenreeks. Of een lege tekenreeks als de lengte nul is.
Opmerkingen
De functie mislukt wanneer de subtekenreeks zich buiten het einde van de tekenreeks bevindt of wanneer de lengte kleiner is dan nul. Het volgende voorbeeld mislukt met de fout: 'De parameters index en lengte moeten verwijzen naar een locatie in de tekenreeks. De indexparameter: '0', de lengteparameter: '11', de lengte van de tekenreeksparameter: '10'.
"parameters": {
"inputString": {
"type": "string",
"value": "1234567890"
}
}, "variables": {
"prefix": "[substring(parameters('inputString'), 0, 11)]"
}
Voorbeelden
In het volgende voorbeeld wordt een subtekenreeks uit een parameter geëxtraheerd:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"testString": {
"type": "string",
"defaultValue": "one two three"
}
},
"resources": [],
"outputs": {
"substringOutput": {
"type": "string",
"value": "[substring(parameters('testString'), 4, 3)]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| subtekenreeksOutput | String | twee |
take
take(originalValue, numberToTake)
Hiermee wordt een matrix of tekenreeks geretourneerd. Een matrix heeft het opgegeven aantal elementen vanaf het begin van de matrix. Een tekenreeks heeft het opgegeven aantal tekens vanaf het begin van de tekenreeks.
Gebruik in Bicep de take functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| originalValue | Ja | matrix of tekenreeks | De matrix of tekenreeks waaruit de elementen moeten worden opgehaald. |
| numberToTake | Ja | int | Het aantal elementen of tekens dat moet worden gebruikt. Als deze waarde 0 of minder is, wordt een lege matrix of tekenreeks geretourneerd. Als deze groter is dan de lengte van de opgegeven matrix of tekenreeks, worden alle elementen in de matrix of tekenreeks geretourneerd. |
Retourwaarde
Een matrix of tekenreeks.
Voorbeelden
In het volgende voorbeeld wordt het opgegeven aantal elementen uit de matrix en tekens uit een tekenreeks gebruikt:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"testArray": {
"type": "array",
"defaultValue": [
"one",
"two",
"three"
]
},
"elementsToTake": {
"type": "int",
"defaultValue": 2
},
"testString": {
"type": "string",
"defaultValue": "one two three"
},
"charactersToTake": {
"type": "int",
"defaultValue": 2
}
},
"resources": [],
"outputs": {
"arrayOutput": {
"type": "array",
"value": "[take(parameters('testArray'),parameters('elementsToTake'))]"
},
"stringOutput": {
"type": "string",
"value": "[take(parameters('testString'),parameters('charactersToTake'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| arrayOutput | Matrix | ["één", "twee"] |
| stringOutput | String | op |
toLower
toLower(stringToChange)
Converteert de opgegeven tekenreeks naar kleine letters.
Gebruik in Bicep de toLower functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| stringToChange | Ja | tekenreeks | De waarde die moet worden geconverteerd naar kleine letters. |
Retourwaarde
De tekenreeks is geconverteerd naar kleine letters.
Voorbeelden
In het volgende voorbeeld wordt een parameterwaarde geconverteerd naar kleine letters en hoofdletters:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"testString": {
"type": "string",
"defaultValue": "One Two Three"
}
},
"resources": [],
"outputs": {
"toLowerOutput": {
"type": "string",
"value": "[toLower(parameters('testString'))]"
},
"toUpperOutput": {
"type": "string",
"value": "[toUpper(parameters('testString'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| toLowerOutput | String | Een twee drie |
| toUpperOutput | String | EEN TWEE DRIE |
toUpper
toUpper(stringToChange)
Converteert de opgegeven tekenreeks naar hoofdletters.
Gebruik in Bicep de toUpper functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| stringToChange | Ja | tekenreeks | De waarde die moet worden geconverteerd naar hoofdletters. |
Retourwaarde
De tekenreeks is geconverteerd naar hoofdletters.
Voorbeelden
In het volgende voorbeeld wordt een parameterwaarde geconverteerd naar kleine letters en hoofdletters:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"testString": {
"type": "string",
"defaultValue": "One Two Three"
}
},
"resources": [],
"outputs": {
"toLowerOutput": {
"type": "string",
"value": "[toLower(parameters('testString'))]"
},
"toUpperOutput": {
"type": "string",
"value": "[toUpper(parameters('testString'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| toLowerOutput | String | Een twee drie |
| toUpperOutput | String | EEN TWEE DRIE |
trim
trim(stringToTrim)
Hiermee verwijdert u alle voorloop- en volgspaties uit de opgegeven tekenreeks.
Gebruik in Bicep de trim functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| stringToTrim | Ja | tekenreeks | De waarde die u wilt bijsnijden. |
Retourwaarde
De tekenreeks zonder voorloop- en volgspaties.
Voorbeelden
In het volgende voorbeeld worden spatietekens uit de parameter verwijderd:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"testString": {
"type": "string",
"defaultValue": " one two three "
}
},
"resources": [],
"outputs": {
"return": {
"type": "string",
"value": "[trim(parameters('testString'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| enter | String | Een twee drie |
uniqueString
uniqueString(baseString, ...)
Hiermee maakt u een deterministische hashtekenreeks op basis van de waarden die zijn opgegeven als parameters.
Gebruik in Bicep de uniqueString functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| baseString | Ja | tekenreeks | De waarde die wordt gebruikt in de hash-functie om een unieke tekenreeks te maken. |
| meer parameters indien nodig | Nee | tekenreeks | U kunt zoveel tekenreeksen toevoegen als nodig is om de waarde te maken die het uniekheidsniveau aangeeft. |
Opmerkingen
Deze functie is handig wanneer u een unieke naam voor een resource moet maken. U geeft parameterwaarden op waarmee het bereik van uniekheid voor het resultaat wordt beperkt. U kunt opgeven of de naam uniek is voor abonnement, resourcegroep of implementatie.
De geretourneerde waarde is geen willekeurige tekenreeks, maar eerder het resultaat van een hash-functie. De geretourneerde waarde is 13 tekens lang. Het is niet wereldwijd uniek. Mogelijk wilt u de waarde combineren met een voorvoegsel van uw naamconventie om een betekenisvolle naam te maken. In het volgende voorbeeld ziet u de indeling van de geretourneerde waarde. De werkelijke waarde verschilt per opgegeven parameters.
tcvhiyu5h2o5o
In de volgende voorbeelden ziet u hoe uniqueString u een unieke waarde maakt voor veelgebruikte niveaus:
Uniek bereik voor abonnement
"[uniqueString(subscription().subscriptionId)]"
Uniek bereik voor resourcegroep
"[uniqueString(resourceGroup().id)]"
Uniek bereik voor implementatie voor een resourcegroep
"[uniqueString(resourceGroup().id, deployment().name)]"
In het volgende voorbeeld ziet u hoe u een unieke naam maakt voor een opslagaccount op basis van uw resourcegroep. In de resourcegroep is de naam niet uniek als deze op dezelfde manier is samengesteld:
"resources": [{
"name": "[concat('storage', uniqueString(resourceGroup().id))]",
"type": "Microsoft.Storage/storageAccounts",
...
Als u telkens wanneer u een sjabloon implementeert een nieuwe unieke naam moet maken en u niet van plan bent om de resource bij te werken, kunt u de utcNow functie gebruiken met uniqueString. U kunt deze benadering gebruiken in een testomgeving. Zie utcNowvoor een voorbeeld.
Retourwaarde
Een tekenreeks met 13 tekens.
Voorbeelden
Het volgende voorbeeld retourneert resultaten van uniquestring:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [],
"outputs": {
"uniqueRG": {
"type": "string",
"value": "[uniqueString(resourceGroup().id)]"
},
"uniqueDeploy": {
"type": "string",
"value": "[uniqueString(resourceGroup().id, deployment().name)]"
}
}
}
uri
uri(baseUri, relativeUri)
Hiermee maakt u een absolute URI door de baseUri en de relativeUri-tekenreeks te combineren.
Gebruik in Bicep de uri functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| baseUri | Ja | tekenreeks | De basis-URI-tekenreeks. Let op het gedrag van de verwerking van de afsluitende slash (/), zoals beschreven in deze tabel. |
| relativeUri | Ja | tekenreeks | De relatieve URI-tekenreeks die moet worden toegevoegd aan de basis-URI-tekenreeks. |
Als
baseUrihet eindigt met een afsluitende slash, wordt het resultaat gewoonbaseUrigevolgd doorrelativeUri. AlsrelativeUriook begint met een voorloopslash, worden de afsluitende slash en de voorloopslash gecombineerd tot één.Als
baseUridit niet eindigt op een afsluitende slash, gebeurt er een van de twee dingen.Als
baseUrier helemaal geen slashes zijn (afgezien van de//voorzijde) wordtbaseUrihet resultaat gevolgd doorrelativeUri.Als
baseUrier enkele slashes zijn, maar niet eindigt op een slash, wordt alles van de laatste slash verwijderdbaseUrien wordtbaseUrihet resultaat gevolgd doorrelativeUri.
Hieronder volgen een aantal voorbeelden:
uri('http://contoso.org/firstpath', 'myscript.sh') -> http://contoso.org/myscript.sh
uri('http://contoso.org/firstpath/', 'myscript.sh') -> http://contoso.org/firstpath/myscript.sh
uri('http://contoso.org/firstpath/', '/myscript.sh') -> http://contoso.org/firstpath/myscript.sh
uri('http://contoso.org/firstpath/azuredeploy.json', 'myscript.sh') -> http://contoso.org/firstpath/myscript.sh
uri('http://contoso.org/firstpath/azuredeploy.json/', 'myscript.sh') -> http://contoso.org/firstpath/azuredeploy.json/myscript.sh
Voor volledige details worden de baseUri en relativeUri parameters omgezet, zoals opgegeven in RFC 3986, sectie 5.
Retourwaarde
Een tekenreeks die de absolute URI voor de basis- en relatieve waarden vertegenwoordigt.
Voorbeelden
In het volgende voorbeeld ziet u hoe u een koppeling maakt naar een geneste sjabloon op basis van de waarde van de bovenliggende sjabloon:
"templateLink": "[uri(deployment().properties.templateLink.uri, 'nested/azuredeploy.json')]"
In de volgende voorbeeldsjabloon ziet u hoe u deze gebruikt uri, uriComponenten uriComponentToString:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"variables": {
"uriFormat": "[uri('http://contoso.com/resources/', 'nested/azuredeploy.json')]",
"uriEncoded": "[uriComponent(variables('uriFormat'))]"
},
"resources": [
],
"outputs": {
"uriOutput": {
"type": "string",
"value": "[variables('uriFormat')]"
},
"componentOutput": {
"type": "string",
"value": "[variables('uriEncoded')]"
},
"toStringOutput": {
"type": "string",
"value": "[uriComponentToString(variables('uriEncoded'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| uriOutput | String | http://contoso.com/resources/nested/azuredeploy.json |
| componentOutput | String | http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json |
| toStringOutput | String | http://contoso.com/resources/nested/azuredeploy.json |
uriComponent
uricomponent(stringToEncode)
Codeert een URI.
Gebruik in Bicep de uriComponent functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| stringToEncode | Ja | tekenreeks | De waarde die moet worden gecodeerd. |
Retourwaarde
Een tekenreeks van de gecodeerde URI-waarde.
Voorbeelden
In de volgende voorbeeldsjabloon ziet u hoe u deze gebruikt uri, uriComponenten uriComponentToString:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"variables": {
"uriFormat": "[uri('http://contoso.com/resources/', 'nested/azuredeploy.json')]",
"uriEncoded": "[uriComponent(variables('uriFormat'))]"
},
"resources": [
],
"outputs": {
"uriOutput": {
"type": "string",
"value": "[variables('uriFormat')]"
},
"componentOutput": {
"type": "string",
"value": "[variables('uriEncoded')]"
},
"toStringOutput": {
"type": "string",
"value": "[uriComponentToString(variables('uriEncoded'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| uriOutput | String | http://contoso.com/resources/nested/azuredeploy.json |
| componentOutput | String | http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json |
| toStringOutput | String | http://contoso.com/resources/nested/azuredeploy.json |
uriComponentToString
uriComponentToString(uriEncodedString)
Retourneert een tekenreeks van een URI-gecodeerde waarde.
Gebruik in Bicep de uriComponentToString functie.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| uriEncodedString | Ja | tekenreeks | De gecodeerde URI-waarde die moet worden geconverteerd naar een tekenreeks. |
Retourwaarde
Een gedecodeerde tekenreeks met URI-gecodeerde waarde.
Voorbeelden
In het volgende voorbeeld ziet u hoe uriu , uriComponenten uriComponentToString:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"variables": {
"uriFormat": "[uri('http://contoso.com/resources/', 'nested/azuredeploy.json')]",
"uriEncoded": "[uriComponent(variables('uriFormat'))]"
},
"resources": [
],
"outputs": {
"uriOutput": {
"type": "string",
"value": "[variables('uriFormat')]"
},
"componentOutput": {
"type": "string",
"value": "[variables('uriEncoded')]"
},
"toStringOutput": {
"type": "string",
"value": "[uriComponentToString(variables('uriEncoded'))]"
}
}
}
De uitvoer van standaardwaarden uit het vorige voorbeeld is:
| Name | Type | Weergegeven als |
|---|---|---|
| uriOutput | String | http://contoso.com/resources/nested/azuredeploy.json |
| componentOutput | String | http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json |
| toStringOutput | String | http://contoso.com/resources/nested/azuredeploy.json |
Volgende stappen
- Zie De structuur en syntaxis van ARM-sjablonen begrijpen voor een beschrijving van de secties in een ARM-sjabloon.
- Zie Gekoppelde en geneste sjablonen gebruiken bij het implementeren van Azure-resources als u meerdere sjablonen wilt samenvoegen.
- Als u een bepaald aantal keren wilt herhalen wanneer u een type resource maakt, raadpleegt u resource-iteratie in ARM-sjablonen.
- Zie Resources implementeren met ARM-sjablonen en Azure PowerShell om te zien hoe u de sjabloon implementeert die u hebt gemaakt.