Valor de retorno da função no PowerShell

PowerShell tem o aplicativo host “PowerShell Ise”, Que é usado para criar scripts e funções. A função contém as declarações ou instruções especificadas pelo usuário. Além disso, o nome da função é atribuído pelo usuário. Esses pedaços de código são executados em PowerShell chamando o nome da função. De acordo com seus requisitos, você pode lidar com a complexidade de uma função.

Este artigo discutirá o uso do valor de retorno do PowerShell.

Qual é a função "retornar" valor em PowerShell?

““retornar”É um valor que a função retorna à função de chamada ou a um script quando concluir sua tarefa. PowerShell usa o valor de retorno nas funções para sair do script ou função após a saída do resultado. A palavra -chave de retorno impede o código depois que ela é executada. O valor de retorno no PowerShell para a execução adicional do código dentro da função e retorna o valor como uma saída.

Você pode entender melhor como o valor de retorno é usado observando os exemplos fornecidos.

Exemplo 1: Usando o valor simples de "retornar"

Este exemplo produzirá o texto para o console PowerShell, utilizando o simples “retornar" valor:

função testreng
"Esta linha será executada"
retornar
"Esta linha não será executada"

Testreturn

No código acima:

• • Primeiro, declaramos uma função e depois adicionamos a mensagem necessária.
  • Depois disso, adicionamos o “retornarPalavra -chave.
  • Por fim, especifique a outra linha que não será executada em nosso caso:

Como você pode ver na saída, o código após o “retornar”O valor não foi executado porque o valor de retorno interrompe instantaneamente o código e gera o valor para o console.

Exemplo 2: Usando "Return" para retornar a soma dos valores em PowerShell

Neste exemplo, adicionaremos os dois números inteiros e os executaremos usando o “retornarPalavra -chave:

função testreng ($ a, $ b)
Write-Output "Isso retornará a saída"
Retorno ($ A+$ B)
Write-Output "Isso não será executado"

Testreturn 1 2

De acordo com o script fornecido:

• • Primeiro, definimos uma função chamada “Testreturn"Com dois argumentos"$ a" e "$ b”.
  • Depois disso, adicionamos o texto usando o “Write-Output”Cmdlet e depois usou o“retornarPalavra -chave para adicionar os valores.
  • Em seguida, adicione outra declaração de texto.
  • Por fim, invocar a função criada passando os parâmetros necessários:

Pode -se observar que, em primeiro lugar, a linha adicionada acima da declaração de retorno exibiu a mensagem adicionada. Então, a soma da variável passada foi devolvida e o script foi encerrado.

Conclusão

““retornar”O valor da função PowerShell sai do script após a execução do código acima do valor de retorno. O código após esta declaração não é executado. É normalmente usado para obter a saída instantânea da função dada. Este tutorial apresentou um guia detalhado sobre o uso do valor de retorno na função PowerShell.