Freigeben über

Lernprogramm: Hinzufügen von Vorlagenfunktionen zu Ihrer Azure Resource Manager-Vorlage

In diesem Lernprogramm erfahren Sie, wie Sie Ihrer Azure Resource Manager-Vorlage (ARM-Vorlage) Vorlagenfunktionen hinzufügen. Sie verwenden Funktionen, um Werte dynamisch zu konstruieren. Zusätzlich zu diesen vom System bereitgestellten Vorlagenfunktionen können Sie auch benutzerdefinierte Funktionen erstellen. Dieses Tutorial dauert 7 Minuten.

Voraussetzungen

Es wird empfohlen, das Lernprogramm zu Parametern abzuschließen, aber es ist nicht erforderlich.

Sie benötigen Visual Studio Code und Azure PowerShell oder die Azure CLI. Weitere Informationen finden Sie unter Vorlagentools.

Vorlage überprüfen

Am Ende des vorherigen Lernprogramms hatte Ihre Vorlage die folgende JSON-Datei:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageName": {
      "type": "string",
      "minLength": 3,
      "maxLength": 24
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[parameters('storageName')]",
      "location": "eastus",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Angenommen, Sie haben den Standort des Azure Storage-Kontos mit eastus (USA, Osten) hartcodiert, müssen es jedoch in einer anderen Region bereitstellen. Sie müssen einen Parameter hinzufügen, um Ihrer Vorlage Flexibilität hinzuzufügen und es zu ermöglichen, einen anderen Speicherort zu haben.

Funktion verwenden

Wenn Sie das Lernprogramm für Parameter abgeschlossen haben, haben Sie eine Funktion verwendet. Wenn Sie hinzugefügt "[parameters('storageName')]"haben, haben Sie die Parameterfunktion verwendet. Die Klammern geben an, dass die Syntax in den Klammern ein Vorlagenausdruck ist. Der Ressourcen-Manager löst die Syntax auf, anstatt sie als Literalwert zu behandeln.

Funktionen fügen Ihrer Vorlage Flexibilität hinzu, indem Werte während der Bereitstellung dynamisch abgerufen werden. In diesem Lernprogramm verwenden Sie eine Funktion, um den Bereitstellungsort der Ressourcengruppe abzurufen.

Im folgenden Beispiel werden die Änderungen zum Hinzufügen eines Parameters mit dem Namen hervorgehoben location. Der Standardwert des Parameters ruft die resourceGroup-Funktion auf. Diese Funktion gibt ein Objekt mit Informationen zur bereitgestellten Ressourcengruppe zurück. Eine der Objekteigenschaften ist eine Standort-Eigenschaft. Wenn Sie den Standardwert verwenden, haben das Speicherkonto und die Ressourcengruppe denselben Speicherort. Die Ressourcen innerhalb einer Gruppe weisen unterschiedliche Speicherorte auf.

Kopieren Sie die gesamte Datei, und ersetzen Sie die Vorlage durch den Inhalt:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageName": {
      "type": "string",
      "minLength": 3,
      "maxLength": 24
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[parameters('storageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Bereitstellen der Vorlage

In den vorherigen Lernprogrammen haben Sie ein Speicherkonto im Osten der USA erstellt, aber Ihre Ressourcengruppe wurde im Zentrum der USA erstellt. In diesem Lernprogramm erstellen Sie ein Speicherkonto in derselben Region wie die Ressourcengruppe. Verwenden Sie den Standardwert für den Speicherort, sodass Sie diesen Parameterwert nicht angeben müssen. Sie müssen einen neuen Namen für das Speicherkonto angeben, da Sie ein Speicherkonto an einem anderen Speicherort erstellen. Verwenden Sie "store2" z. B. als Präfix anstelle von "store1".

Wenn Sie die Ressourcengruppe nicht erstellt haben, lesen Sie " Erstellen einer Ressourcengruppe". Im Beispiel wird davon ausgegangen, dass Sie die templateFile Variable auf den Pfad zur Vorlagendatei festgelegt haben, wie im ersten Tutorial gezeigt.

New-AzResourceGroupDeployment `
  -Name addlocationparameter `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storageName "{new-unique-name}"

Hinweis

Wenn die Bereitstellung fehlschlägt, verwenden Sie den verbose Switch, um Informationen zu den zu erstellenden Ressourcen abzurufen. Verwenden Sie die debug Option, um weitere Informationen zum Debuggen zu erhalten.

Überprüfen der Bereitstellung

Sie können die Bereitstellung überprüfen, indem Sie die Ressourcengruppe aus dem Azure-Portal erkunden.

  1. Melden Sie sich beim Azure-Portal an.
  2. Wählen Sie im linken Menü "Ressourcengruppen" aus.
  3. Aktivieren Sie das Kontrollkästchen links neben "myResourceGroup ", und wählen Sie "myResourceGroup" aus.
  4. Wählen Sie die von Ihnen erstellte Ressourcengruppe aus. Der Standardname ist myResourceGroup.
  5. Beachten Sie, dass Ihr bereitgestelltes Speicherkonto und Ihre Ressourcengruppe denselben Speicherort haben.

Bereinigen von Ressourcen

Wenn Sie zum nächsten Lernprogramm wechseln, müssen Sie die Ressourcengruppe nicht löschen.

Wenn Sie den Vorgang jetzt beenden, möchten Sie vielleicht die Ressourcengruppe löschen.

  1. Wählen Sie im Azure-Portal im linken Menü Ressourcengruppen aus.
  2. Geben Sie den Ressourcengruppennamen im Filter für alle Felder... Textfeld ein.
  3. Aktivieren Sie das Kontrollkästchen neben "myResourceGroup ", und wählen Sie "myResourceGroup" oder ihren Ressourcengruppennamen aus.
  4. Wählen Sie Ressourcengruppe löschen aus dem Menü ganz oben aus.

Nächste Schritte

In diesem Lernprogramm verwenden Sie eine Funktion, um den Standardwert für einen Parameter zu definieren. In dieser Tutorial-Serie verwenden Sie weiterhin Funktionen. Am Ende der Reihe fügen Sie jedem Vorlagenabschnitt Funktionen hinzu.

Hinzufügen von Variablen

  • Last updated on