Parameterbestandsfunctie voor Bicep
Bicep biedt een functie readEnvironmentVariable() waarmee u waarden kunt ophalen uit omgevingsvariabelen. Het biedt ook de flexibiliteit om een standaardwaarde in te stellen als de omgevingsvariabele niet bestaat. Deze functie kan alleen worden gebruikt in de .bicepparam bestanden. Zie het bicep-parametersbestand voor meer informatie.
getSecret
getSecret(subscriptionId, resourceGroupName, keyVaultName, secretName, secretVersion)
Retourneert een geheim uit een Azure Key Vault. Gebruik deze functie om een geheim door te geven aan een beveiligde tekenreeksparameter van een Bicep-bestand.
Notitie
U kunt ook de functie keyVaultName.getSecret(secretName) vanuit een .bicep bestand gebruiken.
using './main.bicep'
param secureUserName = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretUserName')
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword')
Er wordt een fout weergegeven als u deze functie gebruikt met tekenreeksinterpolatie.
Een naamruimtescheidingsteken (az) kan worden gebruikt, maar dit is optioneel, omdat de functie beschikbaar is vanuit de standaard Azure-naamruimte.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| subscriptionId | Ja | tekenreeks | De id van het abonnement met de sleutelkluisresource. |
| resourceGroupName | Ja | tekenreeks | De naam van de resourcegroep met de sleutelkluisresource. |
| keyVaultName | Ja | tekenreeks | De naam van de sleutelkluis. |
| secretName | Ja | tekenreeks | De naam van het geheim dat is opgeslagen in de sleutelkluis. |
| secretVersion | Nee | tekenreeks | De versie van het geheim dat is opgeslagen in de sleutelkluis. |
Retourwaarde
De waarde voor het geheim.
Opmerking
Het volgende .bicepparam bestand heeft een securePassword parameter met de meest recente waarde van het <secretName-geheim> .
using './main.bicep'
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword')
Het volgende .bicepparam bestand heeft een securePassword parameter met de waarde van het< secretName-geheim>, maar is vastgemaakt aan een specifieke< secretValue.>
using './main.bicep'
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword', 'exampleSecretVersion')
readEnvironmentVariable
readEnvironmentVariable(variableName, [defaultValue])
Retourneert de waarde van de omgevingsvariabele of stel een standaardwaarde in als de omgevingsvariabele niet bestaat. Het laden van variabelen vindt plaats tijdens de compilatie, niet tijdens runtime.
Naamruimte: sys.
Parameters
| Parameter | Vereist | Type | Description |
|---|---|---|---|
| variableName | Ja | tekenreeks | De naam van de variabele. |
| standaardwaarde | Nee | tekenreeks | Een standaardtekenreekswaarde die moet worden gebruikt als de omgevingsvariabele niet bestaat. |
Retourwaarde
De tekenreekswaarde van de omgevingsvariabele of een standaardwaarde.
Voorbeelden
In de volgende voorbeelden ziet u hoe u de waarden van omgevingsvariabelen ophaalt.
use './main.bicep'
param adminPassword = readEnvironmentVariable('admin_password')
param boolfromEnvironmentVariables = bool(readEnvironmentVariable('boolVariableName','false'))
Volgende stappen
Zie Het parameterbestand voor meer informatie over het bicep-parametersbestand.