Partilhar via


Como Escrever e Executar Scripts no ISE do Windows PowerShell

Este artigo descreve como criar, editar, executar e salvar scripts no Painel de Scripts.

Como criar e executar scripts

Você pode abrir e editar arquivos do Windows PowerShell no Painel de Script. Os tipos de arquivo específicos de interesse no Windows PowerShell são arquivos de script (.ps1), arquivos de dados de script (.psd1) e arquivos de módulo de script (.psm1). Esses tipos de arquivo são coloridos pela sintaxe no editor do Painel de Script. Outros tipos de arquivo comuns que você pode abrir no Painel de Script são arquivos de configuração (.ps1xml), arquivos XML e arquivos de texto.

Nota

A política de execução do Windows PowerShell determina se você pode executar scripts e carregar perfis e arquivos de configuração do Windows PowerShell. A política de execução padrão, Restrita, impede que todos os scripts sejam executados e impede o carregamento de perfis. Para alterar a política de execução para permitir que os perfis sejam carregados e usados, consulte Set-ExecutionPolicy e about_Signing.

Para criar um novo arquivo de script

Na barra de ferramentas, clique em Novo ou, no menu Arquivo, clique em Novo. O arquivo criado aparece em uma nova guia de arquivo na guia PowerShell atual. Lembre-se de que as guias do PowerShell só ficam visíveis quando há mais de uma. Por padrão, um arquivo do tipo script (.ps1) é criado, mas pode ser salvo com um novo nome e extensão. Vários arquivos de script podem ser criados na mesma guia do PowerShell.

Para abrir um script existente

Na barra de ferramentas, clique em Abrir ou, no menu Arquivo, clique em Abrir. Na caixa de diálogo Abrir, selecione o arquivo que deseja abrir. O ficheiro aberto aparece num novo separador.

Para fechar uma guia de script

Clique no ícone Fechar (X) do separador ficheiro que pretende fechar ou selecione o menu Ficheiro e clique em Fechar.

Se o arquivo tiver sido alterado desde a última vez que foi salvo, você será solicitado a salvá-lo ou descartá-lo.

Para exibir o caminho do arquivo

Na guia arquivo, aponte para o nome do arquivo. O caminho totalmente qualificado para o arquivo de script aparece em uma dica de ferramenta.

Para executar um script

Na barra de ferramentas, clique em Executar Script ou, no menu Arquivo, clique em Executar.

Para executar uma parte de um script

  1. No Painel de Script, selecione uma parte de um script.
  2. No menu Arquivo, clique em Executar Seleção ou, na barra de ferramentas, clique em Executar Seleção.

Para parar um script em execução

Há várias maneiras de parar um script em execução.

  • Clique em Parar operação na barra de ferramentas
  • Pressione CTRL+BREAK
  • Selecione o menu Arquivo e clique em Parar operação.

Pressionar CTRL+C também funciona, a menos que algum texto esteja selecionado no momento, caso em que CTRL+C mapeia para a função de cópia para o texto selecionado.

Como escrever e editar texto no Painel de Script

Você pode copiar, cortar, colar, localizar e substituir texto no Painel de Script. Você também pode desfazer e refazer a última ação que acabou de executar. Os atalhos de teclado para essas ações são os mesmos usados para todos os aplicativos do Windows.

Para inserir texto no Painel de Script

  1. Mova o cursor para o Painel de Script clicando em qualquer lugar no Painel de Script ou clicando em Ir para Painel de Script no menu Exibir .
  2. Crie um script. A coloração da sintaxe e o preenchimento de guias fornecem uma experiência de edição mais rica no Windows PowerShell ISE.
  3. Consulte Como usar o preenchimento de guias no Painel de Script e no Painel de Console para obter detalhes sobre como usar o recurso de preenchimento de guias para ajudar na digitação.

Para localizar texto no Painel de Script

  1. Para encontrar texto em qualquer lugar, pressione CTRL+F ou, no menu Editar, clique em Localizar no Script.
  2. Para localizar texto após o cursor, prima F3 ou, no menu Editar, clique em Localizar Seguinte no Script.
  3. Para localizar texto antes do cursor, prima SHIFT+F3 ou, no menu Editar, clique em Localizar Anterior no Script.

Para localizar e substituir texto no Painel de Script

Pressione CTRL+H ou, no menu Editar, clique em Substituir no script. Introduza o texto que pretende localizar e o texto de substituição e, em seguida, prima ENTER.

Para ir para uma linha de texto específica no Painel de Script

  1. No Painel de Script, pressione CTRL+G ou, no menu Editar, clique em Ir para Linha.

  2. Insira um número de linha.

Para copiar texto no Painel de Script

  1. No Painel de Script, selecione o texto que deseja copiar.

  2. Pressione CTRL+C ou, na barra de ferramentas, clique no ícone Copiar ou, no menu Editar, clique em Copiar.

Para cortar texto no Painel de Script

  1. No Painel de Script, selecione o texto que deseja cortar.
  2. Pressione CTRL+X ou, na barra de ferramentas, clique no ícone Recortar ou, no menu Editar, clique em Recortar.

Para colar texto no Painel de Script

Pressione CTRL+V ou, na barra de ferramentas, clique no ícone Colar ou, no menu Editar, clique em Colar.

Para desfazer uma ação no Painel de Script

Pressione CTRL+Z ou, na barra de ferramentas, clique no ícone Desfazer ou, no menu Editar, clique em Desfazer.

Para refazer uma ação no Painel de Script

Pressione CTRL+Y ou, na barra de ferramentas, clique no ícone Refazer ou, no menu Editar, clique em Refazer.

Como salvar um script

Um asterisco aparece ao lado do nome do script para marcar um arquivo que não foi salvo desde que foi alterado. O asterisco desaparece quando o ficheiro é guardado.

Para salvar um script

Pressione CTRL+S ou, na barra de ferramentas, clique no ícone Salvar ou, no menu Arquivo, clique em Salvar.

Para salvar e nomear um script

  1. No menu File (Ficheiro), clique em Save As (Guardar Como). A caixa de diálogo Salvar como será exibida.
  2. Na caixa Nome do arquivo, digite um nome para o arquivo.
  3. Na caixa Salvar como tipo, selecione um tipo de arquivo. Por exemplo, na caixa Salvar como tipo , selecione 'Scripts do PowerShell (*.ps1)'.
  4. Clique em Guardar.

Para salvar um script na codificação ASCII

Por padrão, o Windows PowerShell ISE salva novos arquivos de script (.ps1), arquivos de dados de script (.psd1) e arquivos de módulo de script (.psm1) como Unicode (BigEndianUnicode). Para salvar um script em outra codificação, como ASCII (ANSI), use os métodos Save ou SaveAs no objeto $psISE.CurrentFile .

O comando a seguir salva um novo script como MyScript.ps1 com codificação ASCII.

$psISE.CurrentFile.SaveAs("MyScript.ps1", [System.Text.Encoding]::ASCII)

O comando a seguir substitui o arquivo de script atual por um arquivo com o mesmo nome, mas com codificação ASCII.

$psISE.CurrentFile.Save([System.Text.Encoding]::ASCII)

O comando a seguir obtém a codificação do arquivo atual.

$psISE.CurrentFile.encoding

O Windows PowerShell ISE oferece suporte às seguintes opções de codificação: ASCII, BigEndianUnicode, Unicode, UTF32, UTF7, UTF8 e Default. O valor da opção Padrão varia de acordo com o sistema.

O Windows PowerShell ISE não altera a codificação de arquivos de script quando você usa os comandos Salvar ou Salvar como.

Consulte Também