Instalar o snap-in do PowerShell do IIS 7.0

Artigo
03/12/2024

Introdução

No passo a passo a seguir, você aprenderá a instalar o snap-in do PowerShell do IIS e iniciar o console de gerenciamento do PowerShell do IIS.

Pré-requisitos

O snap-in do PowerShell do IIS requer os seguintes pré-requisitos:

Windows Server 2008, Windows Server 2008 R2, Windows Vista Service Pack 1 ou Windows 7
Microsoft PowerShell 1.0 ou 2.0

Para instalar o snap-in do PowerShell do IIS:

Baixe a versão x86 ou x64 do Snap-in do PowerShell do IIS.
Execute o arquivo MSI para instalar o snap-in do PowerShell do IIS.

Para usar o snap-in do PowerShell do IIS

Os snap-ins do PowerShell, como o snap-in do PowerShell do IIS, precisam ser registrados no PowerShell. Há duas maneiras de fazer isso:

Registro automático usando o console de gerenciamento do PowerShell do IIS

A configuração do snap-in do PowerShell do IIS criará um novo atalho de Menu de Programas. Ao iniciar esse atalho, o snap-in do PowerShell do IIS será registrado automaticamente. Clique no menu Iniciar – selecione "Todos os programas" – "Extensões do IIS 7.0" – "Console de gerenciamento do PowerShell do IIS". O prompt da nova janela de comando do PowerShell é definido como "IIS:" – a raiz do namespace do snap-in do IIS.

Registro manual

Se você quiser usar o snap-in do PowerShell do IIS em uma janela de comando existente do PowerShell, será necessário registrar o snap-in do IIS manualmente. Você pode fazer isso simplesmente executando o arquivo IISConsole.PSC1 localizado no diretório "$env:programfiles\IIS\PowerShellProvider":

PS C:\> & "$env:programfiles\IIS\PowerShellSnapin\iisConsole.psc1"

Uma palavra sobre segurança

Controle de acesso de usuários

Você precisa de privilégios de administrador para gerenciar a configuração do IIS. Isso significa que você precisa executar as janelas de comando do PowerShell com privilégios elevados. Certifique-se de sempre iniciar o PowerShell por meio do item de menu "Executar como administrador".

Políticas de execução do PowerShell

Você pode ver o seguinte erro dependendo das permissões de execução do PowerShell.

Windows PowerShell
Copyright (C) 2006 Microsoft Corporation. All rights reserved.
Do you want to run software from this untrusted publisher?
File C:\Program Files\IIS\PowerShellProvider\iisprovider.types.ps1xml is published by CN=Microsoft
Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US and is not trusted on your
system. Only run scripts from trusted publishers.
[V] Never run  [D] Do not run  [R] Run once  [A] Always run  [?] Help (default is "D"):

Embora os arquivos do provedor do PowerShell do IIS estejam todos assinados, o PowerShell confia apenas em scripts assinados por um "Fornecedor Confiável" quando sua política de execução é definida como "Restrita". Há duas maneiras de corrigir esse problema.

Flexibilizar a política de execução

Se você vir o erro acima, sua política de execução provavelmente será definida como "Restricted". Para confiar em outro código, você pode definir a política de execução como "RemoteSigned", que permite a execução de scripts locais sem a necessidade de uma assinatura digital. Execute o seguinte comando em uma janela com privilégios elevados do PowerShell:

PS C:\> Set-ExecutionPolicy RemoteSigned

Execute o comando a seguir se quiser saber mais sobre políticas de assinatura e execução.

help about_signing

Confiar no certificado de autenticação de código da Microsoft na Lista de Fornecedores Confiáveis

Para confiar nos scripts e binários do provedor do IIS, você pode acessar "A" na caixa de diálogo acima, o que adicionará o certificado de autenticação de código usado pelo snap-in do IIS à lista de Fornecedores Confiáveis. Você pode obter uma lista de "Fornecedores Confiáveis" com o seguinte comando:

dir cert:\CurrentUser\TrustedPublisher | fl

Resumo

Neste passo a passo, você aprendeu a instalar automática ou manualmente o snap-in do PowerShell do IIS.

Compartilhar via