Compartilhar via


Classe1 de Aplicativo

Representa um aplicativo Web do IIS.

Sintaxe

class Application : ConfiguredObject  

Métodos

A tabela a seguir lista os métodos expostos pela classe Application.

Nome Descrição
Criar Cria um aplicativo Web.
GetSection (Herdado de ConfiguredObject.)
GetAllSections (Herdado de ConfiguredObject.)
RevertToParent Reverte o valor ou os valores de configuração de um aplicativo para o padrão.

Propriedades

A tabela a seguir lista as propriedades expostas pela classe Application.

Nome Descrição
ApplicationPool Um valor de leitura/gravação string que especifica um nome que diferencia maiúsculas de minúsculas para o pool de aplicativos de um aplicativo. O padrão é "DefaultAppPool".
EnabledProtocols Uma matriz de leitura/gravação string que especifica os protocolos que as solicitações podem usar para acessar um aplicativo. Um valor de "HTTP" ou "HTTPS" habilita HTTP e HTTPS. Se nem "HTTP" nem "HTTPS" for especificado, nenhum deles será habilitado para o aplicativo. O padrão é "HTTP". Para aceitar apenas solicitações HTTPS, configure o recurso de SSL (protocolo SSL) para o site.
Path Um valor string somente leitura que especifica o caminho virtual do aplicativo após o cabeçalho do host. Por exemplo, caso tenha um aplicativo em http://www.alpineskihouse.com/Skis/Downhill, a propriedade Path será /Skis/Downhill. Uma propriedade chave.
SiteName Um valor string somente leitura que especifica o nome exclusivo do site. Uma propriedade chave.
VirtualDirectoryDefaults Um objeto VirtualDirectoryElementDefaults cujas propriedades de leitura/gravação especificam valores padrão para diretórios virtuais no aplicativo.

Subclasses

Essa classe não contém subclasses.

Comentários

Um aplicativo Web é um agrupamento de conteúdo no nível raiz de um site da Web ou um agrupamento de conteúdo em uma pasta separada abaixo do diretório raiz do site da Web. A classe Application permite especificar propriedades específicas para um aplicativo específico, como o pool de aplicativos no qual o aplicativo será executado.

Exemplo

O exemplo a seguir atribui o aplicativo Northwind a um pool de aplicativos chamado NewAppPool.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Retrieve the application and display its Web site name and path.  
Set oApp = oWebAdmin.Get(_   
"Application.SiteName='Default Web Site',Path='/Northwind'")  
WScript.Echo "Web site and path: '" & oApp.SiteName & oApp.Path & "'"  
WScript.Echo "Old application pool: " & oApp. ApplicationPool  
  
' Specify a new application pool name and save it.  
' Note that the name is case-sensitive.  
oApp.ApplicationPool = "NewAppPool"  
oApp.Put_  
  
' Display the new application pool name.  
WScript.Echo "New application pool: " & oApp.ApplicationPool  

Observação

O nome do pool de aplicativos diferencia maiúsculas de minúsculas.

O IIS não verifica se o pool de aplicativos especificado realmente existe. Se o pool de aplicativos não existir, o usuário receberá um erro HTTP 403.18 com a mensagem "A solicitação especificada não pode ser executada no pool de aplicativos configurado para esse recurso no servidor Web".

Para definir o pool de aplicativos padrão para todos os aplicativos em um site, use a propriedade ApplicationDefaults da classe doSite.

Hierarquia de herança

ConfiguredObject

Application

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

Confira também

Classe ApplicationElementDefaults
Classe ConfiguredObject
Classe de Site
Classe VirtualDirectoryElementDefaults