ApplicationPool Class1
Representa um pool de aplicativos dos Serviços de Informações da Internet.
Sintaxe
class ApplicationPool : Object
Métodos
A tabela a seguir lista os métodos expostos pela classe ApplicationPool.
| Nome | Descrição |
|---|---|
| Criar | Cria um pool de aplicativos. |
| GetState | Retorna o estado em tempo de execução de um pool de aplicativos. |
| Recycle | Recicla um pool de aplicativos. |
| RevertToParent | Reverte o valor ou os valores de configuração de um pool de aplicativos para os do respectivo pool de aplicativos pai. |
| Iniciar | Inicia um pool de aplicativos. |
| Parar | Para um pool de aplicativos. |
Propriedades
A tabela a seguir lista as propriedades expostas pela classe ApplicationPool.
| Nome | Descrição |
|---|---|
AutoStart |
Um valor boolean de leitura/gravação. true se o serviço WWW (Serviço de Publicação na World Wide Web) iniciar o pool de aplicativos automaticamente quando o pool de aplicativos for criado ou quando o IIS iniciar, caso contrário, false. O padrão é true. |
Cpu |
Um objeto ApplicationPoolProcessorSettings que contém as configurações de CPU para um pool de aplicativos. |
Enable32BitAppOnWin64 |
Um valor boolean de leitura/gravação. true se os aplicativos de 32 bits (gerenciados e nativos) puderem executar em versões de 64 bits do Windows, caso contrário, false. O padrão é false. |
Failure |
Um objeto ApplicationPoolFailureSettings que define as propriedades que determinam quais ações executarão quando um pool de aplicativos ou processo de trabalho falhar. |
ManagedPipelineMode |
Um valor sint32 de leitura/gravação que indica o modo de pipeline gerenciado. Os valores possíveis estão listados na seção Comentários. |
ManagedRuntimeVersion |
Um valor string de leitura/gravação contendo a versão do CLR (Common Language Runtime) que o pool de aplicativos pré-carrega. O padrão é "v2.0". Se a propriedade for gravada, os Serviços de Informações da Internet reciclarão o pool de aplicativos e carregarão a versão recém-especificada do .NET Framework para ele. |
Name |
Um valor string somente leitura que contém o nome exclusivo do pool de aplicativos. A propriedade de chave. O tamanho máximo é de 64 caracteres. Espaços e pontos são permitidos, mas não é possível utilizar os seguintes caracteres:& / \ : * ? | " <> [ ] + = ; , @ |
PassAnonymousToken |
Um valor boolean de leitura/gravação. true se o WAS (Serviço de Ativação de Processos do Windows) criar e passar um token para a conta de usuário anônimo IUSR interna para o Módulo de autenticação anônima, caso contrário, false. O padrão é true.O Módulo de autenticação anônima usa o token para representar a conta interna. Quando PassAnonymousToken for false,, o token não será aprovado. Anotação: a conta de usuário anônimo IUSR substitui a conta anônima IIS_MachineName. A conta IUSR poderá ser utilizada pelos Serviços de Informações da Internet ou outros aplicativos. Não há privilégios atribuídos durante a configuração. |
ProcessModel |
Um objeto ProcessModelSettings que define o conjunto de configurações para os processos de trabalho dos Serviços de Informações da Internet. |
QueueLength |
Um valor uint32 de leitura/gravação que indica o número de solicitações que o HTTP.sys colocará na fila para um pool de aplicativos antes de rejeitar outras solicitações. O padrão é 1000. Quando o limite exceder, o HTTP.sys rejeitará as solicitações adicionais com um erro 503 (serviço indisponível). |
Recycling |
Um objeto RecyclingSettings que define o conjunto de configurações de reciclagem para pools de aplicativos e processos de trabalho. |
Subclasses
Essa classe não contém subclasses.
Comentários
Um pool de aplicativos é um grupo de uma ou mais URLs atendidas por um processo de trabalho ou um conjunto de processos de trabalho. Os pools de aplicativos definem os limites para os aplicativos que eles contêm, isso significa que todos os aplicativos que executarem fora de um pool de aplicativos especificado não poderão afetar os aplicativos dentro desse pool de aplicativos.
Se um aplicativo gerenciado executar em um pool de aplicativos com o modo Integrado, o servidor usará os pipelines integrados de processamento de solicitação dos Serviços de Informações da Internet e do ASP.NET para processar a solicitação. No entanto, se um aplicativo gerenciado executar em um pool de aplicativos com o modo ISAPI, o servidor continuará roteando as solicitações de código gerenciado por meio de Aspnet_isapi.dll e processará as solicitações como se estivessem executando no IIS 6.0.
A maioria dos aplicativos gerenciados deve executar com êxito em pools de aplicativos com o Modo integrado mas, por motivos de compatibilidade, talvez seja necessário executar os aplicativos em modo ISAPI. Primeiro teste os aplicativos em Modo integrado para determinar se você realmente precisará do modo ISAPI.
A tabela a seguir lista os possíveis valores da propriedade ManagedPipelineMode. O padrão é 0 (Integrated).
| Valor | Palavra-chave | Descrição |
|---|---|---|
| 0 | Integrated |
O pipeline gerenciado executa em Modo integrado. |
| 1 | Classic |
O pipeline gerenciado executa em modo ISAPI. |
Exemplo
O exemplo a seguir exibe o nome e o modo (Integrado ou ISAPI) dos pools de aplicativos em um servidor.
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Retrieve the application pools on the server.
Set oAppPools = oWebAdmin.ExecQuery("SELECT * FROM ApplicationPool")
For Each oAppPool In oAppPools
WScript.Echo "--------------------------------------"
WScript.Echo "Application pool name: " & oAppPool.Name
If oAppPool.ManagedPipelineMode = 0 Then
sAppPoolMode = "Integrated"
ElseIf oAppPool.ManagedPipelineMode = 1 Then
sAppPoolMode = "ISAPI"
End if
WScript.Echo "Application pool mode: " & sAppPoolMode
Next
Hierarquia de herança
Application Pool
Requisitos
| Tipo | Descrição |
|---|---|
| Cliente | – IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10 |
| Servidor | – IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016 |
| Product | – IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| Arquivo MOF | WebAdministration.mof |