TÓPICO about_Language_Keywords DESCRIÇÃO RESUMIDA Descreve as palavras-chave na linguagem de scripts do Windows PowerShell. DESCRIÇÃO LONGA O Windows PowerShell tem as seguintes palavras-chave de linguagem. Para obter mais informações, consulte o tópico sobre palavras-chave e as informações apresentadas nesta tabela. Palavra-chave Referência ------- --------- Begin about_Functions, about_Functions_Advanced Break about_Break, about_Trap Catch about_Try_Catch_Finally Continue about_Continue, about_Trap Data about_Data_Sections Do about_Do, about_While Dynamicparam about_Functions_Advanced_Parameters Else about_If Elseif about_If End about_Functions, about_Functions_Advanced_Methods Exit Descrito neste tópico. Filter about_Functions Finally about_Try_Catch_Finally For about_For Foreach about_Foreach From Reservado para uso futuro. Function about_Functions, about_Functions_Advanced If about_If In about_Foreach Param about_Functions Process about_Functions, about_Functions_Advanced Return about_Return Switch about_Switch Throw about_Throw, about_Functions_Advanced_Methods Trap about_Trap, about_Break, about_Try_Catch_Finally Try about_Try_Catch_Finally Until about_Do While about_While, about_Do Palavras-chave de linguagem Begin ----- Especifique uma parte do corpo de uma função, junto com as palavras-chave Dynamicparam, Process e End. A lista de instrução Begin é executada uma vez antes do recebimento de qualquer objeto do pipeline. Sintaxe: function <nome> { dynamicparam {<lista de instruções>} begin {<lista de instruções>} process {<lista de instruções>} end {<lista de instruções>} } Break ----- Faz com que um script saia de um loop. Sintaxe: while (<condição>) { <instruções> ... break ... <instruções> } Catch ----- Especifica uma lista de instrução a ser executada se ocorrer um erro na lista de instrução Try fornecida. Um tipo de erro requer colchetes. O segundo par de colchetes indica que o tipo de erro é opcional. Sintaxe: try {<lista de instruções>} catch [[<tipo de erro>]] {<lista de instruções>} Continue -------- Faz com que um script pare de executar um loop e volte para a condição. Se a condição for atendida, o script inicia o loop novamente. Sintaxe: while (<condição>) { <instruções> ... continue ... <instruções> } Data ---- Em um script, define uma seção que isola os dados de uma lógica de script. Também pode incluir instruções If e alguns comandos limitados. Sintaxe: data <variável> [-supportedCommand <nome-do-cmdlet>] {<conteúdo permitido>} Do -- Usado com a palavra-chave While ou Until como uma construção de loop. O Windows PowerShell executa a lista de instruções pelo menos uma vez, diferentemente de um loop que usa While. Sintaxe: do {<lista de instruções>} while (<condição>) do {<lista de instruções>} until (<condição>) Dynamicparam ------------ Especifica uma parte do corpo de uma função, junto com as palavras-chave Begin, Process e End. Os parâmetros dinâmicos são adicionados no tempo de execução. Sintaxe: function <nome> { dynamicparam {<lista de instruções>} begin {<lista de instruções>} process {<lista de instruções>} end {<lista de instruções>} } Else ---- Usado com a palavra-chave If para especificar a lista de instrução padrão. Sintaxe: if (<condição>) {<lista de instruções>} else {<lista de instruções>} Elseif ------ Usado com as palavras-chave If e Else para especificar outros condicionais. A palavra-chave Else é opcional. Sintaxe: if (<condição>) {<lista de instruções>} elseif (<condição>) {<lista de instruções>} else {<lista de instruções>} End --- Especifique uma parte do corpo de uma função, junto com as palavras-chave Dynamicparam, Begin e End. A lista de instruções End é executada uma vez depois que todos os objetos forem recebidos do pipeline. Sintaxe: function <nome> { dynamicparam {<lista de instruções>} begin {<lista de instruções>} process {<lista de instruções>} end {<lista de instruções>} } Exit ---- Faz com que o Windows PowerShell saia de um script ou uma instância do Windows PowerShell. Sintaxe: exit Filter ------ Especifica uma função na qual a lista de instruções é executada uma vez para cada objeto de entrada. Ele tem o mesmo efeito que uma função que contém somente um bloco Process. Sintaxe: filter <nome> {<lista de instruções>} Finally ------- Define uma lista de instruções que é executada depois que as instruções são associadas a Try e Catch. Uma lista de instruções Finally é executada mesmo se você pressionar CTRL+C para sair de um script ou se você usar a palavra-chave Exit no script. Sintaxe: try {<lista de instruções>} catch [<error type] {<lista de instruções>} finally {<lista de instruções>} For --- Define um loop utilizando uma condição. Sintaxe: for (<inicializar>; <condição>; <iterar>) {<lista de instruções>} Foreach ------- Define um loop utilizando cada membro de uma coleção. Sintaxe: foreach (<item> in <coleção>){<lista de instruções>} From ----- Reservado para uso futuro. Function -------- Cria uma lista de instruções nomeada de código reutilizável. Você pode nomear o escopo ao qual uma função pertence. Você também pode especificar um ou mais parâmetros nomeados utilizando a palavra-chave Param. Com a lista de instruções da função, você pode incluir as listas de instrução Dynamicparam, Begin, Process e End. Sintaxe: function [<scope:>]<name> { param ([type]<$pname1> [, [type]<$pname2>]) dynamicparam {<statement list>} begin {<statement list>} process {<statement list>} end {<statement list>} } Você também tem a opção de definir um ou mais parâmetros fora da lista de instruções depois do nome da função. Sintaxe: function [<scope:>]<name> [([type]<$pname1>, [[type]<$pname2>])] { dynamicparam {<statement list>} begin {<statement list>} process {<statement list>} end {<statement list>} } If -- Define uma condicional. Sintaxe: if (<condição>) {<lista de instruções>} In -- Usado em uma instrução Foreach para criar um loop que usa cada membro de uma coleção. Sintaxe: foreach (<item> in <coleção>){<lista de instruções>} Param ----- Define os parâmetros em uma função. Sintaxe: function [<scope:>]<name> { param ([type]<$pname1>[, [[type]<$pname2>]]) <statement list> } Process ------- Especifique uma parte do corpo de uma função, junto com as palavras-chave Dynamicparam, Begin e End. Quando uma lista de instruções Process recebe uma entrada do pipeline, ela é executada uma vez para cada elemento do pipeline. Se o pipeline não fornecer nenhum objeto, a lista de instruções Process não será executada. Se o comando for o primeiro comando no pipeline, a lista de instruções Process será executada uma vez. Sintaxe: function <nome> { dynamicparam {<lista de instruções>} begin {<lista de instruções>} process {<lista de instruções>} end {<lista de instruções>} } Return ------ Faz com que o Windows PowerShell saia do escopo atual, como um script ou uma função e grava a expressão opcional na saída. Sintaxe: return [<expressão>] Switch ------ Especifica uma variedade de ações a ser executada em itens a partir do pipeline ou de um arquivo. Você pode usar um dos seguintes modelos de sintaxe. Sintaxe 1: switch [-regex|-wildcard|-exact][-casesensitive] ( pipeline ) { <cadeia de caracteres>|<número>|<variável>|{<expressão> } {<lista de instruções>} <cadeia de caracteres>|<número>|<variável>|{<expressão> } {<lista de instruções>} ... default {<lista de instruções>} } Sintaxe 2: switch [-regex|-wildcard|-exact][-casesensitive] -file filename { <cadeia de caracteres>|<número>|<variável>|{<expressão> } {<lista de instruções>} <cadeia de caracteres>|<número>|<variável>|{<expressão> } {<lista de instruções>} ... default {<lista de instruções>} } Throw ----- Lança um objeto como um erro. Sintaxe: throw [<objeto>] Trap ---- Define uma lista de instruções para ser executada se um erro for encontrado. Um tipo de erro requer colchetes. O segundo par de colchetes indica que o tipo de erro é opcional. Sintaxe: trap [[<tipo de erro>]] {<lista de instruções>} Try --- Define uma lista de instruções a serem verificadas quanto a erros enquanto as instruções são executadas. Se ocorrer um erro, o Windows PowerShell continua em execução em uma instrução Catch ou Finally. Um tipo de erro requer colchetes. O segundo par de colchetes indica que o tipo de erro é opcional. Sintaxe: try {<lista de instruções>} catch [[<tipo de erro>]] {<lista de instruções>} finally {<lista de instruções>} Until ----- Usado em uma instrução Do como uma construção de loop em que a lista de instruções é executada pelo menos uma vez. Sintaxe: do {<lista de instruções>} until (<condição>) While ----- Usado em uma instrução Do como uma construção de loop em que a lista de instruções é executada pelo menos uma vez. Sintaxe: do {<lista de instruções>} while (<condição>) CONSULTE TAMBÉM about_escape_characters about_special_characters about_wildcards