Contrôle des applications à l'aide des cmdlets de Windows Server AppFabric
Cette rubrique décrit l'arrêt et le démarrage d'une application à l'aide de cmdlets d'AppFabric. Pour arrêter une application, la cmdlet Stop-ASApplication désactive tous les protocoles d'application et arrête la fonctionnalité de démarrage automatique. Pour démarrer une application, la cmdlet Start-ASApplication réactive tous les protocoles d'application et restaure la fonctionnalité de démarrage automatique. Vous pouvez également exécuter la cmdlet Get-ASApplication pour déterminer l'état des protocoles d'application et de la fonctionnalité de démarrage automatique.
Pour plus d'informations sur l'exécution des cmdlets, consultez la rubrique Exécution des cmdlets de Windows Server AppFabric.
Arrêt d'une application
Dans la console Windows PowerShell pour AppFabric, exécutez la cmdlet Stop-ASApplication pour arrêter une application correctement. Cette cmdlet exécute les opérations suivantes :
Elle désactive tous les protocoles d'application (en désactivant le flux des messages) d'une application en copiant tout le contenu de l'attribut « enabledProtocols » dans l'attribut « previouslyEnabledProtocols » (en remplaçant toujours son contenu) dans l'élément \configuration\system.applicationHost\sites\site\application du fichier applicationHost.config pour une application virtuelle particulière. Elle efface ensuite le contenu de l'attribut « enabledProtocols ».
Elle arrête la fonctionnalité de démarrage automatique de l'application en définissant sur « false » la propriété serviceAutoStartEnabled de la configuration d'application virtuelle figurant dans le fichier applicationHost.config.
Options de syntaxe :
Syntaxe 1
Stop-ASApplication [-SiteName] <String> [[-VirtualPath] <String>] [-Confirm] [-WhatIf] [<CommonParameters>]
Syntaxe 2
Stop-ASApplication [-Uri] <Uri> [-Confirm] [-WhatIf] [<CommonParameters>]
Syntaxe 3
Stop-ASApplication -ApplicationObject <ApplicationInfo> [-Confirm] [-WhatIf] [<CommonParameters>]
| Paramètre | Description |
|---|---|
-SiteName <String> –VirtualPath <String> |
Pointeur vers un site ou une application, indiquant les applications à arrêter. Si le paramètre défini indique un site, la cmdlet arrête toutes les applications figurant dans celui-ci. |
-Uri <Uri> |
Pointeur vers un site ou une application spécifique, indiquant les applications à arrêter. Si le paramètre défini indique un site, la cmdlet arrête toutes les applications figurant dans celui-ci. |
-ApplicationObject <ServiceInfo> |
Pointeur vers une application spécifique à arrêter. |
-Confirm |
Si ce paramètre est présent, l'application vous invite à confirmer l'exécution de la commande. |
-WhatIf |
Si ce paramètre est présent, au lieu d'exécuter la commande, l'application affiche un message décrivant l'effet de celle-ci. |
Démarrage d'une application
Dans la console Windows PowerShell pour AppFabric, exécutez la cmdlet Start-ASApplication pour démarrer une application correctement. Cette cmdlet exécute les opérations suivantes :
Elle réactive les protocoles d'application figurant dans le fichier applicationHost.config en copiant le contenu de l'attribut « previouslyEnabledProtocols » dans l'attribut « enabledProtocols », puis en supprimant l'attribut « previouslyEnabledProtocols ».
Elle restaure la fonctionnalité de démarrage automatique de l'application en définissant sur « True » l'attribut serviceAutoStartEnabled figurant dans le fichier applicationHost.config si l'attribut serviceAutoStartMode de l'application est défini sur « All » ou « Custom » dans le fichier applicationHost.config.
Options de syntaxe :
Syntaxe 1
Start-ASApplication [-SiteName] <String> [[-VirtualPath] <String>] [-StartApplicationPool] [<CommonParameters>]
Syntaxe 2
Start-ASApplication [-Uri] <Uri> [-StartApplicationPool] [<CommonParameters>]
Syntaxe 3
Start-ASApplication -ApplicationObject <ApplicationInfo> [-StartApplicationPool] [<CommonParameters>]
| Paramètre | Description |
|---|---|
-SiteName <String> –VirtualPath <String> |
Pointeur vers un site ou une application, indiquant les applications à démarrer. Si le paramètre défini indique un site, la cmdlet démarre toutes les applications figurant dans celui-ci. |
-Uri <Uri> |
Pointeur vers un site ou une application spécifique, indiquant les applications à démarrer. Si le paramètre défini indique un site, la cmdlet démarre toutes les applications figurant dans celui-ci. |
-ApplicationObject <ServiceInfo> |
Pointeur vers une application spécifique à démarrer. |
-StartApplicationPool |
Si cet indicateur est présent, la cmdlet démarre le pool d'applications s'il n'est pas en cours d'exécution. Pour cela, le paramètre startMode doit être défini sur « AlwaysRunning » dans le fichier appPool de l'application. |
Identification de l'état d'une d’application
Dans la console Windows PowerShell pour AppFabric, exécutez la cmdlet Get-ASApplication pour obtenir un retour d'informations sur l'état de l'opération. Get-ASApplication renvoie l'objet ApplicationInfo. Vous pouvez déterminer l'état de l'application à partir des propriétés MessageFlowStatus, AutoStartEnabled et AutoStartMode de l'objet ApplicationInfo.
Options de syntaxe :
Syntaxe 1
Get-ASApplication [[-SiteName] <String>] [[-VirtualPath] <String>] [[-ApplicationPoolName] <String>] [<CommonParameters>]
| Paramètre | Description |
|---|---|
-SiteName <String> –VirtualPath <String> |
Pointeur vers un site ou une application pour lequel renvoyer des informations. Si le paramètre défini indique un site, la cmdlet renvoie des informations pour toutes les applications figurant dans celui-ci. |
-ApplicationPoolName |
Nom du pool d'applications utilisé par l'application. |
2011-12-05