

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.

# Problembehebung AWS CloudShell
<a name="troubleshooting"></a>

Bei der Verwendung AWS CloudShell können Probleme auftreten, z. B. wenn Sie wichtige Aufgaben über die Shell-Befehlszeilenschnittstelle starten CloudShell oder ausführen. In diesem Kapitel wird beschrieben, wie Sie einige der häufigsten Probleme beheben können, auf die Sie möglicherweise stoßen.

Antworten auf eine Vielzahl von Fragen zu CloudShell finden Sie im [AWS CloudShell FAQs](https://aws.amazon.com/cloudshell/faqs/). Sie können auch im [AWS CloudShell Diskussionsforum](https://repost.aws/tags/TA5ZaPf1NkT4uNitnWVitlyQ/aws-cloud-shell) nach Antworten suchen und Fragen stellen. Wenn Sie dieses Forum betreten, müssen Sie sich möglicherweise anmelden AWS. Sie können uns auch direkt [kontaktieren](https://aws.amazon.com/contact-us/).

## Behebung von Fehlern
<a name="troubleshooting-errors"></a>

Wenn Sie auf einen der folgenden indizierten Fehler stoßen, können Sie die folgenden Lösungen verwenden, um diese Fehler zu beheben.

**Topics**
+ [

### Zugriff verweigert
](#unable-to-launch-cloudshell)
+ [

### Unzureichende Berechtigungen
](#no-access-cloudshell)
+ [

### Zugriff auf die AWS CloudShell Befehlszeile nicht möglich
](#locked-out-cloudshell)
+ [

### Externe IP-Adressen konnten nicht gepingt werden
](#ping-cloudshell)
+ [

### Bei der Vorbereitung Ihres Terminals sind einige Probleme aufgetreten
](#old-browser-issue-cloudshell)
+ [

### Die Pfeiltasten funktionieren nicht richtig in PowerShell
](#pwsh-arrow-keys)
+ [

### Nicht unterstützte Web Sockets führen dazu, dass Sitzungen nicht gestartet CloudShell werden können
](#web-sockets-cloudshell)
+ [

### Das `AWSPowerShell.NetCore` Modul konnte nicht importiert werden
](#import-PowerShell-module)
+ [

### Docker läuft nicht bei der Verwendung AWS CloudShell
](#docker-not-running)
+ [

### Docker hat keinen Speicherplatz mehr
](#docker-space-full)
+ [

### `docker push`hat eine Zeitüberschreitung und versucht es immer wieder
](#docker-push-timeout)
+ [

### Von meiner VPC-Umgebung aus kann nicht auf Ressourcen innerhalb der AWS CloudShell VPC zugegriffen werden
](#unable-access-VPC-resources)
+ [

### Die von AWS CloudShell für meine VPC-Umgebung verwendete ENI wurde nicht bereinigt
](#unable-cleanup-VPC-ENI)
+ [

### Benutzer, die nur für VPC-Umgebungen `CreateEnvironment` berechtigt sind, haben auch Zugriff auf öffentliche AWS CloudShell Umgebungen
](#user-has-access-to-publicCloudShellenv)

### Zugriff verweigert
<a name="unable-to-launch-cloudshell"></a>

**Problem:** Wenn Sie versuchen, CloudShell von der aus zu starten AWS-Managementkonsole, erhalten Sie die Meldung "Die Umgebung konnte nicht gestartet werden. Um es erneut zu versuchen, aktualisieren Sie den Browser oder starten Sie ihn neu, indem Sie „Aktionen, Neustart AWS CloudShell“ wählen. Ihnen wird der Zugriff verweigert, auch wenn Sie die Berechtigungen Ihres IAM-Administrators benötigen und Ihren Browser aktualisiert oder neu gestartet haben. CloudShell

**Lösung:** Wenden Sie sich an den [AWS Support](https://aws.amazon.com/contact-us/).

([zurück zum Seitenanfang](#troubleshooting))

### Unzureichende Berechtigungen
<a name="no-access-cloudshell"></a>

**Problem:** Wenn Sie versuchen, CloudShell von der aus zu starten AWS-Managementkonsole, erhalten Sie die Meldung „Die Umgebung konnte nicht gestartet werden. Sie verfügen nicht über die erforderlichen Berechtigungen. Bitten Sie Ihren IAM-Administrator, Zugriff auf AWS CloudShell"zu gewähren. Ihnen wird der Zugriff verweigert und Sie werden darüber informiert, dass Sie nicht über die erforderlichen Berechtigungen verfügen. 

**Ursache:** Der IAM-Identität, die Sie für den Zugriff verwenden, AWS CloudShell fehlen die erforderlichen IAM-Berechtigungen. 

**Lösung: Bitten** Sie Ihren IAM-Administrator, Ihnen die erforderlichen Berechtigungen zu erteilen. Dazu kann er entweder eine angehängte AWS verwaltete Richtlinie (AWSCloudShellFullAccess) oder eine eingebettete Inline-Richtlinie hinzufügen. Weitere Informationen finden Sie unter [AWS CloudShell Zugriff und Nutzung mithilfe von IAM-Richtlinien verwalten](sec-auth-with-identities.md#sec-auth-with-identities.title). 

([zurück zum Seitenanfang](#troubleshooting))

### Zugriff auf die AWS CloudShell Befehlszeile nicht möglich
<a name="locked-out-cloudshell"></a>

 **Problem:** Nachdem Sie eine Datei geändert haben, die von der Rechenumgebung verwendet wird, können Sie nicht auf die Befehlszeile in zugreifen AWS CloudShell.

 **Lösung:** Wenn Sie nach einer falschen Änderung `.bashrc` oder einer anderen Datei den Zugriff verlieren, können Sie AWS CloudShell zu den Standardeinstellungen zurückkehren, indem Sie [Ihr Home-Verzeichnis löschen](getting-started.md#delete-shell-session).

([zurück zum Seitenanfang](#troubleshooting))

### Externe IP-Adressen konnten nicht gepingt werden
<a name="ping-cloudshell"></a>

**Problem:** Wenn Sie einen Ping-Befehl von der Befehlszeile aus ausführen (z. B.`ping amazon.com`), erhalten Sie die folgende Meldung.

```
ping: socket: Operation not permitted
```

**Ursache**: Das Ping-Hilfsprogramm verwendet das Internet Control Message Protocol (ICMP), um Echoanforderungspakete an einen Zielhost zu senden. Es wartet auf die Antwort eines Echos vom Ziel. Da das ICMP-Protokoll in nicht aktiviert ist AWS CloudShell, funktioniert das Ping-Hilfsprogramm nicht in der Rechenumgebung der Shell. 

**Lösung**: Da ICMP in nicht unterstützt wird, können Sie den folgenden Befehl ausführen AWS CloudShell, um Netcat zu installieren. Netcat ist ein Computernetzwerkprogramm zum Lesen von und Schreiben auf Netzwerkverbindungen mithilfe von TCP oder UDP.

```
sudo yum install nc
nc -zv www.amazon.com 443
```

([zurück zum Seitenanfang](#troubleshooting))

### Bei der Vorbereitung Ihres Terminals sind einige Probleme aufgetreten
<a name="old-browser-issue-cloudshell"></a>

**Problem:** Wenn Sie versuchen, AWS CloudShell mit dem Microsoft Edge-Browser darauf zuzugreifen, können Sie keine Shell-Sitzung starten, und der Browser zeigt eine Fehlermeldung an.

**Ursache**: AWS CloudShell ist nicht mit früheren Versionen von Microsoft Edge kompatibel. Sie können AWS CloudShell mit den neuesten vier Hauptversionen der unterstützten Browser darauf zugreifen.

**Lösung:** Installieren Sie eine aktualisierte Version des Edge-Browsers von der [Microsoft-Website](https://www.microsoft.com/en-us/edge).

([zurück zum Seitenanfang](#troubleshooting))

### Die Pfeiltasten funktionieren nicht richtig in PowerShell
<a name="pwsh-arrow-keys"></a>

**Problem:** Im Normalbetrieb können Sie mit den Pfeiltasten in der Befehlszeilenschnittstelle navigieren und Ihren Befehlsverlauf vor- und zurückscannen. Wenn Sie jedoch in bestimmten Versionen von PowerShell on die Pfeiltasten drücken AWS CloudShell, werden Buchstaben möglicherweise falsch ausgegeben.

**Ursache**: Die Situation, dass Pfeiltasten Buchstaben falsch ausgeben, ist ein bekanntes Problem bei PowerShell 7.2.x-Versionen, die unter Linux ausgeführt werden.

**Lösung:** Um Escape-Sequenzen zu entfernen, die das Verhalten der Pfeiltasten verändern, bearbeiten Sie die PowerShell Profildatei und setzen Sie die `$PSStyle` Variable auf. `PlainText`

1. Geben Sie in der AWS CloudShell Befehlszeile den folgenden Befehl ein, um die Profildatei zu öffnen.

   ```
   vim ~/.config/powershell/Microsoft.PowerShell_profile.ps1 
   ```
**Anmerkung**  
Wenn Sie bereits angemeldet sind PowerShell, können Sie die Profildatei auch mit dem folgenden Befehl im Editor öffnen.  

   ```
   vim $PROFILE
   ```

1. Gehen Sie im Editor zum Ende des vorhandenen Texts der Datei, drücken Sie **i**, um in den **Einfügemodus zu wechseln, und fügen** Sie dann die folgende Anweisung hinzu.

   ```
   $PSStyle.OutputRendering = 'PlainText'
   ```

1. Nachdem Sie die Bearbeitung vorgenommen haben, drücken Sie, **Esc** um in den Befehlsmodus zu wechseln. Geben Sie anschließend den folgenden Befehl ein, um die Datei zu speichern und den Editor zu beenden.

   ```
   :wq
   ```

**Anmerkung**  
Ihre Änderungen werden wirksam, wenn Sie das nächste Mal beginnen PowerShell.

([zurück zum Seitenanfang](#troubleshooting))

### Nicht unterstützte Web Sockets führen dazu, dass Sitzungen nicht gestartet CloudShell werden können
<a name="web-sockets-cloudshell"></a>

**Problem:** Wenn Sie versuchen zu starten AWS CloudShell, erhalten Sie wiederholt die folgende Meldung:`Failed to open sessions : Timed out while opening the session`.

**Ursache**: CloudShell hängt vom *WebSocket Protokoll* ab, das eine wechselseitige interaktive Kommunikation zwischen Ihrem Webbrowser und AWS CloudShell ermöglicht. Wenn Sie einen Browser in einem privaten Netzwerk verwenden, wird der sichere Zugriff auf das Internet wahrscheinlich durch Proxyserver und Firewalls erleichtert. WebSocket Die Kommunikation kann normalerweise problemlos über Proxyserver erfolgen. In einigen Fällen verhindern WebSockets Proxyserver jedoch, dass sie ordnungsgemäß funktionieren. Wenn dieses Problem auftritt, CloudShell kann keine Shell-Sitzung gestartet werden, und der Verbindungsversuch läuft irgendwann ab.

**Lösung:** Ein Verbindungstimeout kann durch ein anderes als nicht WebSockets unterstütztes Problem verursacht werden. Wenn dies der Fall ist, aktualisieren Sie zunächst das Browserfenster, in dem sich die CloudShell Befehlszeilenschnittstelle befindet.

Wenn Sie nach der Aktualisierung immer noch Timeout-Fehler erhalten, lesen Sie in der Dokumentation Ihres Proxyservers nach. Stellen Sie außerdem sicher, dass Ihr Proxyserver so konfiguriert ist, dass er Web Sockets zulässt. Wenden Sie sich alternativ an den Systemadministrator Ihres Netzwerks.

**Anmerkung**  
Angenommen, Sie möchten detaillierte Berechtigungen definieren, indem Sie spezifische Genehmigungen auflisten. URLs Sie können einen Teil der URL hinzufügen, über die die AWS Systems Manager Sitzung eine WebSocket Verbindung zum Senden von Eingaben und Empfangen von Ausgaben herstellt. Ihre AWS CloudShell Befehle werden an diese Systems Manager Manager-Sitzung gesendet.  
 Das Format dafür StreamUrl , das von Systems Manager verwendet wird, ist` wss://ssmmessages.region.amazonaws.com/v1/data-channel/session-id?stream=(input|output)`.  
Die **Region** stellt die Regionskennung für eine dar AWS-Region , die von unterstützt wird AWS Systems Manager. Dies `us-east-2` ist beispielsweise die Regionskennung für die Region USA Ost (Ohio).   
Da die **Sitzungs-ID** erstellt wird, *nachdem* eine bestimmte Systems Manager Manager-Sitzung erfolgreich gestartet wurde, können Sie sie nur angeben, `wss://ssmmessages.region.amazonaws.com` wenn Sie Ihre URL-Zulassungsliste aktualisieren. *Weitere Informationen zu diesem [StartSession](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_StartSession.html)Vorgang finden Sie in der AWS Systems Manager API-Referenz.*

([zurück zum Seitenanfang](#troubleshooting))

### Das `AWSPowerShell.NetCore` Modul konnte nicht importiert werden
<a name="import-PowerShell-module"></a>

**Problem:** Wenn Sie die AWSPower Shell importieren. NetCoreIn einem Modul PowerShell von `Import-Module -Name AWSPowerShell.NetCore` erhalten Sie die folgende Fehlermeldung:

Import-Module: Das angegebene Modul 'Shell. AWSPower NetCore' wurde nicht geladen, weil in keinem Modulverzeichnis eine gültige Moduldatei gefunden wurde.

**Ursache:** Das `AWSPowerShell.NetCore` Modul wurde durch die dienstspezifischen AWS.Tools-Module in ersetzt. AWS CloudShell

**Lösung:** Alle expliziten Importanweisungen sind möglicherweise nicht mehr erforderlich oder müssen in das zugehörige .Tools-Modul für jeden Dienst AWS geändert werden.

**Example**  

**Example**  
+ In den meisten Fällen benötigen Sie keine explizite Importanweisung, solange keine.NET-Typen verwendet werden. Im Folgenden finden Sie Beispiele für Import-Anweisungen.
  + `Get-S3Bucket`
  + `(Get-EC2Instance).Instances`
+ Wenn .Net-Typen verwendet werden, importieren Sie das Service-Level-Modul (`AWS.Tools.<Service>`). Es folgt ein Beispiel für die Syntax.

  ```
  Import-Module -Name AWS.Tools.EC2
  $InstanceTag = [Amazon.EC2.Model.Tag]::new("Environment","Dev")
  ```

  ```
  Import-Module -Name AWS.Tools.S3 
  $LifecycleRule = [Amazon.S3.Model.LifecycleRule]::new()
  ```

Weitere Informationen finden Sie in der [Ankündigung von Version 4](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-is-now-generally-available-with-version-4-0/) für. AWS -Tools für PowerShell

([zurück zum Seitenanfang](#troubleshooting))

### Docker läuft nicht bei der Verwendung AWS CloudShell
<a name="docker-not-running"></a>

**Problem:** Docker läuft bei der Verwendung nicht richtig. AWS CloudShell Sie erhalten die folgende Fehlermeldung:`docker: Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?`. 

**Lösung:** Versuchen Sie, Ihre Umgebung neu zu starten. Diese Fehlermeldung kann auftreten, wenn Sie Docker AWS CloudShell in einer GovCloud Region ausführen. Stellen Sie sicher, dass Sie Docker in den unterstützten AWS Regionen ausführen. Eine Liste der Regionen, in denen Docker verfügbar ist, finden Sie unter [Unterstützte AWS Regionen](supported-aws-regions.md) für. AWS CloudShell

### Docker hat keinen Speicherplatz mehr
<a name="docker-space-full"></a>

**Problem:** Sie erhalten die folgende Fehlermeldung:`ERROR: failed to solve: failed to register layer: write [...]: no space left on device`.

**Ursache:** Das Dockerfile überschreitet den verfügbaren Speicherplatz in. AWS CloudShell Dies kann durch große Einzelbilder oder durch zu viele bereits vorhandene Docker-Images verursacht werden.

**Lösung:** Führen Sie `df -h` den Befehl aus, um die Festplattennutzung zu ermitteln. Führen Sie den Befehl aus`sudo du -sh /folder/folder1`, um die Größe bestimmter Ordner zu ermitteln, die Ihrer Meinung nach groß sein könnten, und erwägen Sie, andere Dateien zu löschen, um Speicherplatz freizugeben. Eine Option wäre, in Betracht zu ziehen, ungenutzte Docker-Images durch Ausführen `docker rmi` zu entfernen. [Sie sollten sich bewusst sein, dass Docker nur über begrenzten Speicherplatz in der Umgebung verfügt. Weitere Informationen zu Docker finden Sie im Docker-Dokumentationsleitfaden.](https://docs.docker.com/guides/docker-overview/)

### `docker push`hat eine Zeitüberschreitung und versucht es immer wieder
<a name="docker-push-timeout"></a>

**Problem:** Bei der Ausführung kommt `docker push` es zu einem Timeout und es wird weiterhin erfolglos wiederholt.

**Ursache:** Dies kann auf fehlende Berechtigungen, das Verschieben in das falsche Repository oder auf eine fehlende Authentifizierung zurückzuführen sein.

**Lösung:** Um dieses Problem zu lösen, stellen Sie sicher, dass Sie zum richtigen Repository pushen. Führen Sie `docker login` die Datei aus, um sich ordnungsgemäß zu authentifizieren. Stellen Sie sicher, dass Sie über alle erforderlichen Berechtigungen für das Pushen in ein Amazon ECR-Repository verfügen.

### Von meiner VPC-Umgebung aus kann nicht auf Ressourcen innerhalb der AWS CloudShell VPC zugegriffen werden
<a name="unable-access-VPC-resources"></a>

**Problem:** Während ich meine VPC-Umgebung verwende, kann ich nicht auf Ressourcen innerhalb der AWS CloudShell VPC zugreifen.

**Ursache:** Ihre AWS CloudShell VPC-Umgebung erbt die Netzwerkeinstellungen Ihrer VPC.

**Lösung:** Um dieses Problem zu beheben, stellen Sie sicher, dass Ihre VPC korrekt für den Zugriff auf Ihre Ressourcen eingerichtet ist. Weitere Informationen finden Sie in der VPC-Dokumentation [Connect Sie Ihre VPC mit anderen Netzwerken](https://docs.aws.amazon.com//vpc/latest/userguide/extend-intro.html) und in der Network Access Analyzer-Dokumentation [Network Access](https://docs.aws.amazon.com//vpc/latest/network-access-analyzer/what-is-network-access-analyzer.html) Analyzer. Sie finden die IPv4 Adresse, die die AWS CloudShell VPC-Umgebung verwendet, indem Sie den Befehl in Ihrer **`ip -a`** Umgebung in der Befehlszeile oder auf der VPC-Konsolenseite ausführen. 

### Die von AWS CloudShell für meine VPC-Umgebung verwendete ENI wurde nicht bereinigt
<a name="unable-cleanup-VPC-ENI"></a>

**Problem:** Die ENI, die von AWS CloudShell für meine VPC-Umgebung verwendet wurde, konnte nicht bereinigt werden.

**Ursache:** Die `ec2:DeleteNetworkInterface` Berechtigung ist für Ihre Rolle nicht aktiviert.

**Lösung:** Um dieses Problem zu beheben, stellen Sie sicher, dass die `ec2:DeleteNetworkInterface` Berechtigung für Ihre Rolle aktiviert ist, wie im folgenden Beispielskript gezeigt:

```
{
  "Effect": "Allow",
  "Action": [
    "ec2:DeleteNetworkInterface"
  ],
  "Condition": {
    "StringEquals": {
      "aws:ResourceTag/ManagedByCloudShell": ""
    }
  },
  "Resource": "arn:aws:ec2:*:*:network-interface/*"
}
```

### Benutzer, die nur für VPC-Umgebungen `CreateEnvironment` berechtigt sind, haben auch Zugriff auf öffentliche AWS CloudShell Umgebungen
<a name="user-has-access-to-publicCloudShellenv"></a>

**Problem:** Benutzer, die nur `CreateEnvironment` auf VPC-Umgebungen beschränkt sind, können auch auf öffentliche AWS CloudShell Umgebungen zugreifen.

**Ursache:** Wenn Sie die `CreateEnvironment` Berechtigungen nur für die Erstellung von VPC-Umgebungen einschränken und bereits eine öffentliche Umgebung erstellt haben, behalten Sie Ihren Zugriff auf die vorhandene öffentliche CloudShell Umgebung, bis diese Umgebung über die Webbenutzeroberfläche gelöscht wird. Wenn Sie diese jedoch noch nie CloudShell zuvor verwendet haben, haben Sie keinen Zugriff auf öffentliche Umgebungen. 

**Lösung:** Um den Zugriff auf öffentliche AWS CloudShell Umgebungen einzuschränken, muss der IAM-Administrator zuerst die IAM-Richtlinie mit der Einschränkung aktualisieren. Anschließend muss der Benutzer die vorhandene öffentliche Umgebung manuell über die AWS CloudShell Webbenutzeroberfläche löschen. (**Aktionen** → ** CloudShell Umgebung löschen**).