Use o console PowerShell do Windows baseado na Web

Atualizado: 24 de junho de 2013

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

O Windows PowerShell Web Access permite que os usuários façam login em um site seguro; para usar sessões PowerShell do Windows, cmdlets e scripts para gerenciar um computador remoto.

Como o console PowerShell do Windows roda em um navegador web, ele pode ser aberto a partir de uma grande variedade de dispositivos clientes; Quase todos os dispositivos com navegador web funcionam.

O console PowerShell do Windows baseado na web é direcionado a um computador remoto especificado pelos usuários como parte do processo de login.

Este tópico descreve como fazer login e começar a usar o console web Windows PowerShell Web Access.

Este tópico não descreve como usar o PowerShell do Windows ou executar cmdlets ou scripts. Para informações sobre como usar o Windows PowerShell e recursos de script, veja a seção Veja Também ao final deste tópico.

Navegadores e dispositivos clientes suportados

O Windows PowerShell Web Access suporta os seguintes navegadores de Internet. Embora navegadores móveis não sejam oficialmente suportados, muitos podem conseguir rodar o console PowerShell do Windows, baseado na web. Outros navegadores que aceitam cookies, rodam JavaScript e usam sites HTTPS devem funcionar, mas não são oficialmente testados.

Navegadores de computadores desktop suportados

Windows Internet Explorer para Microsoft Windows 8.0, 9.0, 10.0 e 11.0
Mozilla Firefox 10.0.2
Google Chrome 17.0.963.56m para Windows
Apple Safari 5.1.2 para Windows
Apple Safari 5.1.2 para Mac OS

Dispositivos móveis ou navegadores minimamente testados

Windows Phone 7 e 7.5
Google Android WebKit 3.1 Navegador Android 2.2.1 (Kernel 2.6)
Apple Safari para iPhone sistema operacional 5.0.1
Apple Safari para iPad 2 sistema operacional 5.0.1

Requisitos do navegador

Para usar o console web do Windows PowerShell Web Access, os navegadores devem fazer o seguinte.

Permita cookies do site do gateway Windows PowerShell Web Access.
Ser capaz de abrir e ler páginas HTTPS.
Abra e execute sites que usem JavaScript.

Fazendo login no Windows PowerShell Web Access

Seu administrador de acesso ao Web do Windows PowerShell deve fornecer uma URL que seja o endereço do site do gateway Windows PowerShell Web Access da sua organização. Por padrão, o endereço deste site é https://<server_name>/pswa.

Antes de fazer login no Windows PowerShell Web Access, certifique-se de que você tem o nome ou endereço IP do computador remoto que deseja gerenciar. Você deve ser um usuário autorizado no computador remoto, e ele deve estar configurado para permitir o gerenciamento remoto. Para mais informações sobre como configurar seu computador para permitir o gerenciamento remoto, veja Habilitar e Usar Comandos Remotos no Windows PowerShell.

O método mais simples de configurar seu computador para permitir gerenciamento remoto é executar o Enable-PSRemoting -force cmdlet no computador, em uma sessão do Windows PowerShell que tenha sido aberta com direitos elevados de usuário (Executar como Administrador).

Abra o site do Windows PowerShell Web Access em uma janela ou aba do navegador da Internet.
Na página de login do Windows PowerShell Web Access, forneça o nome de usuário da rede, senha e o nome do computador que deseja gerenciar (e no qual você é usuário autorizado). Se o administrador do Windows PowerShell Web Access instruiu você a usar um URI para um site personalizado ou servidor proxy em vez de um nome de computador, selecione URI de Conexão no campo Tipo de Conexão e então forneça o URI.
Observação
- Se o computador de destino estiver em um grupo de trabalho, use a seguinte sintaxe para fornecer seu nome de usuário e fazer login no computador: <workgroup_name>\<user_name>
- Se o computador de destino for o servidor gateway, você pode especificar localhost no campo Nome do Computador
- Se o computador de destino for o servidor gateway e o servidor gateway estiver em um grupo de trabalho, você deve usar <workgroup name>\<user_name> o nome de usuário arquivado. Você pode usar localhost no campo de nome do computador.
A seção Configurações Opcionais de Conexão está relacionada aos requisitos de autorização do computador remoto que você deseja gerenciar. Para mais informações sobre os parâmetros equivalentes às configurações opcionais de conexão, veja a ajuda do cmdlet Enter-PSSession .

Normalmente, as credenciais que você usa para passar pelo gateway do Windows PowerShell Web Access são as mesmas que são reconhecidas pelo computador remoto que você deseja gerenciar. No entanto, se você quiser usar credenciais diferentes para gerenciar o computador remoto que especificou no passo 2, expanda a seção de Configurações Opcionais de Conexão e forneça as credenciais alternativas. Caso contrário, pule para a etapa 6.
Se o administrador do Windows PowerShell Web Access criou uma configuração personalizada de sessão para usuários do Windows PowerShell Web Access, digite o nome da configuração da sessão no campo Nome da Configuração . Para obter mais informações sobre configurações de sessão, consulte about_Session_Configurations.
Mantenha o tipo de Autenticação definido como Padrão , a menos que você tenha sido instruído de outra forma pelo administrador do Windows PowerShell Web Access.
Clique em Entrar.

Desligar e expirar

Qualquer um dos seguintes fatores te tira de uma sessão de Windows PowerShell baseada na web.

Clicando em Sair no canto inferior direito do console. (Apenas Windows Server 2012)
Clicando em Salvar ou Sair no canto inferior direito do console (apenas Windows Server 2012 R2). Clicar em Salvar salva e fecha sua sessão de acesso Web PowerShell do Windows; Você pode se reconectar com a sessão depois. Quando você faz login novamente no Windows PowerShell Web Access, o Windows PowerShell Web Access exibe uma lista das suas sessões salvas; Você pode selecionar e reconectar a uma sessão salva, ou começar uma nova sessão. O número máximo de sessões abertas permitidas aos usuários, tanto salvas quanto ativas, é configurado pelo administrador do gateway.

Clicar em Sair te sinaliza para fora da sessão do Windows PowerShell Web Access sem salvar.
Tentando fazer login para gerenciar um computador remoto diferente na mesma sessão do navegador, ou em uma nova aba da mesma sessão do navegador. (Isso não se aplica se o servidor gateway estiver rodando Windows Server 2012 R2; O Windows PowerShell Web Access rodando no Windows Server 2012 R2 permite múltiplas sessões de usuário em novas abas na mesma sessão do navegador.) Para mais informações sobre como usar mais de uma sessão ativa no mesmo computador, veja Conectando a múltiplos computadores-alvo simultaneamente na seção Limitações do console baseado na web deste tópico.
20 minutos de inatividade na sessão. O administrador do gateway pode personalizar o período de tempo de inatividade; Para mais informações, veja Gerenciamento de Sessões.
- Se você for desconectado de uma sessão no console baseado na web devido a um erro de rede ou outro desligamento ou falha não planejado, e não porque você mesmo fechou a sessão, a sessão do Windows PowerShell Web Access continua rodando, conectada ao computador de destino, até que o período de tempo no lado do cliente expire. Por padrão, esse período de tempo é de 20 minutos e é configurado pelo administrador do gateway. A sessão é desconectada após os 20 minutos padrão ou após o período de tempo especificado pelo administrador do gateway, o que for mais curto.
  
  Se o servidor gateway estiver rodando Windows Server 2012 R2, o Windows PowerShell Web Access permite que os usuários reconectem sessões salvas em um momento posterior, mas você não pode ver ou reconectar as sessões salvas até que o período de tempo especificado pelo administrador do gateway tenha expirado.
Fechar a janela ou aba do navegador.
Desligar o dispositivo cliente no qual o navegador está rodando, ou desconectá-lo da rede.
Executando o comando Sair no console web. Esse comando não funciona se a configuração da sessão à qual você está conectado estiver configurada para suportar o modo NoLanguage , ou estiver em um runspace restrito.

Se quiser fazer login novamente, abra novamente a página web do Windows PowerShell Web Access e faça login seguindo os passos em Login no Windows PowerShell Web Access neste tópico.

Diferenças no console Windows PowerShell baseado na web

Após fazer login no Windows PowerShell Web Access, um console Windows PowerShell baseado na web se abre na janela ou aba do seu navegador. Como o console está conectado ao computador remoto que você especificou durante o processo de login, apenas os cmdlets ou scripts do Windows PowerShell disponíveis no computador remoto podem ser usados no console. Esta seção descreve outras limitações dos consoles Windows PowerShell Web Access e diferenças entre os consoles Windows PowerShell Web Access e o console instaladoPowerShell.exe .

Disparidade funcional com PowerShell.exe

A maior parte da funcionalidade do host do Windows PowerShell está disponível no console web Windows PowerShell Web Access, mas há alguns recursos que não estão disponíveis.

Exibições de progresso aninhadas.

O Windows PowerShell Web Access exibe uma interface gráfica de progresso para cmdlets que reportam o progresso, mas apenas informações de progresso de nível superior são exibidas.
Modificação de cor de entrada.

A cor de entrada (tanto em primeiro plano quanto em fundo) não pode ser alterada. O estilo de saída, aviso, verbo e mensagem de erro podem ser alterados executando um script.
PSHostRawUserInterface.

O Windows PowerShell Web Access é implementado sobre o gerenciamento remoto do Windows PowerShell e utiliza um espaço de execução remoto. O Windows PowerShell Web Access não implementa alguns métodos nessa interface; por exemplo, qualquer comando que escreva no console do Windows. Comandos como PowerTab não funcionam no Windows PowerShell Web Access.
Teclas de função.

O Windows PowerShell Web Access não suporta algumas chaves de função, em muitos casos porque os comandos são reservados pelo navegador.

Teclas de Atalho Não Suportadas

Tecla de função	Ação
Ctrl+C	No Windows PowerShell Web Access, Ctrl+C é usado pelo navegador para copiar conteúdo. O console oferece um botão Cancelar , e os usuários também podem usar Ctrl+Q para cancelar comandos.
Espaço alternativo, e, l	Role pelo buffer da tela
Alt+Espaço, e, f	Procure texto no buffer de tela
Alt+Espaço, e, k	Selecione o texto a ser copiado do buffer de tela
Alt+Espaço, e, p	Cole o conteúdo da prancheta no console PowerShell do Windows
Alt+Espaço, c	Feche o console PowerShell do Windows
Ctrl+Break	Forçar o fechamento da janela PowerShell do Windows
Ctrl+Home	Exclusão do início da linha de comando atual
Ctrl+End	Exclui para o final da linha de comando
F1	Mova o cursor um caractere para a direita na linha de comando
F2	Cria um novo comando copiando seu último comando até o personagem que você digita
F3	Complete a linha de comando com o conteúdo da sua última linha de comando
F4	Exclui caracteres da posição do cursor
F5	Escaneie o histórico de comandos de trás para trás. Para acessar comandos no histórico de comandos no Windows PowerShell Web Access, clique nos botões de rolagem de Histórico no console baseado na web.
F7	Selecione interativamente um comando do seu histórico de comandos
F8	Histórico de varredura exibindo comandos que correspondem ao texto atual
F9	Execute um comando numerado específico a partir do histórico
Página para Cima	Execute o primeiro comando da história
Página para baixo	Execute o último comando da história
Alt+F7	Limpar a lista de histórico de comandos

Limitações do console baseado na web

Duplo salto

Você pode encontrar a limitação do duplo salto (ou conectar a um segundo computador a partir da primeira conexão) se tentar criar ou trabalhar em uma nova sessão usando o Windows PowerShell Web Access. O Windows PowerShell Web Access utiliza um espaço de execução remoto e, atualmente,PowerShell.exe não suporta estabelecer uma conexão remota para um segundo computador a partir de um espaço de execução remoto. Se você tentar se conectar a um segundo computador remoto a partir de uma conexão existente usando o cmdlet Enter-PSSession , por exemplo, pode aparecer vários erros, como €œNão é possível obter recursos de rede.

Para evitar erros de duplo salto, seu administrador deve configurar a autenticação CredSSP no ambiente de rede da sua organização. Para mais informações sobre como configurar a autenticação do CredSSP, veja CredSSP para remotos de segundo salto no blog PowerShell. Você também pode fornecer credenciais explícitas quando quiser gerenciar um segundo computador remoto; credenciais implícitas provavelmente não permitirão o segundo salto.
Comunicação remota

O Windows PowerShell Web Access usa e tem as mesmas limitações de uma sessão remota do Windows PowerShell. Comandos que chamam diretamente APIs de console do Windows, como os de editores baseados em console ou programas de menu baseados em texto, não funcionam porque os comandos não leem ou escrevem em pipelines padrão de entrada, saída e erro. Portanto, comandos que iniciam um arquivo executável, como notepad.exe, ou exibem uma interface gráfica, como OpenGridView ou ogv, não funcionam. Sua experiência é afetada por esse comportamento; para você, parece que o Windows PowerShell Web Access não está respondendo ao seu comando.
Preenchimento de guias

A conclusão de tabulação não funciona em uma configuração de sessão com um espaço de execução restrito ou em modo NoLanguage . Embora os administradores possam configurar uma sessão para suportar a conclusão de abas, ela é desencorajada por razões de segurança, pois pode expor as seguintes informações a usuários não autorizados.
- Caminhos internos do sistema de arquivos
- Pastas compartilhadas em computadores internos
- Variáveis no espaço de execução
- Tipos carregados or.NET namespaces de Framework
- Variáveis de ambiente
Sessão sem linguagem , ou espaço de execução restrito

Usuários que estão logados em uma configuração de sessão sem linguagem ou em um espaço de execução restrito no Windows PowerShell Web Access não podem executar o comando Exit para encerrar a sessão. Para sair da sessão, os usuários devem clicar em Desconectar na página do console.
Conectando-se a múltiplos computadores-alvo simultaneamente.

Se o servidor gateway estiver rodando o Windows Server 2012, o Windows PowerShell Web Access permite apenas uma conexão remota de computador por sessão do navegador; Ele não permite que os usuários façam login uma vez e se conectem a múltiplos computadores remotos usando abas separadas do navegador. Quando você abre uma nova aba ou nova janela do navegador, o Windows PowerShell Web Access solicita que você desconecte sua sessão atual e inicie uma nova sessão, para que você possa se conectar ao novo (ou ao mesmo) computador remoto. Se forem desejadas duas ou mais sessões separadas para computadores remotos diferentes, no entanto, um recurso no Internet Explorer permite criar uma nova sessão. Para iniciar uma nova sessão do navegador no Internet Explorer, pressione ALT, abra o menu Arquivos e então selecione Nova Sessão. Depois, abra o site Windows PowerShell Web Access na nova sessão e faça login para acessar outro computador remoto.

Quando o gateway de acesso Web PowerShell do Windows PowerShell está rodando no Windows Server 2012 R2, os usuários podem abrir múltiplas conexões para computadores remotos em diferentes abas do navegador. Se você quiser abrir mais de uma conexão com um computador remoto usando o console Windows PowerShell baseado na web, verifique com o administrador do gateway Windows PowerShell Web Access se esse recurso é suportado pelo servidor gateway.
Sessões persistentes do Windows PowerShell (Reconexão).

Após você sair do gateway Windows PowerShell Web Access, a conexão remota entre o gateway e o computador alvo é fechada. Isso para qualquer cmdlet ou script que esteja em andamento. Você é incentivado a usar a infraestrutura de Jobs do Windows PowerShell quando estiver realizando tarefas de longa duração, para que possa iniciar jobs, se desconectar do computador, reconectar depois e que os jobs persistam. Outro benefício de usar cmdlets -Job é que você pode iniciá-los usando o Windows PowerShell Web Access, sair e depois reconectar, seja rodando o Windows PowerShell Web Access ou outro host (como o Windows PowerShell Integrated Scripting Environment (ISE)).
Console redimensionando.

A janela do consolePowerShell.exe pode ser redimensionada das seguintes três maneiras.
- Arraste e ajuste o tamanho da janela do console com o mouse
- Mude as propriedades de altura e largura usando uma interface gráfica para as propriedades do console
- Alterando a altura e largura das janelas do console com um cmdlet
  
  A janela do console para o Windows PowerShell Web Access pode ser configurada usando os cmdlets da seguinte forma. No exemplo a seguir, um usuário altera a largura do console do Windows PowerShell Web Access para 20.
```
$newSize = $Host.UI.RawUI.WindowSize
$newSize.Width = $newSize.Width - 20
$oldSize = $Host.UI.RawUI.WindowSize
$Host.UI.RawUI.WindowSize = $newSize
```
  Você pode mudar a altura do console de forma semelhante.
  
  Exemplos adicionais para customizar a visualização do console estão disponíveis no Blog da Equipe do Windows PowerShell.

Consulte Também

Ei, cara do roteiro!

Last updated on 2017-08-23

Compartilhar via