Configuration du démarrage automatique à l'aide des cmdlets d'AppFabric

Cette rubrique décrit la configuration du démarrage automatique pour une application ou un service à l'aide de cmdlets d'AppFabric.

Activation du démarrage automatique d'une application

Dans la console Windows PowerShell pour AppFabric, exécutez la cmdlet Set-ASApplication avec le paramètre -AutoStartMode défini sur « All » ou sur « Custom » pour activer le démarrage automatique pour les services de l'application. La définition du paramètre -AutoStartMode sur « All » active le démarrage automatique pour tous les services de l'application. La définition du paramètre -AutoStartMode sur « Custom » désactive le démarrage automatique pour tous les services de l'application, à l'exception de ceux pour lesquels il est spécifiquement activé (à l'aide de la commande Enable-ASAppServiceAutoStart).

L'activation du démarrage automatique pour une application ajoute l'attribut serviceAutoStartEnabled défini sur une valeur « true » dans le fichier applicationHost.config au niveau du serveur. L'activation du démarrage automatique pour tous les services de l'application définit l'attribut serviceStartupMode pour l'application dans le fichier applicationHost.config sur la valeur « all ». La définition du mode sur « Personnalisé » définit l'attribut serviceStartupMode sur la valeur « custom ».

Options de syntaxe de la cmdlet Set-ASApplication :

Syntaxe 1

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

Syntaxe 2

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

Syntaxe 3

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

Paramètre	Description
-SiteName	Nom du site de l'application WCF ou WF pour laquelle activer le démarrage automatique.
-VirtualPath	Chemin d'accès virtuel à l'application WCF ou WF pour laquelle activer le démarrage automatique.
-Uri	Identificateur d'un service ou d'une application spécifique.
-ApplicationObject	Nom d'un objet application entraînant l'utilisation du fichier Web.config correspondant comme base pour l'opération de la cmdlet.
-AutoStartMode <-All|-Custom> (facultatif)	La valeur « All » spécifie que le démarrage automatique est activé pour tous les services de l'application, et que les paramètres de démarrage automatique spécifiques d'un service sont ignorés (comportement par défaut si le paramètre -AutoStartMode n'est pas inclus). La valeur « Custom » désactive le démarrage automatique pour tous les services de l'application, à l'exception de ceux pour lesquels il est spécifiquement activé. Le mode Démarrage automatique pour un service dépend du mode Démarrage automatique pour une application.
-EnableApplicationPool (facultatif)	Active le démarrage automatique du pool d'applications utilisé par l'application. Définit l'attribut startMode du pool d'applications sur « AlwaysRunning ».

Désactivation du démarrage automatique d'une application

Dans la console Windows PowerShell pour AppFabric, exécutez la cmdlet Set-ASApplication avec le paramètre -AutoStartMode défini sur « Disable » pour désactiver le démarrage automatique pour les services de l'application. Cette action supprime l'attribut serviceAutoStartMode du fichier applicationHost.config. Sans l'attribut serviceStartupMode, le démarrage automatique est désactivé.

Options de syntaxe de la cmdlet Set-ASApplication :

Syntaxe 1

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

Syntaxe 2

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

Syntaxe 3

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

Paramètre	Description
-SiteName (obligatoire)	Nom du site de l'application WCF ou WF pour laquelle activer le démarrage automatique.
-VirtualPath (obligatoire)	Chemin d'accès virtuel à l'application WCF ou WF pour laquelle activer le démarrage automatique.
-Uri	Identificateur d'un service ou d'une application spécifique.
-ApplicationObject	Nom d'un objet application entraînant l'utilisation du fichier Web.config correspondant comme base pour l'opération de la cmdlet.
-AutoStartMode <Disable>	La valeur « Disable » spécifie que le démarrage automatique sera désactivé pour tous les services de l'application.
-EnableApplicationPool (facultatif)	Nom du pool d'applications appliqué pour l'application.

Obtention des paramètres de démarrage automatique d'une application

Dans la console Windows PowerShell pour AppFabric, exécutez la cmdlet Get-ASApplication pour obtenir les paramètres de démarrage automatique pour une application. La cmdlet renvoie les paramètres de l'objet ApplicationInfo.

Options de syntaxe de la cmdlet Get-ASApplication :

Syntaxe 1

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

Paramètre	Description
-SiteName (obligatoire)	Nom du site de l'application WCF ou WF pour laquelle obtenir les paramètres de démarrage automatique.
-VirtualPath (obligatoire)	Chemin d'accès virtuel à l'application WCF ou WF pour laquelle obtenir les paramètres de démarrage automatique.
-ApplicationPoolName (obligatoire)	Nom du pool d'applications appliqué pour l'application.

Activation du démarrage automatique d'un service

Dans la console Windows PowerShell pour AppFabric, exécutez la cmdlet Enable-ASAppServiceAutoStart pour activer le démarrage automatique pour un service. Pour ce faire, activez le démarrage automatique pour l'application contenant le service en exécutant la cmdlet Set-ASApplication avec le paramètre AutoStartMode défini sur « Custom ». L'activation du démarrage automatique d'un service ajoute une ligne serviceAddress à l'attribut serviceAutoStart pour le service dans le fichier Web.config de l'application. Vous pouvez indiquer le service pour lequel activer le démarrage automatique à l'aide du paramètre défini -SiteName -VirtualPath, du paramètre défini -Uri ou du paramètre ServiceObject.

Options de syntaxe de la cmdlet Enable-ASAppServiceAutoStart :

Syntaxe 1

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

Syntaxe 2

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

Syntaxe 3

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

Paramètre	Description
-SiteName (obligatoire)	Nom du site du service WCF ou WF pour lequel activer le démarrage automatique.
-VirtualPath (obligatoire)	Chemin d'accès virtuel au service WCF ou WF pour lequel activer le démarrage automatique.
-Uri	Identificateur d'un service ou d'une application spécifique.
-ServiceObject	Nom d'un objet service entraînant l'utilisation du fichier Web.config correspondant comme base pour l'opération de la cmdlet.

Désactivation du démarrage automatique d'un service

Dans la console Windows PowerShell pour AppFabric, exécutez la cmdlet Disable-ASAppServiceAutoStart pour désactiver le démarrage automatique pour un service. La désactivation du démarrage automatique pour un service supprime une ligne serviceAddress de l'attribut serviceAutoStart pour le service dans le fichier Web.config de l'application. Vous pouvez indiquer le service pour lequel désactiver le démarrage automatique à l'aide du paramètre défini -SiteName -VirtualPath, du paramètre défini -Uri ou du paramètre ServiceObject.

Options de syntaxe de la cmdlet Disable-ASAppServiceAutoStart :

Syntaxe 1

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

Syntaxe 2

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

Syntaxe 3

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

Paramètre	Description
-SiteName (obligatoire)	Nom du site du service WCF ou WF pour lequel désactiver le démarrage automatique.
-VirtualPath (obligatoire)	Chemin d'accès virtuel au service WCF ou WF pour lequel désactiver le démarrage automatique.
-Uri	Identificateur d'un service ou d'une application spécifique.
-ServiceObject	Nom d'un objet service entraînant l'utilisation du fichier Web.config correspondant comme base pour l'opération de la cmdlet.

Obtention des paramètres de démarrage automatique d'un service

Dans la console Windows PowerShell pour AppFabric, exécutez la cmdlet Get-ASAppServiceAutoStart pour obtenir les paramètres de démarrage automatique pour un service. La cmdlet renvoie les paramètres de l'objet ServiceAutoStartInfo. Vous pouvez indiquer le service pour lequel obtenir les informations des démarrage automatique à l'aide du paramètre défini -SiteName -VirtualPath, du paramètre défini -Uri ou du paramètre ServiceObject.

Options de syntaxe de la cmdlet Get-ASAppServiceAutoStart :

Syntaxe 1

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

Syntaxe 2

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

Syntaxe 3

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

Paramètre	Description
-SiteName (obligatoire)	Nom du site du service WCF ou WF pour lequel obtenir les informations de démarrage automatique.
-VirtualPath (obligatoire)	Chemin d'accès virtuel au service WCF ou WF pour lequel obtenir les informations de démarrage automatique.
-Uri	Identificateur d'un service ou d'une application spécifique.
-ServiceObject	Nom d'un objet service entraînant l'utilisation du fichier Web.config correspondant comme base pour l'opération de la cmdlet.

  2012-03-05