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.

Opmerkingen

Met de volgende opdracht wordt de omgevingsvariabele alleen ingesteld voor het PowerShell-proces waarin deze wordt uitgevoerd. U krijgt BCP338 van Visual Studio Code.

$env:testEnvironmentVariable = "Hello World!"

Gebruik de volgende opdracht om de omgevingsvariabele op gebruikersniveau in te stellen:

[System.Environment]::SetEnvironmentVariable('testEnvironmentVariable','Hello World!', 'User')

Gebruik de volgende opdracht om de omgevingsvariabele op machineniveau in te stellen:

[System.Environment]::SetEnvironmentVariable('testEnvironmentVariable','Hello World!', 'Machine')

Zie De methode Environment.SetEnvironmentVariable voor meer informatie.

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.