Verwenden von Emulator Express zum Ausführen und Debuggen eines Azure-Clouddiensts auf einem lokalen Computer

  • Artikel

Hinweis

Dieser Artikel bezieht sich auf Azure Cloud Services (klassisch), das für neue Kunden nun veraltet ist und am 31. August 2024 eingestellt wird. Vorhandene Dienste, die mit dieser Technologie erstellt wurden, werden weiterhin über Azure Cloud Services (erweiterter Support) unterstützt. Für eine neue Entwicklung empfehlen wir, einen neueren Diensttyp zu verwenden, der für Ihren spezifischen Zweck entwickelt wurde, z. B. Azure App Service, Azure Functions oder Azure Container Apps. Die neueste Liste der verfügbaren Dienste finden Sie im Verzeichnis der Azure-Produkte.

Mithilfe von Emulator Express können Sie einen Clouddienst testen und debuggen, ohne Visual Studio als Administrator auszuführen. Abhängig von den Anforderungen Ihres Clouddiensts können Sie die Projekteinstellungen für die Verwendung von Emulator Express oder des vollständigen Emulators festlegen. Weitere Informationen zum vollständigen Emulator finden Sie unter Ausführen einer Azure-Anwendung im Serveremulator.

Verwenden von Emulator Express in Visual Studio

Wenn Sie ein Azure-Projekt erstellen, wird automatisch der Emulator Express verwendet. Für vorhandene Projekte, die mit einer früheren Version des Azure SDK erstellt wurden, führen Sie die folgenden Schritte aus, um Emulator Express auszuwählen:

  1. Erstellen oder öffnen Sie ein Azure-Clouddienstprojekt in Visual Studio.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und wählen Sie im Kontextmenü die Option Eigenschaften aus.

  3. Wählen Sie auf den Eigenschaftenseiten die Registerkarte Web aus.

    Eigenschaften für ein Azure-Clouddienstprojekt

  4. Wählen Sie unter Lokaler Bereitstellungsserver die Option IIS Express verwenden aus.

  5. Wählen Sie unter Emulator die Option Emulator Express verwenden aus.

  6. Um Emulator Express zu starten, führen Sie den folgenden Befehl an einer Eingabeaufforderung aus:

    csrun.exe /useemulatorexpress

Emulator Express-Einschränkungen

Die folgenden Probleme sind bekannte Einschränkungen von Emulator Express:

  • Emulator Express ist nicht mit IIS-Webservern kompatibel.
  • Der Clouddienst kann mehrere Rollen enthalten, dabei ist jedoch jede Rolle auf eine Instanz beschränkt.
  • Der Zugriff auf Portnummern unterhalb von 1000 ist nicht möglich. Wenn Sie einen Authentifizierungsanbieter verwenden, der üblicherweise einen Port unter 1000 verwendet, müssen Sie diesen Wert u.U. in eine Portnummer über 1000 ändern.
  • Einschränkungen, die auf den Azure-Compute-Emulator zutreffen, gelten auch für Emulator Express. Sie können z. B. nicht mehr als 50 Rolleninstanzen pro Bereitstellung verwenden. Weitere Informationen zum Azure-Serveremulator finden Sie unter Ausführen einer Azure-Anwendung im Serveremulator.

Zugehöriger Inhalt

Debuggen von Azure Cloud Services