Konfigurieren des automatischen Starts mithilfe von Windows Server AppFabric-Cmdlets

In diesem Thema wird beschrieben, wie der automatische Start für eine Webanwendung oder einen Dienst mithilfe von AppFabric-Cmdlets konfiguriert werden.

So aktivieren Sie den automatischen Start für eine Webanwendung

Führen Sie in der AppFabric Windows PowerShell-Konsole das Cmdlet Set-ASApplication aus. Legen Sie dabei den Parameter -AutoStartMode auf All fest, um den automatischen Start für Dienste in der Webanwendung zu aktivieren. Das Festlegen des Parameters -AutoStartMode auf All aktiviert den automatischen Start für alle Dienste in der Webanwendung. Wenn Sie den Parameter -AutoStartMode auf Custom festlegen, geben Sie an, dass der automatische Start nicht für Dienste in der Webanwendung aktiviert ist – es sei denn, der automatische Start ist für den Dienst ausdrücklich aktiviert (durch Ausführen von Enable-ASAppServiceAutoStart).

Wenn Sie den automatischen Start für eine Webanwendung aktivieren, wird das Attribut serviceAutoStartEnabled mit einem festgelegten Wert von True der Datei ApplicationHost.config auf Serverebene hinzugefügt. Wenn Sie den automatischen Start für alle Dienste in der Webanwendung aktivieren, wird das Attribut serviceStartupMode für die Webanwendung in der Datei applicationHost.config auf den Wert all (alle) festgelegt. Wenn Sie den Modus auf Benutzerdefiniert festlegen, wird das Attribut serviceStartupMode auf den Wert custom (benutzerdefiniert) festgelegt.

Syntaxoptionen für Set-ASApplication:

Syntax 1

Set-ASApplication [-SiteName] <String> [[-VirtualPath] <String>] -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]

Syntax 2

Set-ASApplication [-Uri] <Uri> -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]

Syntax 3

Set-ASApplication -ApplicationObject <ApplicationInfo> -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]

Parameter	Beschreibung
-SiteName	Der Sitename für die WCF- oder WF-Anwendung, für die der automatische Start aktiviert werden soll.
-VirtualPath	Der virtuelle Pfad für die WCF- oder WF-Anwendung, für die der automatische Start aktiviert werden soll.
-Uri	Der Bezeichner für einen bestimmten Dienst oder eine Webanwendung.
-ApplicationObject	Der Name eines Anwendungsobjekts. Dieser Parameter führt zur Verwendung der entsprechenden Web.config-Datei als Basis für den Betrieb des Cmdlets.
-AutoStartMode <-All|-Custom> (optional)	Der Wert All gibt an, dass der automatische Start für alle Dienste in der Webanwendung aktiviert ist und die spezifischen Einstellungen für den automatischen Start des Diensts ignoriert werden (Standardverhalten, wenn -AutoStartMode nicht enthalten ist). Der Wert Custom gibt an, dass der automatische Start nicht für Dienste in der Webanwendung aktiviert ist – es sei denn, der automatische Start ist für den Dienst ausdrücklich aktiviert. Der automatische Startmodus für einen Dienst hängt vom automatischen Startmodus für eine Webanwendung ab.
-EnableApplicationPool (optional)	Aktiviert den automatischen Start für den Anwendungspool, der von der Webanwendung verwendet wird. Legt das Attribut startMode der Webanwendung auf AlwaysRunning fest.

So deaktivieren Sie den automatischen Start für eine Webanwendung

Führen Sie in der AppFabric Windows PowerShell-Konsole das Cmdlet Set-ASApplication aus. Legen Sie dabei den Parameter -AutoStartMode auf Disable fest, um den automatischen Start für Dienste in der Webanwendung zu deaktivieren. Durch diese Aktion wird das Attribut serviceAutoStartMode aus der Datei applicationHost.config gelöscht. Ohne das Attribut serviceStartupMode ist der automatische Start deaktiviert.

Syntaxoptionen für Set-ASApplication:

Syntax 1

Set-ASApplication [-SiteName] <String> [[-VirtualPath] <String>] -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]

Syntax 2

Set-ASApplication [-Uri] <Uri> -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]

Syntax 3

Set-ASApplication -ApplicationObject <ApplicationInfo> -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]

Parameter	Beschreibung
-SiteName (erforderlich)	Der Sitename für die WCF- oder WF-Anwendung, für die der automatische Start aktiviert werden soll.
-VirtualPath (erforderlich)	Der virtuelle Pfad für die WCF- oder WF-Anwendung, für die der automatische Start aktiviert werden soll.
-Uri	Der Bezeichner für einen bestimmten Dienst oder eine Webanwendung.
-ApplicationObject	Der Name eines Anwendungsobjekts. Dieser Parameter führt zur Verwendung der entsprechenden Web.config-Datei als Basis für den Betrieb des Cmdlets.
-AutoStartMode <Disable>	Der Wert Disable gibt an, dass der automatische Start für alle Dienste in der Webanwendung deaktiviert ist.
-EnableApplicationPool (optional)	Der Name des für die Webanwendung geltenden Anwendungspools.

So rufen Sie die Einstellungen für den automatischen Start für eine Webanwendung ab

Führen Sie in der AppFabric Windows PowerShell-Konsole das Cmdlet get-ASApplication aus, um die Einstellungen für den automatischen Start für eine Webanwendung abzurufen. Das Cmdlet gibt die Einstellungen im Objekt ApplicationInfo zurück.

Syntaxoptionen für Get-ASApplication:

Syntax 1

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

Parameter	Beschreibung
-SiteName (erforderlich)	Der Sitename für die WCF- oder WF-Anwendung, für die der automatische Start abgerufen werden soll.
-VirtualPath (erforderlich)	Der virtuelle Pfad für die WCF- oder WF-Anwendung, für die der automatische Start abgerufen werden soll.
-ApplicationPoolName (erforderlich)	Der Name des für die Webanwendung geltenden Anwendungspools.

So aktivieren Sie den automatischen Start für einen Dienst

Führen Sie in der AppFabric Windows PowerShell-Konsole das Cmdlet Enable-ASAppServiceAutoStart aus, um den automatischen Start für einen Dienst zu aktivieren. Aktivieren Sie zu diesem Zweck den automatischen Start für die Webanwendung, die den Dienst enthält, indem Sie Set-ASApplication ausführen, wobei AutoStartMode auf Custom festgelegt ist. Durch das Aktivieren des automatischen Starts für einen Dienst wird dem Attribut serviceAutoStart für den Dienst eine Zeile serviceAddress in der Anwendungsdatei Web.config hinzugefügt. Sie können den Dienst angeben, für den der automatische Start aktiviert werden soll, indem Sie den Parametersatz -SiteName -VirtualPath, den Parametersatz -Uri oder den Parameter ServiceObject verwenden.

Syntaxoptionen für Enable-ASAppServiceAutoStart:

Syntax 1

Enable-ASAppServiceAutoStart [-SiteName] <String> [-VirtualPath] <String> [<CommonParameters>]

Syntax 2

Enable-ASAppServiceAutoStart [-Uri] <Uri> [<CommonParameters>]

Syntax 3

Enable-ASAppServiceAutoStart -ServiceObject <ServiceInfo> [<CommonParameters>]

Parameter	Beschreibung
-SiteName (erforderlich)	Der Sitename für den WCF- oder WF-Dienst, für den der automatische Start aktiviert werden soll.
-VirtualPath (erforderlich)	Der virtuelle Pfad für den WCF- oder WF-Dienst, für den der automatische Start aktiviert werden soll.
-Uri	Der Bezeichner für einen bestimmten Dienst oder eine Webanwendung.
-ServiceObject	Der Name eines Dienstobjekts. Dieser Parameter führt zur Verwendung der entsprechenden Web.config-Datei als Basis für den Betrieb des Cmdlets.

So deaktivieren Sie den automatischen Start für einen Dienst

Führen Sie in der AppFabric Windows PowerShell-Konsole das Cmdlet Disable-ASAppServiceAutoStart aus, um den automatischen Start für einen Dienst zu deaktivieren. Durch das Deaktivieren des automatischen Starts für einen Dienst wird eine Zeile serviceAddress aus dem Attribut serviceAutoStart für den Dienst in der Anwendungsdatei Web.config entfernt. Sie können den Dienst angeben, für den der automatische Start deaktiviert werden soll, indem Sie den Parametersatz -SiteName -VirtualPath, den Parametersatz -Uri oder den Parameter ServiceObject verwenden.

Syntaxoptionen für Disable-ASAppServiceAutoStart:

Syntax 1

Disable-ASAppServiceAutoStart [-SiteName] <String> [-VirtualPath] <String> [-Confirm] [-WhatIf] [<CommonParameters>]

Syntax 2

Disable-ASAppServiceAutoStart [-Uri] <Uri> [-Confirm] [-WhatIf] [<CommonParameters>]

Syntax 3

Disable-ASAppServiceAutoStart -ServiceObject <ServiceInfo> [-Confirm] [-WhatIf] [<CommonParameters>]

Parameter	Beschreibung
-SiteName (erforderlich)	Der Sitename für den WCF- oder WF-Dienst, für den der automatische Start deaktiviert werden soll.
-VirtualPath (erforderlich)	Der virtuelle Pfad für den WCF- oder WF-Dienst, für den der automatische Start deaktiviert werden soll.
-Uri	Der Bezeichner für einen bestimmten Dienst oder eine Webanwendung.
-ServiceObject	Der Name eines Dienstobjekts. Dieser Parameter führt zur Verwendung der entsprechenden Web.config-Datei als Basis für den Betrieb des Cmdlets.

So rufen Sie die Einstellungen für den automatischen Start für einen Dienst ab

Führen Sie in der AppFabric Windows PowerShell-Konsole das Cmdlet Get-ASAppServiceAutoStart aus, um die Einstellungen für den automatischen Start für einen Dienst abzurufen. Das Cmdlet gibt die Einstellungen im Objekt ServiceAutoStartInfo zurück. Sie können den Dienst angeben, für den die Informationen über den automatischen Start abgerufen werden sollen, indem Sie den Parametersatz -SiteName -VirtualPath, den Parametersatz -Uri oder den Parameter ServiceObject verwenden.

Syntaxoptionen für Get-ASAppServiceAutoStart:

Syntax 1

Get-ASAppServiceAutoStart [-SiteName] <String> [-VirtualPath] <String> [<CommonParameters>]

Syntax 2

Get-ASAppServiceAutoStart [-Uri] <Uri> [<CommonParameters>]

Syntax 3

Get-ASAppServiceAutoStart -ServiceObject <ServiceInfo> [<CommonParameters>]

Parameter	Beschreibung
-SiteName (erforderlich)	Der Sitename für den WCF- oder WF-Dienst, für den Informationen zum automatischen Start abgerufen werden sollen.
-VirtualPath (erforderlich)	Der virtuelle Pfad für den WCF- oder WF-Dienst, für den Informationen zum automatischen Start abgerufen werden sollen.
-Uri	Der Bezeichner für einen bestimmten Dienst oder eine Webanwendung.
-ServiceObject	Der Name eines Dienstobjekts. Dieser Parameter führt zur Verwendung der entsprechenden Web.config-Datei als Basis für den Betrieb des Cmdlets.

  2011-12-05