Controlando aplicativos usando Cmdlets do Windows Server AppFabric
Este tópico descreve como parar e iniciar um aplicativo usando cmdlets do AppFabric. Para parar um aplicativo, o cmdlet Stop-ASApplication desabilita todos os protocolos do aplicativo e para seu início automático. Para iniciar um aplicativo, o cmdlet Start-ASApplication habilita novamente todos os protocolos do aplicativo e restaura seu início automático. Você também pode executar o cmdlet Get-ASApplication para determinar o estado e o início automático do aplicativo.
Para obter mais informações sobre a execução de cmdlets, consulte Executando cmdlets do Windows Server AppFabric.
Para parar um aplicativo
No console do AppFabric Windows PowerShell, execute o cmdlet Stop-ASApplication para parar um aplicativo corretamente. Esse cmdlet faz o seguinte:
Desabilita todos os protocolos do aplicativo (desabilitando o fluxo de mensagens) copiando todo o conteúdo do atributo "enabledProtocols" para o atributo "previouslyEnabledProtocols" (sempre substituindo seu conteúdo) no elemento \configuration\system.applicationHost\sites\site\application do arquivo applicationHost.config de um determinado aplicativo virtual. O cmdlet então limpa o conteúdo do atributo "enabledProtocols".
Para o início automático do aplicativo definindo a propriedade serviceAutoStartEnabled como “false” na configuração do aplicativo virtual do arquivo applicationHost.config.
Opções de sintaxe:
Sintaxe 1
Stop-ASApplication [-SiteName] <String> [[-VirtualPath] <String>] [-Confirm] [-WhatIf] [<CommonParameters>]
Sintaxe 2
Stop-ASApplication [-Uri] <Uri> [-Confirm] [-WhatIf] [<CommonParameters>]
Sintaxe 3
Stop-ASApplication -ApplicationObject <ApplicationInfo> [-Confirm] [-WhatIf] [<CommonParameters>]
| Parâmetro | Descrição |
|---|---|
-SiteName <String> –VirtualPath <String> |
Um ponteiro para um site ou aplicativo, indicando qual aplicativo, ou aplicativos, deve ser parado. Se o parâmetro definido indicar um site, o cmdlet parará todos os aplicativos do site. |
-Uri <Uri> |
Um ponteiro para um site ou aplicativo específico, indicando qual aplicativo, ou aplicativos, deve ser parado. Se o parâmetro definido indicar um site, o cmdlet parará todos os aplicativos do site. |
-ApplicationObject <ServiceInfo> |
Um ponteiro para um aplicativo específico que será parado. |
-Confirm |
Se presente, solicitará uma confirmação antes da execução do comando. |
-WhatIf |
Se presente, exibirá uma mensagem descrevendo o efeito do comando, em vez de executá-lo. |
Para iniciar um aplicativo
No console do AppFabric Windows PowerShell, execute o cmdlet Start-ASApplication para iniciar um aplicativo corretamente. O cmdlet faz o seguinte:
Habilita novamente os protocolos do aplicativo no arquivo applicationHost.config copiando o conteúdo de “previouslyEnabledProtocols” em “enabledProtocols”, e removendo o atributo "previouslyEnabledProtocols".
Restaura o início automático do aplicativo definindo serviceAutoStartEnabled no arquivo applicationHost.config como “True” se o atributo serviceAutoStartMode do aplicativo no arquivo applicationHost.config for “All” ou “Custom”.
Opções de sintaxe:
Sintaxe 1
Start-ASApplication [-SiteName] <String> [[-VirtualPath] <String>] [-StartApplicationPool] [<CommonParameters>]
Sintaxe 2
Start-ASApplication [-Uri] <Uri> [-StartApplicationPool] [<CommonParameters>]
Sintaxe 3
Start-ASApplication -ApplicationObject <ApplicationInfo> [-StartApplicationPool] [<CommonParameters>]
| Parâmetro | Descrição |
|---|---|
-SiteName <String> –VirtualPath <String> |
Um ponteiro para um site ou aplicativo, indicando qual aplicativo, ou aplicativos, deve ser iniciado. Se o parâmetro definido indicar um site, o cmdlet iniciará todos os aplicativos do site. |
-Uri <Uri> |
Um ponteiro para um site ou aplicativo específico, indicando qual aplicativo, ou aplicativos, deve ser iniciado. Se o parâmetro definido indicar um site, o cmdlet iniciará todos os aplicativos do site. |
-ApplicationObject <ServiceInfo> |
Um ponteiro para um aplicativo específico que será iniciado. |
-StartApplicationPool |
Se este sinalizador estiver presente, o cmdlet iniciará o pool de aplicativos caso ele não esteja executando. Para que isso ocorra, startMode de appPool do aplicativo deverá ser definido como “AlwaysRunning”. |
Para determinar o estado de um aplicativo
No console do AppFabric Windows PowerShell, execute o cmdlet Get-ASApplication para retornar informações sobre o estado da operação. Get-ASApplication retorna o objeto ApplicationInfo. Você pode determinar o estado do aplicativo nas propriedades MessageFlowStatus, AutoStartEnabled e AutoStartMode do objeto ApplicationInfo.
Opções de sintaxe:
Sintaxe 1
Get-ASApplication [[-SiteName] <String>] [[-VirtualPath] <String>] [[-ApplicationPoolName] <String>] [<CommonParameters>]
| Parâmetro | Descrição |
|---|---|
-SiteName <String> –VirtualPath <String> |
Um ponteiro para um site ou aplicativo ao qual serão retornadas informações. Se o parâmetro definido indicar um site, o cmdlet retornará informações para todos os aplicativos no site. |
-ApplicationPoolName |
O nome do pool de aplicativos usado pelo aplicativo. |
2011-12-05