ARM-Vorlagenfunktionen

In diesem Artikel werden alle Funktionen beschrieben, die Sie in einer ARM-Vorlage (Azure Resource Manager) verwenden können. Informationen zur Verwendung von Funktionen in Ihrer Vorlage finden Sie unter Vorlagensyntax.

Informationen zum Erstellen Ihrer eigenen Funktionen finden Sie unter Benutzerdefinierte Funktionen.

Die meisten Funktionen funktionieren auf die gleiche Weise, wenn sie in einer Ressourcengruppe, einem Abonnement, einer Verwaltungsgruppe oder einem Mandanten bereitgestellt werden. Einige Funktionen können nicht in allen Bereichen verwendet werden. Diese sind in den folgenden Listen aufgeführt.

Tipp

Wir empfehlen Bicep, weil es dieselben Funktionen wie ARM-Vorlagen bietet und die Syntax einfacher zu verwenden ist. Weitere Informationen finden Sie unter Bicep-Funktionen und Bicep-Operatoren.

Beliebige Funktion

Die any-Funktion wird in Bicep zur Unterstützung bei der Lösung von Problemen in Zusammenhang mit Datentypwarnungen bereitgestellt.

Arrayfunktionen

Der Resource Manager stellt die folgenden Funktionen für das Arbeiten mit Arrays bereit:

• array
• concat
• contains
• createArray
• empty
• first
• indexOf
• intersection
• last
• lastIndexOf
• length
• min
• max
• range
• skip
• take
• union

Verwenden Sie für Bicep-Dateien die Array-Funktionen.

CIDR-Funktionen

Die folgenden Funktionen sind für die Arbeit mit CIDR verfügbar. All diese Funktion werden im sys-Namespace definiert.

• parseCidr
• cidrSubnet
• cidrHost

Vergleichsfunktionen

Resource Manager stellt mehrere Funktionen zum Durchführen von Vergleichen in Vorlagen bereit.

• coalesce
• equals
• less
• lessOrEquals
• greater
• greaterOrEquals

Verwenden Sie für Bicep-Dateien den logischen Operator coalesce. Verwenden Sie für Vergleiche die Vergleichsoperatoren.

Datumsfunktionen

Resource Manager stellt die folgenden Funktionen für das Arbeiten mit Datumsangaben bereit.

• dateTimeAdd
• dateTimeFromEpoch
• dateTimeToEpoch
• utcNow

Verwenden Sie für Bicep-Dateien die Datumsfunktionen.

Funktionen für Bereitstellungswerte

Der Ressourcen-Manager stellt die folgenden Funktionen zum Abrufen von Werten aus Vorlagenabschnitten sowie von bereitstellungsbezogenen Werten bereit:

• deployment
• Umgebung
• parameters
• variables

Verwenden Sie für Bicep-Dateien die deployment-Funktionen.

Logische Funktionen

Der Ressourcen-Manager stellt die folgenden Funktionen für das Arbeiten mit logischen Bedingungen bereit:

• and
• bool
• false
• if
• not
• or
• true

Verwenden Sie für Bicep-Dateien die logische Funktion bool. Verwenden Sie für andere logische Werte die logischen Operatoren.

Numerische Funktionen

Der Ressourcen-Manager stellt die folgenden Funktionen für das Arbeiten mit ganzen Zahlen bereit:

• add
• copyIndex
• div
• float
• int
• min
• max
• mod
• mul
• sub

Für Bicep-Dateien, die int, min und max nutzen, verwenden Sie numerische Funktionen. Für weitere numerische Werte verwenden Sie numerische Operatoren.

Objektfunktionen

Der Resource Manager stellt die folgenden Funktionen für das Arbeiten mit Objekten bereit:

• contains
• createObject
• empty
• intersection
• items
• json
• length
• null
• union

Verwenden Sie für Bicep-Dateien die Objektfunktionen.

Ressourcenfunktionen

Der Ressourcen-Manager stellt die folgenden Funktionen zum Abrufen von Ressourcenwerten bereit:

• extensionResourceId
• listAccountSas
• listKeys
• listSecrets
• list*
• pickZones
• providers (veraltet)
• Referenz
• Referenzen
• resourceId: Kann in jedem Bereich verwendet werden, aber die gültigen Parameter ändern sich je nach Bereich.
• subscriptionResourceId
• tenantResourceId

Verwenden Sie für Bicep-Dateien die resource-Funktionen.

Bereichsfunktionen

Der Ressourcen-Manager stellt die folgenden Funktionen zum Abrufen von Werten im Bereitstellungsbereich bereit:

• managementGroup: Kann nur in Bereitstellungen in einer Verwaltungsgruppe verwendet werden.
• resourceGroup: Kann nur in Bereitstellungen in einer Ressourcengruppe verwendet werden.
• subscription: Kann nur in Bereitstellungen in einer Ressourcengruppe oder einem Abonnement verwendet werden.
• tenant – kann für Bereitstellungen in jedem Bereich verwendet werden.

Verwenden Sie für Bicep-Dateien die scope-Funktionen.

Zeichenfolgenfunktionen

Der Ressourcen-Manager stellt die folgenden Funktionen für das Arbeiten mit Zeichenfolgen bereit:

• base64
• base64ToJson
• base64ToString
• concat
• contains
• dataUri
• dataUriToString
• empty
• endsWith
• first
• format
• guid
• indexOf
• join
• last
• lastIndexOf
• length
• newGuid
• padLeft
• replace
• skip
• split
• startsWith
• string
• substring
• take
• toLower
• toUpper
• trim
• uniqueString
• uri
• uriComponent
• uriComponentToString

Verwenden Sie für Bicep-Dateien die string-Funktionen.

Nächste Schritte

• Eine Beschreibung der Abschnitte in einer ARM-Vorlage finden Sie unter Grundlegendes zur Struktur und Syntax von ARM-Vorlagen.
• Weitere Informationen zum Mergen mehrerer Vorlagen finden Sie unter Verwenden von verknüpften und geschachtelten Vorlagen bei der Bereitstellung von Azure-Ressourcen.
• Wenn Sie beim Erstellen eines Ressourcentyps eine angegebene Anzahl von Wiederholungen durchlaufen möchten, finden Sie weitere Informationen unter Ressourceniteration in ARM-Vorlagen.
• Informationen zum Bereitstellen der von Ihnen erstellten Vorlage finden Sie unter Bereitstellen von Ressourcen mit ARM-Vorlagen und Azure PowerShell.