Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Appcmd.exe (IIS 8)

 

Aplica-se a: Windows Server 2012 R2, Windows Server 2012

IIS 8 Fornece uma ferramenta de linha de comando, Appcmd.exe, para configurar e consultar objetos no servidor web e para retornar a saída em texto ou XML. Os exemplos a seguir são tarefas que você pode executar com Appcmd.exe:

  • Criar e configurar sites, aplicativos, pools de aplicativos e diretórios virtuais.

  • Iniciar e parar sites.

  • Iniciar, parar e Reciclar pools de aplicativos.

  • Exibir informações sobre processos de trabalho e solicitações em execução no servidor web.

Appcmd.exe fornece comandos consistentes para consultas comuns e tarefas de configuração, o que reduz a complexidade da sintaxe de aprendizado. Por exemplo, você pode usar o lista comando para procurar informações sobre um objeto, como um aplicativo, ou você pode usar o Adicionar comando para criar um objeto, como um site.

Além disso, você pode combinar comandos juntos para retornar dados mais complexos sobre objetos em seu servidor web ou para executar tarefas mais complexas. Por exemplo, você pode concluir tarefas complexas como parar todos os sites que têm solicitações executando mais de 60 segundos.

Neste documento

Abra Appcmd.exe se você deseja configurar IIS 8 configurações usando uma janela do shell de comando.Appcmd.exe reside no diretório %windir%\system32\inetsrv, que está disponível somente para a conta de administrador ou a usuários que são membros do grupo Administradores no computador. Além disso, os membros do grupo Administradores devem iniciar Appcmd.exe com permissões elevadas para exibir e alterar as configurações nos arquivos de configuração de nível de servidor: Machine. config, o arquivo Web. config de raiz (no diretório do .NET Framework) e em applicationHost. config. Os usuários que exibir ou alterem os arquivos Web. config em diretórios de site ou aplicativo devem ter acesso para ler e gravar arquivos nesses diretórios.

System_CAPS_noteObservação

Se você estiver executando o Windows de 64 bits, use Appcmd.exe no diretório %windir%\system32\inetsrv, não no diretório %windir%\syswow64\inetsrv.

Para iniciar o Appcmd.exe

  1. Clique em Iniciar, e, em seguida, clique em todos os programas.

  2. Clique em Acessórios, e, em seguida, clique em Prompt de comando.

  3. No Prompt de comando, digite cd %windir%\system32\inetsrv, e pressione ENTER.

System_CAPS_noteObservação

Para executar o Prompt de comando como administrador, clique no ícone no Iniciar menu e clique Executar como administrador.

Appcmd.exe contém informações de Ajuda interna. Para exibir informações de ajuda sobre Appcmd.exe, digite um comando e, em seguida, digite /?.

Por exemplo, se você deseja exibir informações de ajuda introdutória sobre Appcmd.exe, digite o seguinte comando no prompt de comando e pressione ENTER:

appcmd /?

Para exibir informações de ajuda sobre um determinado Appcmd.exe objeto, como os comandos que você pode usar com o site do objeto, digite o seguinte comando no prompt de comando e pressione ENTER:

site appcmd /?

Para exibir informações de ajuda sobre as configurações que podem ser configuradas usando um Appcmd.exe objeto e o comando, como o site objeto e Adicionar de comando, digite o seguinte no prompt de comando e pressione ENTER:

appcmd Adicionar site /?

Usar objetos em Appcmd.exe para especificar o que você deseja exibir ou alterar a configuração. Para exibir uma lista de Appcmd.exe objetos, digite o seguinte comando no prompt de comando e pressione ENTER:

appcmd /?

Você pode configurar o objeto usando comandos. Para obter mais informações sobre comandos, consulte Trabalhar com os comandos Appcmd.exe.

Use Appcmd.exe comandos para exibir ou alterar as definições de configuração para um Appcmd.exe objeto. Cada um desses objetos possui comandos que permitem trabalhar com esse objeto. Para exibir os comandos de um objeto, use a seguinte sintaxe:

appcmd Object /?

A variável objeto é o nome do objeto para o qual você deseja exibir comandos. Por exemplo, para exibir uma lista de comandos para o site do objeto, digite o seguinte comando no prompt de comando e pressione ENTER:

site appcmd /?

Para obter mais informações sobre Appcmd.exe objetos, consulte Trabalhando com objetos em Appcmd.exe.

Especifique valores para atributos quando desejar limitar os resultados de um comando de lista, ou quando você deseja alterar o valor de um atributo para um Appcmd.exe objeto.

Por exemplo, para listar os pools de aplicativos configurados para usar o serviço de rede, digite o seguinte comando no prompt de comando e pressione ENTER:

appcmd lista apppool /processModel.identityType:NetworkService

Como alternativa, para configurar um pool de aplicativos denominado Marketing para usar o serviço de rede, digite o seguinte comando no prompt de comando e pressione ENTER:

appcmd definir apppool /apppool.name:Marketing /processModel.identityType:NetworkService

O processModel.identityType atributo é usado em ambos os exemplos anteriores. No primeiro exemplo, o atributo limita os resultados da consulta, listando apenas os pools de aplicativos que são configurados para usar o serviço de rede. No segundo exemplo, o atributo especifica que o pool de aplicativos de Marketing usar a identidade do serviço de rede.

No Windows 8 e Windows Server 2012, o AppHostConfig atributo foi adicionado. O AppHostConfig atributo permite que você edite um arquivo de configuração AppHost que não é o arquivo de configuração padrão AppHost. Embora esse atributo é útil em muitas situações, valores inválidos são ignorados sob as seguintes combinações de verbo e objeto:

Verb

Object

Iniciar ou interromper

Site

Iniciar, parar, ou reciclar

AppPool

Todos os verbos

Backup

Todos os verbos

Solicitação

Todos os verbos

WP

Em IIS 8, você pode definir configurações em arquivos de configuração de nível de servidor ou em arquivos Web. config que estão em uma pasta para um site, aplicativo ou diretório virtual. Arquivos de configuração de nível de servidor são Machine. config, o arquivo Web. config de raiz e applicationHost. config. Esses três arquivos estão disponíveis apenas para a conta de administrador ou a usuários que são membros do grupo Administradores no servidor web. Além disso, os membros do grupo Administradores devem abrir uma janela do shell de comando que usa as permissões de administrador elevadas para ler e alterar as configurações nos arquivos de configuração de nível de servidor. Para obter mais informações sobre como iniciar Appcmd.exe em uma janela do shell de comando que usa as permissões de administrador elevadas, consulte Iniciar Appcmd.exe.

Por padrão, o applicationHost. config é o arquivo do qual Appcmd.exe lê a configuração e à qual Appcmd.exe grava as alterações. Quando você deseja ler incluem alterações de ou gravar em Machine. config ou o arquivo Web. config de raiz, um commit em seu comando. Especifique a máquina para o commit parâmetro quando você deseja afetar o arquivo Machine. config ou especificar WEBROOT quando você deseja afetar o arquivo Web. config de raiz.

Por exemplo, para listar a seção machineKey no arquivo Web. config de raiz, digite o seguinte comando no prompt de comando e pressione ENTER:

appcmd lista config /section:machineKey /commit:WEBROOT

Em IIS 8, você pode configurar as configurações nos arquivos de configuração de nível de servidor nos arquivos Web. config para um site, aplicativo ou diretório virtual no servidor web. Os usuários que exibir ou alterar configurações nos arquivos Web. config em diretórios de site ou aplicativo devem ter de leitura e gravação acesso aos arquivos nesses diretórios. Além disso, você deve delegar recursos que você deseja configurar no site, aplicativo ou nível de diretório virtual em IIS 8. Para obter mais informações sobre arquivos de configuração e os recursos de delegação, consulte Trabalhando com arquivos de configuração no IIS 7.0 e Site de delegado e gerenciamento de aplicativos Web.

Quando você usa Appcmd.exe para definir configurações em um arquivo Web. config para um site específico, o aplicativo ou o diretório virtual, especifique o caminho do site, aplicativo ou para o qual você deseja aplicar a configuração de diretório virtual. Por exemplo desabilitar o recurso de documento padrão para um site da web denominado Contoso, digite o seguinte comando no prompt de comando e pressione ENTER:

appcmd set config"Contoso"/section:defaultDocument / habilitado: false

No exemplo anterior, as alterações de configuração são feitas no arquivo Web. config no Contoso diretório e todos os Contoso aplicativos e diretórios virtuais herdarão a configuração do arquivo Web. config. No entanto, se você deseja habilitar os documentos padrão para um aplicativo específico no Contoso site, você pode usar Appcmd.exe para fornecer o caminho do aplicativo. Por exemplo, para habilitar padrão de documentos para um aplicativo chamado galeria, digite o seguinte comando no prompt de comando e pressione ENTER:

appcmd set config"Contoso/Galeria"/section:defaultDocument / habilitado: true

O comando no exemplo anterior permite que os documentos padrão para o galeria aplicativo o Contoso site e grava as alterações de configuração para o arquivo Web. config em da galeria directory.

A seção anterior explicou como usar Appcmd.exe para configurar os recursos para um site específico, o aplicativo ou o diretório virtual gravando alterações em um arquivo Web. config. Você também pode configurar recursos para um site específico, um aplicativo, um diretório virtual ou até mesmo uma URL, usando marcas de localização em um arquivo de configuração pai.

Quando você deseja definir configurações para um site, aplicativo ou diretório virtual, mas você deseja armazenar as configurações em um arquivo de configuração pai, como em applicationHost. config em vez de em um arquivo Web. config, usar o Appcmd.exe confirmação parâmetro com o comando.  Usando os exemplos na seção anterior, você pode agora gravar as alterações de configuração applicationHost. config em vez dos arquivos de sites e aplicativos Web. config.

Primeiro, desativar documentos padrão para o site chamado Contoso, digite o seguinte comando no prompt de comando e pressione ENTER:

appcmd set config"Contoso"/section:defaultDocument / habilitado: /commit:APPHOST false

O comando anterior desabilita os documentos padrão para o Contoso site e grava as definições de configuração com um local de marca applicationHost. config. A marca local Especifica que a configuração se aplica para o Contoso site. A seção de configuração é semelhante ao exemplo a seguir:

<location path="Contoso">
      <system.webServer>
            <defaultDocument enabled="false" />
      </system.webServer>
</location>

Segundo, para habilitar os documentos padrão para o aplicativo chamado galeria, digite o seguinte comando no prompt de comando e pressione ENTER:

appcmd set config"Contoso/Galeria"/section:defaultDocument / habilitado: true /commit:APPHOST

O comando anterior permite que os documentos padrão para o galeria aplicativo e grava as definições de configuração com um local de marca applicationHost. config. A marca local Especifica que a configuração se aplica para o galeria aplicativo. A seção de configuração é semelhante ao exemplo a seguir:

<location path="Contoso/Gallery">
      <system.webServer>
            <defaultDocument enabled="true" />
      </system.webServer>
</location>
Mostrar: