TPICO

about_Requires
DESCRIO RESUMIDA
Impede a execuo de um script ao requerer os snap-ins e a verso
especificados.
DESCRIO LONGA
A instruo #Requires impede a execuo de um script, a menos que
os pr-requisitos de verso do Windows PowerShell, snap-in e verso
do snap-in sejam atendidos. Se os pr-requisitos no forem atendidos,
o Windows PowerShell no executar o script.
Voc pode usar instrues #Requires em qualquer script. No possvel
us-las em funes, cmdlets ou snap-ins.
Sintaxe
Use a seguinte sintaxe para especificar o snap-in e a verso do
snap-in que voc deseja requerer:
#requires -PsSnapIn <PsSnapIn> [-Version <N>[.<n>]]
Use a seguinte sintaxe para especificar a verso mnima do Windows
PowerShell que voc deseja requerer:
#requires -Version <N>[.<n>]
Use a seguinte sintaxe para especificar o shell que voc deseja
requerer:
#requires -ShellId <ShellId>
Regras de uso
- A instruo #Requires deve ser o primeiro item em uma linha
de um script.
- Um script pode incluir mais de uma instruo #Requires.
- As instrues #Requires podem aparecer em qualquer linha de
um script.
Exemplos
A instruo a seguir requer o snap-in Microsoft.PowerShell.Security:
#requires -PsSnapIn Microsoft.PowerShell.Security
Se o snap-in Microsoft.PowerShell.Security no for carregado,
o script no ser executado e o Windows PowerShell exibir a seguinte
mensagem de erro:

"O script '<nome-do-script>' no pode ser executado porque os

seguintes snap-ins do Windows PowerShell especificados por suas
instrues "#requires" esto ausentes: Microsoft.PowerShell.Security."
A instruo a seguir requer a verso do Windows PowerShell 2.0
ou qualquer verso posterior do snap-in Microsoft.PowerShell.Security:
#requires -PsSnapIn Microsoft.PowerShell.Security -Version 2
A instruo a seguir requer o Windows PowerShell 2.0 ou uma verso
posterior:
#requires -Version 2.0
O script a seguir tem duas instrues #Requires. Os requisitos
especificados nas duas instrues devem ser atendidos. Caso
contrrio, o script no ser executado. Cada instruo #Requires
deve ser o primeiro item em uma linha:
#requires -PsSnapIn Microsoft.PowerShell.Security -Version 2
Get-WMIObject WIN32_LogicalDisk | out-file K:\status\DiskStatus.txt
#requires -Version 2
A instruo #Requires a seguir impedir que um script seja
executado se a ID de shell especificada no corresponder ID
de shell atual. A ID de shell atual armazenada na varivel
$ShellId:
#requires -ShellId MyLocalShell
CONSULTE TAMBM
about_Automatic_Variables
about_Language_Keywords
about_PSSnapins
get-PSSnapin