Bicep-Funktionen für Bicep-Parameterdateien
Bicep bietet eine Funktion namens „readEnvironmentVariable()
“, mit der Sie Werte aus Umgebungsvariablen abrufen können. Es bietet auch die Flexibilität, einen Standardwert festzulegen, wenn die Umgebungsvariable nicht vorhanden ist. Diese Funktion kann nur in .bicepparam
Dateien verwendet werden.
getSecret
getSecret(subscriptionId, resourceGroupName, keyVaultName, secretName, secretVersion)
Diese Funktion gibt einen Geheimschlüssel aus einem Azure Key Vault zurück. Verwenden Sie diese Funktion, um einen geheimen Schlüssel an den sicheren Zeichenfolgenparameter einer Bicep-Datei zu übergeben.
Hinweis
Sie können auch die Funktion keyVaultName.getSecret(secretName) aus einer .bicep
-Datei verwenden.
using './main.bicep'
param secureUserName = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretUserName')
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword')
Sie erhalten einen Fehler, wenn Sie diese Funktion mit Zeichenfolgeninterpolation verwenden.
Ein Namespacequalifizierer (az
) kann verwendet werden, ist aber optional, da die Funktion aus dem Standardmäßigen Azure-Namespace verfügbar ist.
Parameter
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
subscriptionId | Ja | Zeichenfolge | Die ID des Abonnements mit der Schlüsseltresorressource |
resourceGroupName | Ja | Zeichenfolge | Der Name der Ressourcengruppe mit der Schlüsseltresorressource |
keyVaultName | Ja | Zeichenfolge | Der Name des Schlüsseltresors |
secretName | Ja | Zeichenfolge | Der Name des geheimen Schlüssels, der im Schlüsseltresor gespeichert ist |
secretVersion | Nein | Zeichenfolge | Die Version des geheimen Schlüssels, der im Schlüsseltresor gespeichert ist |
Rückgabewert
Der Wert für das Geheimnis.
Beispiel
Die folgende .bicepparam
Datei weist einen securePassword
Parameter auf, der den neuesten Wert des <geheimen Schlüssels "secretName> " aufweist:
using './main.bicep'
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword')
Die folgende .bicepparam
Datei weist einen securePassword
Parameter auf, der den Wert des <geheimen Schlüssels "secretName> " aufweist, aber an einen bestimmten <"secretValue>" angeheftet ist:
using './main.bicep'
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword', 'exampleSecretVersion')
readEnvironmentVariable
readEnvironmentVariable(variableName, [defaultValue])
Diese Funktion gibt den Wert der Umgebungsvariable zurück oder legt einen Standardwert fest, wenn die Umgebungsvariable nicht vorhanden ist. Das laden von Variablen erfolgt während der Kompilierung und nicht zur Laufzeit.
Namespace: sys.
Parameter
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
variableName | Ja | Zeichenfolge | Der Name der Variablen. |
defaultValue | Nein | Zeichenfolge | Ein Standardzeichenfolgenwert, der verwendet werden soll, wenn die Umgebungsvariable nicht vorhanden ist. |
Rückgabewert
Der Rückgabewert ist der Zeichenfolgenwert der Umgebungsvariable oder eines Standardwerts.
Hinweise
Mit dem folgenden Befehl wird die Umgebungsvariable nur für den PowerShell-Prozess festgelegt, in dem sie ausgeführt wird. Sie erhalten BCP338 aus Visual Studio Code:
$env:testEnvironmentVariable = "Hello World!"
Führen Sie den folgenden Befehl aus, um die Umgebungsvariable auf Benutzerebene festzulegen:
[System.Environment]::SetEnvironmentVariable('testEnvironmentVariable','Hello World!', 'User')
Führen Sie den folgenden Befehl aus, um die Umgebungsvariable auf Computerebene festzulegen:
[System.Environment]::SetEnvironmentVariable('testEnvironmentVariable','Hello World!', 'Machine')
Weitere Informationen finden Sie unter Environment.SetEnvironmentVariable-Methode.
Beispiele
Die folgenden Beispiele zeigen, wie die Werte von Umgebungsvariablen abgerufen werden:
use './main.bicep'
param adminPassword = readEnvironmentVariable('admin_password')
param boolfromEnvironmentVariables = bool(readEnvironmentVariable('boolVariableName','false'))
Nächste Schritte
Weitere Informationen zu Bicep-Parameterdateien finden Sie unter Erstellen von Parameterdateien für die Bicep-Bereitstellung.