Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.

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.

# Verwendung von `AddRoleToInstanceProfile` mit einer CLI
<a name="iam_example_iam_AddRoleToInstanceProfile_section"></a>

Die folgenden Code-Beispiele zeigen, wie `AddRoleToInstanceProfile` verwendet wird.

------
#### [ CLI ]

**AWS CLI**  
**So fügen Sie eine Rolle zu einem Instance-Profil hinzu**  
Mit dem folgenden `add-role-to-instance-profile`-Befehl wird die Rolle mit dem Namen `S3Access` zum Instance-Profil mit dem Namen `Webserver` hinzugefügt.  

```
aws iam add-role-to-instance-profile \
    --role-name S3Access \
    --instance-profile-name Webserver
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.  
Verwenden Sie den `create-instance-profile`-Befehl, um ein Instance-Profil zu erstellen.  
Weitere Informationen finden Sie unter [Verwenden einer IAM-Rolle zum Erteilen von Berechtigungen für Anwendungen, die auf Amazon-EC2-Instances ausgeführt werden](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html) im *AWS IAM-Benutzerhandbuch*.  
+  Einzelheiten zur API finden Sie [AddRoleToInstanceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/add-role-to-instance-profile.html)in der *AWS CLI Befehlsreferenz*. 

------
#### [ PowerShell ]

**Tools für PowerShell V4**  
**Beispiel 1: Mit diesem Befehl wird die Rolle mit dem Namen `S3Access` einem vorhandenen Instance-Profil mit dem Namen `webserver` hinzugefügt. Verwenden Sie den `New-IAMInstanceProfile`-Befehl, um das Instance-Profil zu erstellen. Nachdem Sie das Instance-Profil erstellt und es mithilfe dieses Befehls einer Rolle zugeordnet haben, können Sie es an eine EC2 Instance anfügen. Verwenden Sie dazu das `New-EC2Instance` Cmdlet mit dem Parameter `InstanceProfile_Arn` oder `InstanceProfile-Name`, um die neue Instance zu starten.**  

```
Add-IAMRoleToInstanceProfile -RoleName "S3Access" -InstanceProfileName "webserver"
```
+  Einzelheiten zur API finden Sie unter [AddRoleToInstanceProfile AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).* 

**Tools für V5 PowerShell **  
**Beispiel 1: Mit diesem Befehl wird die Rolle mit dem Namen `S3Access` einem vorhandenen Instance-Profil mit dem Namen `webserver` hinzugefügt. Verwenden Sie den `New-IAMInstanceProfile`-Befehl, um das Instance-Profil zu erstellen. Nachdem Sie das Instance-Profil erstellt und es mithilfe dieses Befehls einer Rolle zugeordnet haben, können Sie es an eine EC2 Instance anfügen. Verwenden Sie dazu das `New-EC2Instance` Cmdlet mit dem Parameter `InstanceProfile_Arn` oder `InstanceProfile-Name`, um die neue Instance zu starten.**  

```
Add-IAMRoleToInstanceProfile -RoleName "S3Access" -InstanceProfileName "webserver"
```
+  Einzelheiten zur API finden Sie unter [AddRoleToInstanceProfile AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5). 

------