Dies ist das neue *CloudFormation Template Reference Guide*. Bitte aktualisieren Sie Ihre Lesezeichen und Links. Hilfe zu den ersten CloudFormation Schritten finden Sie im [AWS CloudFormation Benutzerhandbuch](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# `Fn::Transform`
<a name="intrinsic-function-reference-transform"></a>

Die intrinsische Funktion `Fn::Transform` spezifiziert ein Makro, um eine benutzerdefinierte Verarbeitung auf einem Teil einer Stack-Vorlage durchzuführen. Makros ermöglichen Ihnen die benutzerdefinierte Verarbeitung von Vorlagen, von einfachen Aktionen wie find-and-replace Operationen bis hin zu umfangreichen Transformationen ganzer Vorlagen. *Weitere Informationen finden Sie im [Benutzerhandbuch unter Verwenden von CloudFormation Makros zur benutzerdefinierten Verarbeitung von Vorlagen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html).AWS CloudFormation *

Sie können es auch verwenden`Fn::Transform`, um die [`AWS::Include`-Transformation](transform-aws-include.md) Transformation aufzurufen. Dabei handelt es sich um ein Makro, das von CloudFormation bereitgestellt wird.

## Deklaration
<a name="intrinsic-function-reference-transform-declaration"></a>

### JSON
<a name="intrinsic-function-reference-transform-syntax.json"></a>

Syntax für den vollständigen Funktionsnamen:

```
{
    "Fn::Transform": {
        "Name": "macro name",
        "Parameters": {
            "Key": "value"
        }
    }
}
```

Syntax für die Kurzform:

```
{
    "Transform": {
        "Name": "macro name",
        "Parameters": {
            "Key": "value"
        }
    }
}
```

### YAML
<a name="intrinsic-function-reference-transform-syntax.yaml"></a>

Syntax für den vollständigen Funktionsnamen:

```
Fn::Transform:
  Name : macro name
  Parameters :
    Key : value
```

Syntax für die Kurzform:

```
!Transform
  Name: macro name
  Parameters:
    Key: value
```

## Parameters
<a name="intrinsic-function-reference-transform-parameters"></a>

`Name`  
Der Name des Makros, das Sie für die Verarbeitung verwenden möchten.

`Parameters`  
Die Listenparameter, die als Schlüssel-Wert-Paare angegeben sind, werden an das Makro übergeben.

## Rückgabewert
<a name="intrinsic-function-reference-transform-returnvalue"></a>

Der bearbeitete Vorlagenausschnitt, der in die bearbeitete Stack-Vorlage aufgenommen werden soll.

## Beispiele
<a name="intrinsic-function-reference-transform-examples"></a>

Das folgende Beispiel ruft die `AWS::Include`-Transformation auf und gibt an, dass im Parameter `InputValue` der Ort übergeben wird, an dem ein Vorlagenausschnitt abgerufen werden soll.

### JSON
<a name="intrinsic-function-reference-transform-example-1.json"></a>

```
{
    "Fn::Transform": {
        "Name": "AWS::Include",
        "Parameters": {
            "Location": {
                "Ref": "InputValue"
            }
        }
    }
}
```

### YAML
<a name="intrinsic-function-reference-transform-example-1.yaml"></a>

```
Fn::Transform:
  Name: AWS::Include
  Parameters:
    Location: !Ref InputValue
```

## Unterstützte Funktionen
<a name="intrinsic-function-reference-transform-supported-functions"></a>

Keine.

CloudFormation übergibt alle systeminternen Funktionsaufrufen, die im angegebenen Makro enthalten sind`Fn::Transform`, als Literalzeichenfolgen.