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.
# Problembehandlung bei AWS Toolkit for Visual Studio
Die folgenden Abschnitte enthalten allgemeine Informationen zur Fehlerbehebung über die AWS Dienste aus dem Toolkit AWS Toolkit for Visual Studio und die Arbeit mit diesen Diensten.
**Anmerkung**
Informationen set-up-specific zur Installation und Problembehandlung finden Sie im Thema [Behebung von Installationsproblemen](https://docs.aws.amazon.com//toolkit-for-visual-studio/latest/user-guide/setup-troubleshoot.html) in diesem Benutzerhandbuch.
**Topics**
+ [Bewährte Methoden zur Fehlerbehebung](#general-troubleshoot-best-practice)
+ [Amazon Q-Sicherheitsscans anzeigen und filtern](#general-troubleshoot-Q-securityscan)
+ [Das AWS Toolkit ist nicht richtig installiert](#general-troubleshoot-component-initilization)
+ [Firewall- und Proxyeinstellungen](#general-troubleshoot-firewall)
## Bewährte Methoden zur Fehlerbehebung
Im Folgenden werden bewährte Methoden zur Behebung von AWS Toolkit for Visual Studio Problemen empfohlen.
+ Reparieren Sie Visual Studio und starten Sie Ihr System neu
+ Versuchen Sie, Ihr Problem oder Ihren Fehler erneut zu erstellen, bevor Sie einen Bericht senden.
+ Machen Sie sich während des Wiederherstellungsvorgangs detaillierte Notizen zu jedem Schritt, jeder Einstellung und jeder Fehlermeldung.
+ Sammeln Sie AWS Toolkit-Protokolle. Eine ausführliche Beschreibung, wie Sie Ihre AWS Toolkit-Logs auffinden können, finden Sie im [Abschnitt So finden Sie Ihre AWS Logs](#general-troubleshoot-procedure-logs) in diesem Handbuch.
+ Suchen Sie im Bereich [AWS Toolkit for Visual Studio Probleme](https://github.com/aws/aws-toolkit-visual-studio/issues) des Repositorys nach offenen Anfragen und bekannten Lösungen oder melden Sie Ihr ungelöstes Problem. AWS Toolkit for Visual Studio GitHub
**Reparieren Sie Visual Studio und starten Sie Ihr System neu**
1. Schließen Sie alle laufenden Instanzen von Visual Studio.
1. Starten Sie **Visual Studio Installer** im Windows-Startmenü.
1. Führen Sie Repair für die betroffenen Installationen von Visual Studio aus. Dadurch kann Visual Studio seinen Index der installierten Erweiterungen neu erstellen.
1. Starten Sie Windows neu, bevor Sie Visual Studio neu starten.
**So finden Sie Ihre AWS Toolkit-Protokolle**
1. Erweitern Sie im Visual-Studio-Hauptmenü die Option **Erweiterungen**.
1. Wählen Sie das **AWS Toolkit** aus, um das AWS Toolkit-Menü zu erweitern, und wählen Sie dann Toolkit-Logs **anzeigen**.
1. Wenn der AWS Toolkit-Protokollordner in Ihrem Betriebssystem geöffnet wird, sortieren Sie die Dateien nach Datum und suchen Sie nach allen Protokolldateien, die Informationen zu Ihrem aktuellen Problem enthalten.
## Amazon Q-Sicherheitsscans anzeigen und filtern
Um Ihre Amazon Q-Sicherheitsscans in Visual Studio anzuzeigen, öffnen Sie die Visual **Studio-Fehlerliste**, indem **Sie die Überschrift Ansicht** im Visual Studio-Hauptmenü erweitern und **Fehlerliste** auswählen.
In der **Fehlerliste** von Visual Studio werden standardmäßig alle Warnungen und Fehler für Ihre Codebasis angezeigt. Um Ihre Amazon Q-Sicherheitsscan-Ergebnisse aus der Visual **Studio-Fehlerliste** zu filtern, erstellen Sie einen Filter, indem Sie das folgende Verfahren ausführen.
**Anmerkung**
Die Ergebnisse des Amazon Q-Sicherheitsscans sind erst sichtbar, nachdem der Sicherheitsscan ausgeführt und Probleme erkannt wurden.
Die Ergebnisse des Amazon Q-Sicherheitsscans werden in Visual Studio als Warnungen angezeigt. Um die Ergebnisse des Amazon Q-Sicherheitsscans aus Ihrer **Fehlerliste** anzuzeigen, muss die Option **Warnungen** in der Überschrift **Fehlerliste** ausgewählt werden.
1. Erweitern Sie im Visual Studio-Hauptmenü die Überschrift **Ansicht** und wählen Sie **Fehlerliste**, um den Bereich **Fehlerliste** zu öffnen.
1. Klicken Sie im Bereich **Fehlerliste** mit der rechten Maustaste auf die Kopfzeile, um das Kontextmenü zu öffnen.
1. Erweitern Sie im Kontextmenü die Option **Spalten anzeigen** und wählen Sie dann im erweiterten Menü die Option **Tool** aus.
1. Die Spalte **Tool** wird Ihrer **Fehlerliste** hinzugefügt.
1. Wählen Sie in der Spaltenüberschrift **Tool** das **Filtersymbol** und dann Amazon Q aus, um nach Ergebnissen von Amazon Q-Sicherheitsscans zu filtern.
## Das AWS Toolkit ist nicht richtig installiert
**Problem:**
Innerhalb einer Minute nach dem Start von Visual Studio werden AWS Toolkit for Visual Studio die folgenden Meldungen im Ausgabebereich bzw. in der Infoleiste angezeigt:
`Some Toolkit components could not be initialized. Some functionality may not work during this IDE session.`
`The AWS Toolkit is not properly installed.`
**Lösung:**
Es ist möglich, dass durch die Aktualisierung oder Installation einer Erweiterung einige der internen Cache-Dateien von Visual Studio verloren gingen out-of-sync. Im folgenden Verfahren wird beschrieben, wie diese Dateien beim nächsten Start von Visual Studio neu erstellt werden.
**Anmerkung**
Es ist möglich, dass sich diese Lösung auf Ihre Visual Studio-Anpassungen auswirkt. Nach Abschluss dieses Verfahrens sollte die AWS Toolkit-Erweiterung als installiert aufgeführt sein und keine Fehlermeldung mehr melden. Falls dieses Problem weiterhin auftritt, nachdem Sie die folgenden Schritte ausgeführt haben, finden Sie weitere Informationen unter [Problem \$1452](https://github.com/aws/aws-toolkit-visual-studio/issues/452) im AWS Toolkit for Visual Studio GitHub Repository.
1. Installieren Sie die neueste Version von Visual Studio 2022.
**Anmerkung**
Die erforderliche Mindestversion ist 17.11.5.
1. Schließen Sie alle laufenden Instanzen von Visual Studio.
1. Öffnen Sie in Windows die **Entwickler-Befehlszeile** als Administrator.
1. Führen Sie in der **Entwickler-Befehlszeile** den folgenden Befehl aus: `devenv /updateconfiguration /resetExtensions` und warten Sie, bis der Befehl abgeschlossen ist.
1. Starten Sie Visual Studio neu, nachdem der Befehl abgeschlossen ist.
1. In Visual Studio wird die AWS Erweiterung jetzt als installiert aufgeführt und die oben in dieser Ausgabe aufgeführten Fehlermeldungen werden nicht mehr gemeldet.
## Firewall- und Proxyeinstellungen
### Fehlerbehebung bei den Firewall- und Proxyeinstellungen
Software für Sicherheitsscans kann Ihre Fähigkeit beeinträchtigen, Dateien von AWS Toolkit-Sprachservern herunterzuladen, indem sie Dateien aus Downloads entfernt oder Downloads ganz verhindert.
Um Ihre Firewall- und Proxyeinstellungen zu überprüfen, navigieren Sie von einem Internetbrowser aus, der auf demselben System wie Ihre Visual Studio-Instanz installiert ist, zu [https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json](https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json). Wenn Sie auf einen Fehler stoßen oder die Seite nicht geladen werden kann, verhindert möglicherweise eine Firewall oder ein Proxyfilter, dass Sie nicht darauf zugreifen können. `aws-toolkit-language-servers.amazonaws.com`
### Benutzerdefinierte Zertifikate
Der AWS Toolkit for Visual Studio verwendet einen Sprachserver, der auf der Runtime Node.js läuft. Ausführliche Informationen dazu, wie Sie überprüfen können, ob Ihr Netzwerk ein benutzerdefiniertes Zertifikat verwendet, finden Sie unter den [Einstellungen für die Konfiguration und Anmeldeinformationsdatei](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html#cli-config-ca_bundle) im AWS CLI Thema im *AWS Command Line Interface*Benutzerhandbuch für Version 1.
Um Ihre Proxyeinstellungen zu konfigurieren und ein Zertifikat zu definieren, müssen Sie Ihre `HTTPS_PROXY` env-Variable konfigurieren und Windows-Umgebungsvariablen für die Schlüssel `NODE_OPTIONS` und `NODE_EXTRA_CA_CERTS` erstellen.
Gehen Sie wie folgt vor, um Ihre `HTTPS_PROXY` env-Variable zu konfigurieren.
1. Wählen Sie im Visual-Studio-Hauptmenü **Tools** und anschließend **Optionen** aus.
1. **Erweitern Sie im Menü „**Optionen**“ die Option „**AWS Toolkit**“ und wählen Sie dann „Proxy“.**
1. Definieren Sie im **Proxy-Menü** Ihren **Host** und **Port**.
**Anmerkung**
Informationen zur Konfiguration `HTTPS_PROXY` von finden Sie im AWS CLI Abschnitt [Verwenden eines HTTP-Proxys für das](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-proxy.html) entsprechende AWS CLI Thema im *AWS Command Line Interface*Benutzerhandbuch.
Erstellen Sie Windows-Umgebungsvariablen für die folgenden Schlüssel.
+ `NODE_OPTIONS = --use-openssl-ca`
+ `NODE_EXTRA_CA_CERTS = Path/To/Corporate/Certs`
**Anmerkung**
Weitere Informationen zum Extrahieren von Unternehmensstammzertifikaten finden Sie im Artikel [Exportieren eines Zertifikats mit seinem privaten Schlüssel](https://learn.microsoft.com/en-us/windows-server/identity/ad-cs/export-certificate-private-key) auf *learn.microsoft.com*. *Ausführliche Informationen zu den Schlüsseln der Windows-Umgebungsvariablen finden Sie in der Dokumentation zu [Node.js v23.3.0](https://nodejs.org/api/cli.html#cli_node_extra_ca_certs_file) auf nodejs.org.*
### Liste und weitere Schritte zulassen
Firewall-Einstellungen stören nicht nur die AWS Toolkit-Sprachserver, sondern können auch verhindern, dass Amazon Q auf Amazon S3 hochlädt und die Service-API aufruft. Um das Potenzial dieser Fehler zu minimieren, empfehlen wir, den ausgehenden Internetzugang über **Port 443 (HTTPS)** für die folgenden Endpunkte zuzulassen:
+ `https://codewhisperer.us-east-1.amazonaws.com/`
+ `https://amazonq-code-transformation-us-east-1-c6160f047e0.s3.amazonaws.com/`
+ `https://aws-toolkit-language-servers.amazonaws.com/`
+ `https://q.us-east-1.amazonaws.com`
+ `https://client-telemetry.us-east-1.amazonaws.com`
+ `https://cognito-identity.us-east-1.amazonaws.com`
+ `https://oidc.us-east-1.amazonaws.com`
Eine ausführliche Liste der Endpunkte finden Sie im Thema [Aktualisieren von Firewalls und Gateways, um den Zugriff zu ermöglichen in](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/endpoints.html) diesem Benutzerhandbuch. Ausführliche Informationen zur Konfiguration eines Unternehmens-Proxys für Amazon Q finden Sie im Thema [Konfiguration eines Unternehmens-Proxys in Amazon Q](https://docs.aws.amazon.com//amazonq/latest/qdeveloper-ug/firewall.html#corp-proxy) im *Amazon Q Developer User Guide*. Wenn Sie weiterhin auf Probleme mit der Firewall und dem Proxy stoßen, sammeln Sie Ihre AWS Toolkit-Protokolle und wenden Sie sich über den [AWS Toolkit for Visual Studio Problembereich](https://github.com/aws/aws-toolkit-visual-studio/issues) des AWS Toolkit for Visual Studio GitHub Repositorys an das AWS Toolkit for Visual Studio Team. Einzelheiten zur Erfassung Ihrer AWS Toolkit-Logs finden Sie im Abschnitt „**Bewährte Methoden zur Fehlerbehebung**“ in diesem Thema im Benutzerhandbuch.