about_Language_Keywords
Breve descrição
Descreve as palavras-chave na linguagem de script do PowerShell.
Descrição longa
O PowerShell tem as seguintes palavras-chave de idioma. Para obter mais informações, consulte o tópico sobre para a palavra-chave e as informações que se seguem à tabela.
As seguintes palavras-chave são usadas pelos fluxos de trabalho do PowerShell:
inlinescript
parallel
sequence
workflow
Os fluxos de trabalho do PowerShell são suportados apenas no PowerShell 5.1. Para obter mais informações sobre fluxos de trabalho, consulte Executando comandos do PowerShell em um fluxo de trabalho.
begin
Especifica uma parte do corpo de uma função, juntamente com as dynamicparam
palavras-chave , process
, e end
. A begin
lista de instruções é executada uma vez antes de qualquer objeto ser recebido do pipeline.
Sintaxe:
function <name> {
dynamicparam {<statement list>}
begin {<statement list>}
process {<statement list>}
end {<statement list>}
}
break
Faz com que um script saia de um loop.
Sintaxe:
while (<condition>) {
<statements>
...
break
...
<statements>
}
catch
Especifica uma lista de instruções a ser executada se ocorrer um erro na lista de instruções que a acompanha try
. Um tipo de erro requer colchetes. O segundo par de colchetes indica que o tipo de erro é opcional.
Sintaxe:
try {<statement list>}
catch [[<error type>]] {<statement list>}
class
Especifica uma nova classe no PowerShell.
Sintaxe:
class <class-name> {
[[hidden] [static] <property-definition> ...]
[<class-name>([argument-list>]) {<constructor-statement-list>} ...]
[[hidden] [static] <method-definition> ...]
}
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 iniciará o loop novamente.
Sintaxe:
while (<condition>) {
<statements>
...
continue
...
<statements>
}
data
Em um script, define uma seção que isola dados da lógica de script. Também pode incluir if
instruções e alguns comandos limitados.
Sintaxe:
data <variable> [-supportedCommand <cmdlet-name>] {<permitted content>}
do
Usado com a while
palavra-chave ou until
como uma construção de looping. O PowerShell executa a lista de instruções pelo menos uma vez, ao contrário de um loop que usa while
o .
Sintaxe para while
:
do {<statement list>} while (<condition>)
Sintaxe para until
:
do {<statement list>} until (<condition>)
dynamicparam
Especifica uma parte do corpo de uma função, juntamente com as begin
palavras-chave , process
, e end
. Parâmetros dinâmicos são adicionados em tempo de execução.
Sintaxe:
function <name> {
dynamicparam {<statement list>}
begin {<statement list>}
process {<statement list>}
end {<statement list>}
}
else
Usado com a if
palavra-chave para especificar a lista de instruções padrão.
Sintaxe:
if (<condition>) {<statement list>}
else {<statement list>}
elseif
Usado com as if
palavras-chave e else
para especificar condicionais adicionais. A else
palavra-chave é opcional.
Sintaxe:
if (<condition>) {<statement list>}
elseif (<condition>) {<statement list>}
else {<statement list>}
end
Especifica uma parte do corpo de uma função, juntamente com as dynamicparam
palavras-chave , begin
, e end
. A end
lista de instruções é executada uma vez depois que todos os objetos foram recebidos do pipeline.
Sintaxe:
function <name> {
dynamicparam {<statement list>}
begin {<statement list>}
process {<statement list>}
end {<statement list>}
}
enum
enum
é usado para declarar uma enumeração; Um tipo distinto que consiste em um conjunto de rótulos nomeados chamado Lista de Enumeradores.
Sintaxe:
enum <enum-name> {
<label> [= <int-value>]
...
}
exit
Faz com que o PowerShell saia de um script ou de uma instância do PowerShell.
Sintaxe:
exit
exit <exitcode>
Quando você usa pwsh
com o parâmetro File , o .ps1
próprio arquivo (script) deve incluir instruções para lidar com quaisquer erros ou exceções que ocorram durante a execução do script. Você só deve usar a exit
instrução para indicar o status pós-execução do script.
No Windows, qualquer número entre [int]::MinValue
e [int]::MaxValue
é permitido.
No Unix, apenas números positivos entre [byte]::MinValue
e [byte]::MaxValue
são permitidos. Um número negativo no intervalo de through -255
é automaticamente traduzido -1
em um número positivo adicionando 256. Por exemplo, -2
é transformado em 254
.
No PowerShell, a exit
instrução define o $LASTEXITCODE
valor da variável. No Shell de Comando do Windows (cmd.exe
), a instrução exit define o valor da variável de %ERRORLEVEL%
ambiente.
Qualquer argumento não numérico ou fora do intervalo específico da plataforma é traduzido para o valor de 0
.
No exemplo a seguir, o usuário define o valor da variável de nível de erro como 4 adicionando exit 4
ao arquivo test.ps1
de script .
C:\scripts\test>type test.ps1
1
2
3
exit 4
C:\scripts\test>pwsh -file ./test.ps1
1
2
3
C:\scripts\test>echo %ERRORLEVEL%
4
Quando você executa pwsh.exe -File <path to a script>
e o arquivo de script termina com um exit
comando, o código de saída é definido como o argumento numérico usado com o exit
comando. Se o script não tiver nenhuma exit
instrução, o código de saída será sempre 0
quando o script for concluído sem erro ou 1
quando o script for encerrado a partir de uma exceção não tratada.
filter
Especifica uma função na qual a lista de instruções é executada uma vez para cada objeto de entrada. Tem o mesmo efeito que uma função que contém apenas um process
bloco.
Sintaxe:
filter <name> {<statement list>}
finally
Define uma lista de instruções que é executada após instruções associadas a try
e catch
. Uma finally
lista de instruções é executada mesmo se você pressionar CTRL+C para deixar um script ou se você usar a exit
palavra-chave no script.
Sintaxe:
try {<statement list>}
catch [<error type>] {<statement list>}
finally {<statement list>}
for
Define um loop com uma condição.
Sintaxe:
for (<initialize>; <condition>; <iterate>) { <statement list> }
foreach
Define um loop usando cada membro de uma coleção.
Sintaxe:
foreach (<item> in <collection>) { <statement list> }
from
Reservado para uso futuro.
function
Cria uma lista de instruções nomeadas 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 usando a param
palavra-chave. Dentro da lista de instruções de função, você pode incluir dynamicparam
, begin
, process
e end
listas de instruções.
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 após o 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 (<condition>) {<statement list>}
hidden
Oculta os membros da classe dos resultados padrão do cmdlet, IntelliSense e resultados de conclusão de Get-Member
guia.
Sintaxe:
hidden [data type] $member_name
in
Usado em uma foreach
instrução para criar um loop que usa cada membro de uma coleção.
Sintaxe:
foreach (<item> in <collection>){<statement list>}
param
Define os parâmetros em uma função.
Sintaxe:
function [<scope:>]<name> {
param ([type]<$pname1>[, [[type]<$pname2>]])
<statement list>
}
process
Especifica uma parte do corpo de uma função, juntamente com as palavras-chave dynamicparam
, begin
, e end
. Quando uma process
lista de instruções recebe entrada do pipeline, a process
lista de instruções é executada uma vez para cada elemento do pipeline. Se o pipeline não fornecer objetos, a process
lista de instruções não será executada. Se o comando for o primeiro comando no pipeline, a lista de instruções será executada process
uma vez.
Sintaxe:
function <name> {
dynamicparam {<statement list>}
begin {<statement list>}
process {<statement list>}
end {<statement list>}
}
return
Faz com que o PowerShell saia do escopo atual, como um script ou função, e grava a expressão opcional na saída.
Sintaxe:
return [<expression>]
static
Especifica a propriedade ou método definido é comum a todas as instâncias da classe na qual é definido.
Consulte class
exemplos de uso.
switch
Para verificar várias condições, use uma switch
instrução. A switch
afirmação equivale a uma série de if
declarações, mas é mais simples.
A switch
instrução lista cada condição e uma ação opcional. Se uma condição for obtida, a ação será executada.
Sintaxe 1:
switch [-regex|-wildcard|-exact][-casesensitive] ( <value> )
{
<string>|<number>|<variable>|{ <expression> } {<statement list>}
<string>|<number>|<variable>|{ <expression> } {<statement list>}
...
default {<statement list>}
}
Sintaxe 2:
switch [-regex|-wildcard|-exact][-casesensitive] -file <filename>
{
<string>|<number>|<variable>|{ <expression> } {<statement list>}
<string>|<number>|<variable>|{ <expression> } {<statement list>}
...
default {<statement list>}
}
throw
Lança um objeto como um erro.
Sintaxe:
throw [<object>]
trap
Define uma lista de instruções a 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 [[<error type>]] {<statement list>}
try
Define uma lista de instruções a ser verificada quanto a erros enquanto as instruções são executadas. Se ocorrer um erro, o PowerShell continuará em execução em uma catch
instrução or finally
. Um tipo de erro requer colchetes. O segundo par de colchetes indica que o tipo de erro é opcional.
Sintaxe:
try {<statement list>}
catch [[<error type>]] {<statement list>}
finally {<statement list>}
until
Usado em uma do
instrução como uma construção de looping onde a lista de instruções é executada pelo menos uma vez.
Sintaxe:
do {<statement list>} until (<condition>)
using
Permite indicar quais namespaces são usados na sessão. Nomes de tipo, classes e membros exigem menos digitação para fazer referência a eles. Você também pode incluir classes de módulos.
Sintaxe do namespace:
using namespace <.Net-namespace>
Sintaxe do módulo:
using module <module-name>
Sintaxe da montagem:
using assembly <.NET-assembly-path>
Para obter mais informações, consulte about_Using.
while
A while
instrução é uma construção de looping onde a condição é testada antes que as instruções sejam executadas. Se a condição for falsa, as instruções não serão executadas.
Sintaxe da instrução:
while (<condition>) {
<statements>
}
Quando usado em uma do
instrução, while
faz parte de uma construção de looping onde a lista de instruções é executada pelo menos uma vez.
do
Sintaxe do loop:
do {<statement list>} while (<condition>)
Consulte também
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários