quando precisamos de usar o mesmo código em mais de um script, então usamos uma função PowerShell.

uma função é uma lista de declarações PowerShell cujo nome é atribuído pelo Usuário. Quando executamos uma função, escrevemos o nome de uma função. como os cmdlets, as funções também podem ter parâmetros. Os parâmetros de função podem ser lidos a partir do pipeline ou da linha de comando.

em PowerShell, as funções retornam os valores que podem ser atribuídos às variáveis ou passados para os cmdlets ou outras funções. Usando a palavra-chave return, podemos especificar o valor return.

a Sintaxe

O seguinte bloco descreve uma sintaxe para uma função:

A sintaxe acima inclui os seguintes termos:

• Uma função de palavra-chave
• Um nome que é dado por você
• Um escopo (é opcional)
• Qualquer número de parâmetro com nome
• Um ou mais comandos do PowerShell que são colocadas entre chavetas {}.

escopo de uma função

• em PowerShell, uma função existe num escopo no qual foi criada.
• Se uma função está em um script, ela só está disponível para as declarações dentro desse script.
• Quando uma função é especificada no escopo global, podemos usá-la em outras funções, scripts e linha de comando.

função simples

o bloco seguinte descreve-o como criar a função mais simples Numa PowerShell:

para adicionar as múltiplas declarações à função, temos de usar um ponto e vírgula para separar as declarações ou digitar cada declaração numa linha separada.

para usar a função, digite o nome da função como indicado no bloco seguinte:

Exemplo:

Digite o seguinte comando no console do PowerShell para obter a saída do exemplo acima:

Saída:

Windows Operating SystemLinux operating System

funções Avançadas

funções Avançadas são aquelas funções que pode executar operações que são semelhantes às operações realizadas com os cmdlets. Estas funções são usadas quando um usuário quer escrever uma função sem ter que escrever um cmdlet compilado.

A principal diferença entre usar um cmdlet compilado e uma função avançada é que os cmdlets compilados são as classes de .Framework NET que deve ser escrito em uma linguagem de framework.net. E, as funções avançadas são escritas na Linguagem de script PowerShell.

O exemplo a seguir descreve como utilizar as funções avançadas no PowerShell:

Digite o seguinte comando no console do PowerShell para obter a saída do exemplo acima:

Saída:

cmdlet Send-Greeting at command pipeline position 1Supply values for the following parameters:Name: AmanHi Aman!

Exemplos de Funções

Exemplo1: O seguinte exemplo é uma simples função que retorna a data atual

Digite o seguinte comando no console do PowerShell para obter a saída do exemplo acima:

saída:

15 November 2019 14:41:17

Example2: o exemplo seguinte é uma função que aceita um parâmetro e devolve um valor sobre esse parâmetro.

Digite o seguinte comando para obter a entrada de um usuário para o exemplo acima:

Saída:

Enter a value: 10

Digite o seguinte comando para armazenar o valor de retorno da função em uma variável que mostra a saída da função:

O comando a seguir mostra um resultado:

Saída: