Diferentes Parâmetros no PowerShell

1. Parâmetros no PowerShell
2. Parâmetros Nomeados
3. Valores Padrão de Parâmetro
4. Parâmetros Switch
5. Parâmetros Obrigatórios
6. Parâmetros de Pipeline

Neste artigo, aprenderemos o que é uma função de parâmetro, diferentes tipos de variáveis que podemos definir em um parâmetro, diferentes tipos de parâmetros e seus usos exemplares.

Parâmetros no PowerShell

Administradores como nós podem criar parâmetros para scripts e funções usando a função de parâmetro param(). O bloco de script do parâmetro contém um ou mais parâmetros significados por variáveis.

Código de Exemplo:

param ($myVariable)

No entanto, para garantir que o parâmetro declarado aceita apenas o tipo de entrada que precisamos, as melhores práticas indicam atribuir um tipo de dado ao parâmetro, envolvendo o tipo de dado com colchetes [] antes da variável.

Código de Exemplo:

param ([String]$myVariable)

Parâmetros Nomeados

Uma maneira de usar parâmetros em um script é através de parâmetros nomeados. Ao chamar uma função ou script por meio de parâmetros nomeados, usamos o nome da variável como o nome completo do parâmetro.

Código de Exemplo:

param ([String]$name)

Podemos então usar os parâmetros nomeados para argumentar ao executar um arquivo .ps1.

Código de Exemplo:

powershell.exe .\sample.ps1 -name "John"

Valores Padrão de Parâmetro

Podemos atribuir um valor a um parâmetro dando ao parâmetro um valor padrão com antecedência dentro do script. Então, ao executar o script sem passar valores para o console, o valor padrão da variável pré-definido dentro do script será utilizado.

Código de Exemplo:

param ([String]$name = "John")

Parâmetros Switch

Outro tipo de parâmetro que podemos usar é o parâmetro switch definido pelo tipo de dado [switch]. O parâmetro switch é usado para valores Booleanos para indicar true ou false.

Código de Exemplo:

param ([switch]$isEnabled)

Parâmetros Obrigatórios

Geralmente, temos um ou mais parâmetros obrigatórios que devem ser usados ao executar um script. Portanto, nosso script pode falhar se não tivermos valores atribuídos a esses parâmetros.

Podemos tornar um parâmetro obrigatório inserindo um tipo de dado Mandatory dentro do bloco de tipo de dado do parâmetro [Parameter()].

Código de Exemplo:

param (
    [Parameter(Mandatory)]
    [String] $servername
)

Se deixado sem valor, o PowerShell não permitirá que o script seja executado e solicitará um valor durante a execução. Vale a pena notar que parâmetros sem o bloco [Parameter(Mandatory)] são considerados parâmetros opcionais.

Parâmetros de Pipeline

A maioria dos cmdlets do PowerShell permite que você use o símbolo pipe (| ) para passar dados. Podemos aproveitar esse recurso do PowerShell ao trabalhar com parâmetros.

Usar esse método abrirá muitas oportunidades para executar arquivos PowerShell encadeados.

Arquivo - pipeline.ps1:

param([parameter(ValueFromPipeline)]$pipedVar)

Write-Output $pipedVar

Código de Exemplo:

"This string is from the pipeline." | .\pipeline.ps1

Saída:

This string is from the pipeline.