Descubra os parâmetros para usar cmdlets do PowerShell
Os parâmetros modificam as ações executadas por um cmdlet. Você não pode especificar nenhum parâmetro, um parâmetro ou muitos parâmetros para um cmdlet.
Formato do parâmetro
Os nomes dos parâmetros começam com um traço (-). Um espaço separa o valor que você deseja passar do nome do parâmetro. Se o valor que você está passando contiver espaços, você precisará quebrar o texto entre aspas. Alguns parâmetros aceitam vários valores, que você deve separar por vírgulas e sem espaços.
Parâmetros opcionais vs. obrigatórios
Os parâmetros podem ser opcionais ou obrigatórios. Se um parâmetro for necessário e você executar o cmdlet sem fornecer um valor para esse parâmetro, o Windows PowerShell solicitará que você forneça um valor para ele. Por exemplo, se você executar o comando Get-Item, receberá a seguinte mensagem do Windows PowerShell, que inclui um prompt para fornecer um valor para o parâmetro -Path :
PS C:\> Get-Item
cmdlet Get-Item at command pipeline position 1
Supply values for the following parameters:
Path[0]:
Se você digitar o texto C:\ no prompt e pressionar a tecla Enter duas vezes, o comando será executado com êxito. Você deve pressionar a tecla Enter duas vezes porque esse parâmetro pode aceitar vários valores. O Windows PowerShell continua solicitando um novo valor até que você pressione a tecla Enter sem realmente fornecê-la.
Em alguns casos, inserir o nome do parâmetro é opcional e você pode apenas inserir o valor do parâmetro. Se você executar o comando Get-ChildItem C:\, será o mesmo que executar o comando Get-ChildItem -Path C:\ porque o parâmetro -Path é definido como o primeiro parâmetro na definição do cmdlet. Isso é conhecido como um parâmetro posicional. Você percebe isso ao longo deste curso. Omitir o nome do parâmetro só funciona quando uma posição de parâmetro foi definida. Nem todos os comandos têm parâmetros posicionais.
Comutadores
Os interruptores são um caso especial. São basicamente parâmetros que aceitam um valor booleano (verdadeiro ou falso). Eles diferem dos parâmetros booleanos reais na medida em que o valor só é definido como true se o switch for incluído ao executar o comando. Um exemplo é o parâmetro -Recurse ou a opção do cmdlet Get-ChildItem . O comando Get-ChildItem c:\ -Recurse retorna não apenas os itens no diretório C:\, mas também aqueles em todos os seus subdiretórios. Sem a opção -Recurse , somente os itens no diretório C:\ são retornados.