Steuern von Anwendungen mithilfe von Windows Server AppFabric-Cmdlets

In diesem Thema wird beschrieben, wie eine Webanwendung mithilfe von AppFabric-Cmdlets beendet und gestartet wird. Das Cmdlet Stop-ASApplication deaktiviert alle Anwendungsprotokolle und beendet den automatischen Start der Webanwendung, um eine Webanwendung zu beenden. Das Cmdlet Start-ASApplication aktiviert erneut alle Anwendungsprotokolle und stellt den automatischen Start der Webanwendung wieder her, um eine Webanwendung zu starten. Sie können auch das Cmdlet Get-ASApplication ausführen, um den Status von Anwendungsprotokollen und der automatischen Startfunktion zu ermitteln.

Weitere Informationen zum Ausführen von Cmdlets finden Sie unter Ausführen von Windows Server AppFabric-Cmdlets.

So beenden Sie eine Webanwendung

Führen Sie in der AppFabric Windows PowerShell-Konsole das Cmdlet Stop-ASApplication aus, um eine Webanwendung ordnungsgemäß zu beenden. Dieses Cmdlet führt die folgenden Aktionen aus:

  • Deaktivieren aller Anwendungsprotokolle (Deaktivieren der Nachrichtenübermittlung) einer Webanwendung durch Kopieren aller Inhalte des Attributs enabledProtocols in das Attribut previouslyEnabledProtocols (dabei wird sein Inhalt immer überschrieben) im Element \configuration\system.applicationHost\sites\site\application in der Datei applicationHost.config für eine bestimmte virtuelle Webanwendung. Das Cmdlet löscht anschließend die Inhalte des Attributs enabledProtocols.

  • Beenden des automatischen Starts der Webanwendung durch Festlegen der Eigenschaft serviceAutoStartEnabled in der Konfiguration der virtuellen Webanwendung in der Datei applicationHost.config auf False.

Syntaxoptionen:

Syntax 1

Stop-ASApplication [-SiteName] <String> [[-VirtualPath] <String>] [-Confirm] [-WhatIf] [<CommonParameters>]

Syntax 2

Stop-ASApplication [-Uri] <Uri> [-Confirm] [-WhatIf] [<CommonParameters>]

Syntax 3

Stop-ASApplication -ApplicationObject <ApplicationInfo> [-Confirm] [-WhatIf] [<CommonParameters>]
Parameter Beschreibung

-SiteName <Zeichenfolge> -VirtualPath <Zeichenfolge>

Ein Zeiger auf eine Site oder Webanwendung, der angibt, welche Anwendungen beendet werden sollen. Wenn der festgelegte Parameter eine Site angibt, beendet das Cmdlet alle Webanwendungen in der Site.

-Uri <Uri>

Ein Zeiger auf eine bestimmte Site oder Webanwendung, der angibt, welche Anwendungen beendet werden sollen. Wenn der festgelegte Parameter eine Site angibt, beendet das Cmdlet alle Webanwendungen in der Site.

-ApplicationObject <DienstInfo>

Ein Zeiger auf eine bestimmte Webanwendung, die beendet werden soll.

-Confirm

Wenn dieser Parameter vorhanden ist, werden Sie zu einer Bestätigung aufgefordert, bevor der Befehl ausgeführt wird.

-WhatIf

Wenn dieser Parameter vorhanden ist, wird eine Meldung angezeigt, die die Auswirkungen des Befehls beschreibt, anstatt den Befehl auszuführen.

So starten Sie eine Webanwendung

Führen Sie in der AppFabric Windows PowerShell-Konsole das Cmdlet Start-ASApplication aus, um eine Webanwendung ordnungsgemäß zu starten. Das Cmdlet führt die folgenden Aktionen aus:

  • Erneutes Aktivieren der Anwendungsprotokolle in der Datei applicationHost.config durch Kopieren der Inhalte von previouslyEnabledProtocols in enabledProtocols und anschließendes Entfernen des Attributs previouslyEnabledProtocols.

  • Wiederherstellen des automatischen Starts der Webanwendung durch Festlegen von serviceAutoStartEnabled in der Datei applicationHost.config auf True, wenn das Attribut serviceAutoStartMode der Webanwendung in der Datei applicationHost.configAll oder Custom lautet.

Syntaxoptionen:

Syntax 1

Start-ASApplication [-SiteName] <String> [[-VirtualPath] <String>] [-StartApplicationPool] [<CommonParameters>]

Syntax 2

Start-ASApplication [-Uri] <Uri> [-StartApplicationPool] [<CommonParameters>]

Syntax 3

Start-ASApplication -ApplicationObject <ApplicationInfo> [-StartApplicationPool] [<CommonParameters>]
Parameter Beschreibung

-SiteName <Zeichenfolge> -VirtualPath <Zeichenfolge>

Ein Zeiger auf eine Site oder Webanwendung, der angibt, welche Anwendungen gestartet werden sollen. Wenn der festgelegte Parameter eine Site angibt, startet das Cmdlet alle Webanwendungen in der Site.

-Uri <Uri>

Ein Zeiger auf eine bestimmte Site oder Webanwendung, der angibt, welche Anwendungen gestartet werden sollen. Wenn der festgelegte Parameter eine Site angibt, startet das Cmdlet alle Webanwendungen in der Site.

-ApplicationObject <DienstInfo>

Ein Zeiger auf eine bestimmte Webanwendung, die gestartet werden soll.

-StartApplicationPool

Wenn dieses Kennzeichen vorhanden ist, startet das Cmdlet den Anwendungspool, wenn dieser nicht ausgeführt wird. Damit dies geschieht, muss der Parameter startMode des Anwendungspools der Webanwendung auf AlwaysRunning festgelegt sein.

So ermitteln Sie den Status einer Webanwendung

Führen Sie in der AppFabric Windows PowerShell-Konsole das Cmdlet Get-ASApplication aus, um Informationen zum Status des Vorgangs zurückzugeben. Get-ASApplication gibt das Objekt ApplicationInfo zurück. Sie können den Status einer Webanwendung aus den Eigenschaften MessageFlowStatus, AutoStartEnabled und AutoStartMode im Objekt ApplicationInfo ermitteln.

Syntaxoptionen:

Syntax 1

Get-ASApplication [[-SiteName] <String>] [[-VirtualPath] <String>] [[-ApplicationPoolName] <String>] [<CommonParameters>]
Parameter Beschreibung

-SiteName <Zeichenfolge> -VirtualPath <Zeichenfolge>

Ein Zeiger auf eine Site oder Webanwendung, für die Informationen zurückgegeben werden sollen. Wenn der festgelegte Parameter eine Site angibt, gibt das Cmdlet Informationen zu allen Webanwendungen in der Site zurück.

-ApplicationPoolName

Der Name des von der Webanwendung verwendeten Anwendungspools.

  2011-12-05