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

  1. 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”.

  2. Digite um número na caixa de texto e clique em OK. O comando start-sleep será executado pelo número especificado de segundos.

  3. 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

  1. No Painel de Script, abra um novo arquivo de script e digite as linhas a seguir. 

    $var1 = 1
$var2 = 2
$var3 = 3
clear-variable
    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 clear-variable. No entanto, Name é um parâmetro de matriz, então a solicitação será feita com "Name[0]".

  2. 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.

  3. 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
  4. 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



Sumário