Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Appcmd.exe (IIS 8)

IIS 8 fornece uma ferramenta de linha de comando, Appcmd.exe, para configurar e consultar objetos no servidor web e retornar saída em texto ou XML. Os seguintes exemplos são tarefas que você pode concluir 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 de aprendizado da sintaxe. Por exemplo, você pode usar o comando list para pesquisar informações sobre um objeto, como um aplicativo, ou você pode usar o comando add para criar um objeto, como um site.

Além disso, você pode combinar comandos para retornar dados mais complexos sobre objetos no servidor web ou realizar tarefas mais complexas. Por exemplo, você pode concluir tarefas complexas, como interromper todos os sites que tenham solicitações que têm funcionado por mais de 60 segundos.

Neste documento

Se você deseja configurar o IIS 8 configurações usando uma janela de shell de comando, abra Appcmd.exe. Appcmd.exe reside no diretório %windir%\system32\inetsrv, que está disponível apenas para a conta de administrador ou para os usuários que são membros do grupo Administradores no computador. Além disso, os membros do grupo Administradores devem começar Appcmd.exe com permissões elevadas para exibir e alterar 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 no ApplicationHost. config. Os usuários que exibir ou alterar os arquivos Web. config em diretórios de site ou aplicativo devem ter acesso para ler e gravar arquivos nesses directórios.

JJ635852.note(pt-br,WS.11).gif Nota
Se você estiver executando o Windows de 64 bits, use Appcmd.exe do diretório %windir%\system32\inetsrv, não o diretório %windir%\syswow64\inetsrv..

JJ635852.collapse(pt-br,WS.11).gif Para começar Appcmd.exe

  1. Clique em Iniciare, em seguida, clique em Todos os programas.

  2. Clique em acessóriose, em seguida, clique em Prompt de comando.

  3. No Prompt de comando, digite cd %windir%\system32\inetsrve, em seguida, pressione ENTER.

JJ635852.note(pt-br,WS.11).gif Nota
Para executar o Prompt de comando como administrador, botão direito do mouse no ícone do menu Iniciar e clique em 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 objeto de Appcmd.exe, como os comandos que você pode usar com o objeto do site , digite o seguinte comando no prompt de comando e pressione ENTER:

Appcmd site /?

Para exibir informações de ajuda sobre as configurações que você pode configurar usando um Appcmd.exe objeto de comando, como o comando objeto e Adicionar osite Adicionar o , digite o seguinte no prompt de comando e pressione ENTER:

Appcmd adicionar site /?

Objetos de uso em Appcmd.exe para especificar que você deseja exibir ou alterar a configuração. Para exibir uma lista de objetos Appcmd.exe, 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 trabalhando com comandos em Appcmd.exe.

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

Appcmd objeto /?

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

Appcmd site /?

Para obter mais informações sobre objetos de Appcmd.exe, consulte trabalhando com objetos no Appcmd.exe.

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

Por exemplo, a lista de 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 chamado Marketing para utilizar o serviço de rede, digite o seguinte comando no prompt de comando e pressione ENTER:

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

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

JJ635852.collapse(pt-br,WS.11).gif Erros e o atributo AppHostConfig

No Windows 8 e Windows Server 2012, o AppHostConfig atributo foi adicionado. O AppHostConfig atributo permite que você edite um arquivo de configuração do 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/objeto:

Verbo Objeto

Iniciar ou parar

Site

Iniciar, parar, ou reciclar

AppPool

Todos os verbos

Backup

Todos os verbos

Pedido

Todos os verbos

WP

Em 8 de IIS, você pode configurar as 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 para usuários que são membros do grupo Administradores no servidor web. Além disso, os membros do grupo Administradores devem abrir uma janela de shell de comando que usa suas permissões de administrador elevada 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 o Appcmd.exe em uma janela de shell de comando que usa permissões elevadas de administrador, consulte Iniciar Appcmd.exe.

Por padrão, o applicationHost. config é o arquivo do qual Appcmd.exe lê a configuração e para que Appcmd.exe grava as alterações. Quando você quiser ler as alterações de ou gravar alterações para Machine. config ou o arquivo Web. config de raiz, incluem um parâmetro commit em seu comando. Especifica a máquina para o parâmetro commit 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 raiz, digite o seguinte comando no prompt de comando e pressione ENTER:

Appcmd lista config /section:machineKey /commit: Webroot

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

JJ635852.collapse(pt-br,WS.11).gif Use o Appcmd.exe para alterar a configuração em um arquivo Web. config

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

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

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

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

O comando no exemplo anterior permite que documentos padrão para o aplicativo de Galeria no site Contoso e grava as alterações de configuração para o arquivo Web. config no diretório na Galeria .

JJ635852.collapse(pt-br,WS.11).gif Use Appcmd.exe para alterar a configuração em um arquivo de configuração no nível pai

Seção anterior explicou como usar o Appcmd.exe para configurar recursos para um determinado site, aplicativo ou diretório virtual escrevendo as alterações em um arquivo Web. config. Você também pode configurar os recursos para um site específico, um aplicativo, um diretório virtual ou mesmo um 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 no ApplicationHost. config em vez de um arquivo Web. config, use o parâmetro commit Appcmd.exe com seu comando. Usando os exemplos na seção anterior, você pode agora gravar as alterações de configuração no ApplicationHost. config em vez dos site e aplicativo arquivos Web. config.

Em primeiro lugar, para desabilitar 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 / ativado: false /commit: appHost

O comando anterior desativa documentos padrão para o site da Contoso e grava as definições de configuração com uma marca de localização no ApplicationHost. config. A marca de localização especifica que a configuração se aplica para o site da Contoso . A seção de configuração é semelhante o exemplo a seguir:



< caminho local = "Contoso" >< WebServer >< defaultDocument enabled = "false" / >< /system.webServer >< / local >

Em segundo lugar, para permitir que 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 habilita os documentos padrão para o aplicativo Gallery e grava as definições de configuração com uma marca de localização no ApplicationHost. config. A marca de localização especifica que a configuração se aplica para o aplicativo Gallery . A seção de configuração parece com o exemplo a seguir:



< caminho local = "Contoso/Galeria" >< WebServer >< defaultDocument enabled = "true" / >< /system.webServer >< / localização >

Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft