Os parâmetros permitem selecionar opções ou fornecer entrada a um cmdlet do Windows PowerShell. Alguns parâmetros são obrigatórios e outros, opcionais. Se você inserir um cmdlet sem especificar seus parâmetros obrigatórios, o Windows PowerShell solicitará que você insira todos os parâmetros obrigatórios. No Console do Windows PowerShell você recebe a solicitação na linha de comando. No Windows PowerShell ISE, aparece uma caixa de diálogo Prompt de Parâmetro que oferece uma funcionalidade paralela ao comportamento interativo do Console do Windows PowerShell. A caixa de diálogo percorre os parâmetros obrigatórios em sequência.
Observação: | |
Um ponto importante de distinção entre a experiência com o Console do Windows PowerShell e com o Windows PowerShell ISE é o modo como um parâmetro de matriz obrigatório é inserido. A caixa de diálogo Prompt de Parâmetro fornece um botão OK que funciona da mesma forma que a tecla ENTER. Depois que você insere um valor para o parâmetro de matriz, quando clica em OK ou pressiona ENTER, é solicitado que forneça o próximo valor. Clicar em OK ou pressionar ENTER sem inserir um valor sinaliza o término da matriz, do mesmo modo que pressionar a tecla ENTER sem inserir um valor sinaliza o término da matriz no Console do Windows PowerShell. Observe que o botão Cancelar na caixa de diálogo Prompt de Parâmetro cancela o comando inteiro, e não o último valor inserido na matriz. Nesse sentido, o botão Cancelar é o oposto de CTRL+C no Console do Windows PowerShell. |
Uso da caixa de diálogo Prompt de Parâmetro
- No Painel de Comando, digite
start-sleep
e pressione ENTER. Você verá a caixa de diálogo Prompt de Parâmetro aparecer. Será solicitado que você forneça um valor para o parâmetro obrigatório “Seconds”. - Digite um número na caixa de texto e clique em OK. O comando start-sleep será executado pelo número especificado de segundos.
- Experimente clicar em Cancelar, em vez de OK, e veja que o comando será cancelado.
Uso da caixa de diálogo Prompt de Parâmetro para inserir um parâmetro de matriz obrigatório
- No Painel de Script, abra um novo arquivo de script e digite as linhas a seguir. Na barra de ferramentas, clique em Executar Script. Você verá a caixa de diálogo Prompt de Parâmetro aparecer, e será solicitado que forneça um valor para o parâmetro obrigatório "Name" do cmdlet
$var1 = 1 $var2 = 2 $var3 = 3 clear-variable
clear-variable
. No entanto, Name é um parâmetro de matriz, então a solicitação será feita com "Name[0]". -
Na caixa de texto Parâmetro, digite "var1" e clique em OK ou pressione ENTER. Será solicitado que você forneça os valores subsequentes da matriz. Quando solicitado com "Name[1]", na caixa de texto Parâmetro, digite "var2" e pressione ENTER. Clique em OK sem inserir um terceiro valor para marcar o término da matriz.
- Em seguida, no Painel de Comando, digite as linhas a seguir para consultar os valores das três variáveis. Os valores de var1 e var2 foram limpos, mas var3 ainda tem seu valor atribuído.
$var1 $var2 $var3
- Experimente clicar em Cancelar, em vez de OK, na caixa de diálogo Prompt de Parâmetro, e veja que o comando será cancelado.
See Also