Como gravar e executar scripts no ISE do Windows PowerShell
Este artigo descreve como criar, editar, executar e salvar scripts no Painel de Script.
Como criar e executar scripts
Você pode abrir e editar arquivos do Windows PowerShell no Painel de Script. Tipos de arquivos 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 por 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.
Observação
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, Restricted, impede a execução de todos os scripts e impede o carregamento dos perfis. Para alterar a política de execução para permitir que os perfis sejam carregados 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 atual do PowerShell. Lembre-se de que as guias do PowerShell só ficam visíveis quando há mais de uma. Por padrão, um arquivo de script de tipo (.ps1
) é criado, mas pode ser salvo com um novo nome e uma 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 você deseja abrir. O arquivo aberto aparece em uma nova guia.
Para fechar uma guia de script
Clique no ícone Fechar (X) da guia de arquivo que você quer fechar ou escolha o menu Arquivo e clique em Fechar.
Se o arquivo tiver sido alterado desde que foi salvo pela última vez, você precisará 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 é exibido 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
- No Painel de Script, selecione uma parte de um script.
- No menu Arquivo, clique em Executar Seleção ou, na barra de ferramentas, clique em Executar Seleção.
Para interromper um script em execução
Há várias maneiras para interromper 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; nesse caso, CTRL+C é mapeado para a função de cópia do texto selecionado.
Como gravar e editar texto no Painel de Script
Você pode copiar, recortar, colar, localizar e substituir texto no Painel de Script. Você também pode desfazer e refazer a última ação que você 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
- Mova o cursor para o Painel de Script clicando em qualquer lugar no Painel de Script ou clicando em Ir para o Painel de Script no menu Exibição.
- Crie um script. A coloração de sintaxe e o preenchimento com tabulação fornece uma experiência mais avançada de edição no ISE do Windows PowerShell.
- Consulte Como usar o preenchimento com Tab no Painel de Script e no Painel de Console para obter detalhes sobre como usar o recurso de preenchimento com Tab para ajudar na digitação.
Para localizar texto no Painel de Script
- Para localizar texto em qualquer lugar, pressione CTRL+F ou, no menu Editar, clique em Localizar no Script.
- Para localizar texto após o cursor, pressione F3 ou, no menu Editar, clique em Localizar Próximo no Script.
- Para localizar o texto antes do cursor, pressione 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. Insira o texto que você deseja localizar e o texto de substituição, depois pressione Enter.
Para ir para uma determinada linha de texto no Painel de Script
No Painel de Script, pressione CTRL+G ou, no menu Editar, clique em Ir para a Linha.
Insira um número de linha.
Para copiar o texto no Painel de Script
No Painel de Script, selecione o texto que você deseja copiar.
Pressione CTRL+C ou, na barra de ferramentas, clique no ícone Copiar ou, no menu Editar, clique em Copiar.
Para recortar texto no Painel de Script
- No Painel de Script, selecione o texto que você deseja recortar.
- Pressione CTRL+X ou, na barra de ferramentas, clique no ícone Recortar ou, no menu Editar, clique em Recortar.
Para colar o 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 é exibido ao lado do nome do script para marcar um arquivo que não foi salvo desde que ele foi alterado. O asterisco desaparece quando o arquivo é salvo.
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
- No menu Arquivo, clique em Salvar Como. A caixa de diálogo Salvar Como é exibida.
- Na caixa Nome do arquivo, insira um nome para o arquivo.
- Na caixa Salvar como tipo, selecione um tipo de arquivo. Por exemplo, na caixa Salvar como tipo, escolha "Scripts do PowerShell (
*.ps1
)". - Clique em Salvar.
Para salvar um script em codificação ASCII
Por padrão, o ISE do Windows PowerShell salva os novos arquivos de script (.ps1
), arquivos de dados de script (.psd1
) e arquivos de módulo de script (.psm1
) como Unicode (BigEndianUnicode) por padrão. Para salvar um script em outra codificação, como ASCII (ANSI), use os métodos Save ou SaveAs do 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 ISE do Windows PowerShell dá suporte às seguintes opções de codificação: ASCII, BigEndianUnicode, Unicode, UTF32, UTF7, UTF8 e Padrão. O valor da opção Padrão varia de acordo com o sistema.
O ISE do Windows PowerShell não altera a codificação dos arquivos de script quando você usa os comandos Salvar ou Salvar como.