Behandeln von häufigen Problemen im Zusammenhang mit Web Deploy - Internet Information Services

Artikel
03/20/2024

Gilt für: Internetinformationsdienste

In diesem Artikel wird beschrieben, wie Sie häufige Probleme mit Web Deploy diagnostizieren und beheben, einschließlich häufiger Fehler, die bei der Veröffentlichung in Visual Studio 2010 auftreten.

Protokollierung

Wenn Probleme im Zusammenhang mit Web Deploy auftreten, gibt es verschiedene Protokollierungsoptionen, je nachdem, wo das Problem auftritt. Standardmäßig protokolliert Web Deploy im Ereignisprotokoll unter Anwendungen>Microsoft Web Deploy. Dies ist ein guter Ort, um auf dem Zielserver nach Fehlern zu suchen.

Wenn Sie das Problem nicht mithilfe des Ereignisprotokolls diagnostizieren können, finden Sie hier einige weitere Optionen:

Verwenden Sie Web Deploy MSI-Protokolle unter %programfiles%\IIS\Microsoft Web Deploy v3 , um Installationsprobleme zu diagnostizieren.
Wenn der Webverwaltungsdienst oder der Remote-Agent-Dienst nicht gestartet werden kann, lesen Sie die Fehlerdetails unter Ereignisanzeige (lokal)>Windows Logs>System for Service Control Manager.
Sie können die Ablaufverfolgung für den Webverwaltungsdienst weiter konfigurieren.

Fehlercodes

Für bestimmte häufige Fehlerfälle zeigt Web Deploy eine Meldung und einen Fehlercode an, die hilfreich sein können, um weitere Informationen zur Problembehandlung zu erhalten. Eine vollständige Liste der Fehlercodes finden Sie unter Web Deploy-Fehlercodes.

Hinweis

Je nachdem, wie Web Deploy aufgerufen wird, kann sich die Fehlermeldung unterscheiden. Microsoft WebMatrix zeigt beispielsweise benutzerdefinierte Fehlermeldungen anstelle von Fehlercodes an, während in der Befehlszeile immer Fehlercodes angezeigt werden, wenn diese protokolliert werden.

Installationsprobleme

1. Web Deploy konnte unter einem gültigen Betriebssystem nicht installiert werden

Symptome	Das Betriebssystem ist korrekt, und die Version und Bitanzahl von Web Deploy sind korrekt, aber die Installation ist nicht erfolgreich.
Ursache	Unbekannt
Korrektur/Problemumgehung	Suchen Sie im Installationsprotokoll unter %programfiles%\IIS\Microsoft Web Deploy V3.

2. Web Deploy funktioniert nach einem Upgrade nicht

Symptome	Web Deploy funktioniert nach einem Versionsupgrade nicht mehr.
Ursache	Web Deploy startet Dienste nach einem Upgrade nicht neu.
Korrektur/Problemumgehung	Wenn Sie eine vorhandene Installation von Web Deploy aktualisieren, stellen Sie sicher, dass Sie den Handler und die Agent-Dienste neu starten, indem Sie die folgenden Befehle an einer administrativen Eingabeaufforderung ausführen: `net stop msdepsvc` `net start msdepsvc` `net stop wmsvc` `net start wmsvc`

3. Web Deploy 32-Bit-Version konnte nicht auf 64-Bit-Hardware installiert werden

Symptome
Ursache	Der Versuch, die 32-Bit-Version auf einem 64-Bit-Betriebssystem zu installieren, ist eine Überprüfung innerhalb der Web Deploy-MSI, die fehlschlägt, da der WoW64-Modus nicht unterstützt wird.
Korrektur/Problemumgehung	Installieren Sie dieselbe Version, die der Architektur Ihres Betriebssystems entspricht.

4. Die 64-Bit-Version von Web Deploy konnte nicht auf 32-Bit-Hardware installiert werden.

Symptome
Ursache	Der Versuch, die 64-Bit-Version auf einem 32-Bit-Betriebssystem zu installieren, ist eine Überprüfung innerhalb der MSI von Web Deploy, die fehlschlägt.
Korrektur/Problemumgehung	Installieren Sie dieselbe Version, die der Architektur Ihres Betriebssystems entspricht.

5. Der URL-Namespace konnte aufgrund eines bereits vorhandenen Namespaces nicht registriert werden.

Symptome	Web Deploy kann nicht installiert werden.
Ursache	Der URL-Namespace, den Web Deploy während der Installation zu erstellen versucht, ist bereits registriert.
Korrektur/Problemumgehung	– Entfernen Sie die in Konflikt stehende Registrierung. – Ändern der Web Deploy-URL während der Installation `msiexec /i wdeploy.msi /passive ADDLOCAL=ALL LISTENURL=http://+:8080/MSDEPLOY2/`. Weitere Informationen zur URL-Anpassung finden Sie unter Anpassen und Schützen des Remotediensts.

Probleme mit dem Remote-Agent-Dienst

1. Microsoft.Web.Deployment.Dll konnte während des Starts nicht initialisiert werden

Symptome	Der Remote-Agent-Dienst kann nicht gestartet werden.
Ursache	msdepsvc.exe oder andere Dateien fehlen in %programfiles%\IIS\Microsoft Web Deploy v3.
Korrektur/Problemumgehung	Installieren Sie das Produkt neu.

2. Der Remote-Agent-Dienst wurde nicht gestartet

Symptome	Microsoft.Web.Deployment.DeploymentAgentUnavailableException: Remote-Agent (URL `http://DestinationServer/msdeployagentservice`) konnte nicht kontaktiert werden. Stellen Sie sicher, dass der Remote-Agent-Dienst auf dem Zielcomputer installiert und gestartet ist. >--- System.Net.WebException: Der Remoteserver hat einen Fehler zurückgegeben: (404) Nicht gefunden.
Ursache	Der Remote-Agent-Dienst wurde nicht gestartet.
Korrektur/Problemumgehung	Starten Sie den Dienst: `net start msdepsvc`.

3. Herstellen einer Verbindung mit einem Server, auf dem HTTP nicht lauscht oder nicht zulässig ist

Symptome Microsoft.Web.Deployment.DeploymentAgentUnavailableException: Remote-Agent (URL http://DestinationServer/msdeployagentservice) konnte nicht kontaktiert werden. Stellen Sie sicher, dass der Remote-Agent-Dienst auf dem Zielcomputer installiert und gestartet ist. >--- System.Net.WebException: Verbindung mit dem Remoteserver nicht möglich ---> System.Net.Sockets.SocketException: Es konnte keine Verbindung hergestellt werden, da der Zielcomputer sie aktiv abgelehnt hat DestinationServer:80

Ursache HTTP lauscht nicht.

Korrektur/Problemumgehung Stellen Sie sicher, dass HTTP-Datenverkehr für den Remote-Agent-Dienst zulässig ist.

Symptome	Microsoft.Web.Deployment.DeploymentAgentUnavailableException: Remote-Agent (URL `http://DestinationServer/msdeployagentservice`) konnte nicht kontaktiert werden. Stellen Sie sicher, dass der Remote-Agent-Dienst auf dem Zielcomputer installiert und gestartet ist. >--- System.Net.WebException: Verbindung mit dem Remoteserver nicht möglich ---> System.Net.Sockets.SocketException: Es konnte keine Verbindung hergestellt werden, da der Zielcomputer sie aktiv abgelehnt hat DestinationServer:80
Ursache	HTTP lauscht nicht.
Korrektur/Problemumgehung	Stellen Sie sicher, dass HTTP-Datenverkehr für den Remote-Agent-Dienst zulässig ist.

4. Versuch, eine Verbindung mit einem Server herzustellen, mit dem Fehler "Methode nicht zulässig"

Symptome	Microsoft.Web.Deployment.DeploymentException: Die Anforderung an die Remote-Agent-URL "`http://DestinationServer/`" konnte nicht abgeschlossen werden. >--- System.Net.WebException: Der Remoteserver hat einen Fehler zurückgegeben: (405) Methode nicht zulässig.
Ursache	Die Anforderung wurde von Internetinformationsdienste (IIS) selbst anstelle von MS Deploy aufgenommen, da der Pfad zu msdepsvc.exe fehlt.
Korrektur/Problemumgehung	Ändern Sie die URL so, dass sie enthält `/MSDeployAgentService`.

5. Zugriff auf den Remote-Agent-Dienst als Nicht-Administrator

Symptome	Microsoft.Web.Deployment.DeploymentException: Die Anforderung an die Remote-Agent-URL "`http://DestinationServer/msdeployAgentService`" konnte nicht abgeschlossen werden. >---; System.Net.WebException: Der Remoteserver hat einen Fehler zurückgegeben: (401) Nicht autorisiert.
Ursache	Der Remote-Agent-Dienst erfordert, dass der Aufrufer Mitglied der Gruppe Administratoren oder aus einem Domänenkonto ist, das der Gruppe Administratoren hinzugefügt wurde. Ein lokaler Administrator, der nicht das integrierte Konto ist, funktioniert aufgrund eines Fehlers in Web Deploy 2.0 nicht mit dem Remote-Agent-Dienst.
Korrektur/Problemumgehung	Geben Sie Administratoranmeldeinformationen an.

6. Remote-Agent-Dienst hängt während des Betriebs

Symptome	Der Dienst reagiert möglicherweise für einen längeren Zeitraum bis zu mehreren Stunden nicht mehr.
Ursache	Unbekannt.
Korrektur/Problemumgehung	Beenden Sie den Vorgang, und versuchen Sie, ihn zu wiederholen.

7. Client und Server sind nicht kompatibel (Versionskonflikt)

Symptome	Timestamp=24638007621418 MsDepSvc.exe Fehler: 0 : Fehler. Die Ausnahmedetails sind wie folgt: Microsoft.Web.Deployment.DeploymentClientServerException: Client und Server sind nicht kompatibel. Die niedrigste vom Client unterstützte Version ist "7.1.538.0". Die höchste vom Server unterstützte Version ist "7.1.537.0".
Ursache	Einige Versionen funktionieren nicht zusammen, sodass Web Deploy die Zusammenarbeit blockiert. Dies wird in der Regel durchgeführt, um zu verhindern, dass Vorabversionen mit veröffentlichten Versionen ausgeführt werden.
Korrektur/Problemumgehung	Übereinstimmung mit den Versionen.

8. Der Remote-Agent-Dienst konnte nicht mit dem Lauschen an der URL beginnen

Symptome	Der Remote-Agent-Dienst konnte nicht beginnen, an der URL ""{0} zu lauschen. Stellen Sie sicher, dass die URL nicht verwendet wird.
Ursache	Weist in der Regel auf einen URL-Konflikt hin.
Korrektur/Problemumgehung	Versuchen Sie, die Standard-URL neu zu installieren, oder legen Sie eine benutzerdefinierte URL fest, wie in der Dokumentation angegeben. Weitere Informationen zur URL-Anpassung finden Sie unter Anpassen und Schützen des Remotediensts.

Probleme mit dem Webverwaltungsdienst

1. Der Webverwaltungsdienst wurde nicht gestartet

Symptome	Der Webverwaltungsdienst wurde nicht gestartet.
Ursache	Unbekannt. Der Dienst sollte standardmäßig gestartet werden.
Korrektur/Problemumgehung	Starten Sie den Webverwaltungsdienst: `Net Start WMSVC`.

2. Nicht autorisiert: Benutzer nicht durch Bereitstellungshandlerregeln autorisiert

Symptome	Ein Vorgang mit dem angegebenen ProviderName <> konnte beim Herstellen einer Verbindung mit dem Webverwaltungsdienst nicht abgeschlossen werden. Dies kann auftreten, wenn der Serveradministrator den Benutzer nicht für diesen Vorgang autorisiert hat.
Ursache	Ein Benutzer ohne Administratorrechte hat versucht, eine eingeschränkte Aktion mit einem Anbieter auszuführen. Diese Aktion gibt in der Regel an, dass keine übereinstimmende Delegierungsregel gefunden wurde. Entweder der Benutzername, der Anbieter, der Vorgang oder der Anbieterpfad ist falsch.
Korrektur/Problemumgehung	Die Problemumgehung besteht darin, die Delegierungsregel zu korrigieren oder eine zu erstellen. Weitere Informationen zu Delegierungsregeln finden Sie unter Konfigurieren des Webbereitstellungshandlers.

Fehler beim Veröffentlichen aus Visual Studio

Weitere Informationen zur Behandlung häufiger Fehler, die beim Veröffentlichen von Visual Studio auf einem Server auftreten können, der nicht ordnungsgemäß über Web Deploy konfiguriert wurde, finden Sie unter Problembehandlung bei Web Deploy-Problemen mit Visual Studio.