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::ForEach`
<a name="intrinsic-function-reference-foreach"></a>

Die intrinsische Funktion `Fn::ForEach` nimmt eine Sammlung und ein Fragment und wendet die Elemente in der Sammlung auf den Bezeichner im angegebenen Fragment an. `Fn::ForEach` kann andere intrinsische Funktionen enthalten, einschließlich `Fn::ForEach` selbst, und innerhalb der Abschnitte,`Conditions` `Outputs`und `Resources` (einschließlich der Ressourceneigenschaften) verwendet werden. Es kann in keinem der folgenden Abschnitte verwendet werden:,`AWSTemplateFormatVersion`,`Description`,`Metadata`,`Transform`,`Parameters`,`Mappings` `Rules`oder `Hooks` Abschnitte.

Wenn Sie die intrinsische Funktion `Fn::ForEach` in Ihrer Vorlage verwenden, müssen Sie auch die Funktion [`AWS::LanguageExtensions`-Transformation](transform-aws-languageextensions.md) verwenden.

Die Verwendung der intrinsischen Funktion `Fn::ForEach` hat keine Auswirkungen auf die geltenden Kontingente für die resultierende Vorlage. Kontingente beinhalten die maximale Größe einer Vorlage und die maximale Anzahl von Ressourcen in einer Vorlage. Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* unter [CloudFormation Grundlegendes zu Kontingenten](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-limits.html).

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

### JSON
<a name="intrinsic-function-reference-foreach-declaration.json"></a>

```
"Fn::ForEach::LoopLogicalName": [
  "Identifier",
  ["Value1","Value2"], // Collection
  {"OutputKey": {OutputValue}}
]
```

### YAML
<a name="intrinsic-function-reference-foreach-declaration.yaml"></a>

```
'Fn::ForEach::LoopLogicalName':
    - Identifier
    - - Value1 # Collection
      - Value2
    - 'OutputKey':
        OutputValue
```

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

*Logischer Name der Schleife*  
Eine logische ID für die Schleife. Der Name muss innerhalb der Vorlage eindeutig sein und darf nicht mit den logischen ID-Werten im Abschnitt `Resources` der Vorlage kollidieren. Dieser Name ist nicht in der transformierten Ausgabe enthalten. Es wird als interne Referenz in der CloudFormation Vorlage selbst verwendet.

*Kennung*  
Ein Bezeichner für den Platzhalter, der in den Parametern `OutputKey` und `OutputValue` ersetzt wird. Alle Instances von `${Identifier}` oder `&{Identifier}` in den Parametern `OutputKey` und `OutputValue` werden durch die Werte des Parameters `Collection` ersetzt.

*Sammlung*  
Die Sammlung von Werten, über die iteriert werden soll. Dies kann ein Array in diesem Parameter sein oder ein [`Ref`](intrinsic-function-reference-ref.md) zu einem `CommaDelimitedList`. Wenn Sie `&{Identifier}`verwenden, können Sie in `Collection`auch nicht-alphanumerische Zeichen eingeben.

*Ausgabe-Taste*  
Der Schlüssel in der transformierten Vorlage. `${Identifier}` oder `&{Identifier}` muss im Parameter `OutputKey` enthalten sein. Wenn zum Beispiel `Fn::ForEach` im Abschnitt `Resources` der Vorlage verwendet wird, ist dies die logische ID jeder Ressource.  
Die `&{}`-Syntax erlaubt die Verwendung von nicht-alphanumerischen Zeichen im `Collection`-Parameter für den `OutputKey`-Parameter. Ein Beispiel hierfür finden Sie unter [Übergabe von nicht-alphanumerischen Zeichen innerhalb der `Collection` für `Fn::ForEach`](intrinsic-function-reference-foreach-example-resource.md#intrinsic-function-reference-foreach-example-non-alphanumeric).

*Ausgabewert*  
Der Wert, der in der transformierten Vorlage für jedes Element im Parameter `Collection` repliziert wird. Wenn zum Beispiel `Fn::ForEach` im Abschnitt `Resources` der Vorlage verwendet wird, ist dies das Vorlagenfragment, das zur Konfiguration jeder Ressource wiederholt wird.

## Rückgabewert
<a name="intrinsic-function-reference-foreach-return-value"></a>

Ein erweitertes Objekt, das das Objektfragment enthält, das für jedes Element in der Sammlung einmal wiederholt wird, wobei die Kennung im Fragment durch das Element aus der Sammlung ersetzt wird.

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

Sie können die folgenden Funktionen in `Fn::ForEach` verwenden.
+ Bedingungsfunktionen:
  + [`Fn::And`](intrinsic-function-reference-conditions.md#intrinsic-function-reference-conditions-and)
  + [`Fn::Equals`](intrinsic-function-reference-conditions.md#intrinsic-function-reference-conditions-equals)
  + [`Fn::If`](intrinsic-function-reference-conditions.md#intrinsic-function-reference-conditions-if)
  + [`Fn::Not`](intrinsic-function-reference-conditions.md#intrinsic-function-reference-conditions-not)
  + [`Fn::Or`](intrinsic-function-reference-conditions.md#intrinsic-function-reference-conditions-or)
+ [`Fn::Base64`](intrinsic-function-reference-base64.md)
+ [`Fn::FindInMap`](intrinsic-function-reference-findinmap.md)
+ [`Fn::GetAtt`](intrinsic-function-reference-getatt.md)
+ [`Fn::GetAZs`](intrinsic-function-reference-getavailabilityzones.md)
+ [`Fn::ImportValue`](intrinsic-function-reference-importvalue.md)
+ [`Fn::Join`](intrinsic-function-reference-join.md)
+ [`Fn::Length`](intrinsic-function-reference-length.md)
+ [`Fn::Transform`](intrinsic-function-reference-transform.md)
+ [`Fn::Select`](intrinsic-function-reference-select.md)
+ [`Fn::Sub`](intrinsic-function-reference-sub.md)
+ [`Fn::ToJsonString`](intrinsic-function-reference-ToJsonString.md)
+ [`Ref`](intrinsic-function-reference-ref.md)

## Beispiele
<a name="intrinsic-function-reference-foreach-example-pointer"></a>

Beispiele für die Abschnitte,`Conditions` `Outputs`und `Resources` finden Sie in [Beispiele](intrinsic-function-reference-foreach-examples.md).