TEMA

about_Requires
DESCRIPCIN BREVE
Impide la ejecucin de un script requiriendo los complementos y
la versin especificados.
DESCRIPCIN DETALLADA
La instruccin #Requires impide que se ejecute un script, a menos
que se cumplan los requisitos previos referentes a la versin de
Windows PowerShell, el complemento y la versin del complemento.
Si no se cumplen los requisitos previos, Windows PowerShell no
ejecuta el script.
Las instrucciones #Requires se pueden usar en cualquier script.
No se pueden usar en funciones, cmdlets o complementos.
Sintaxis
Utilice la sintaxis siguiente para especificar el complemento y
la versin de complemento que desea requerir:
#requires -PsSnapIn <complemento de PowerShell> [-Version <N>[.<n>]]
Utilice la sintaxis siguiente para especificar la versin mnima de
Windows PowerShell que desea requerir:
#requires -Version <N>[.<n>]
Utilice la sintaxis siguiente para especificar el shell que desea requerir
:
#requires -ShellId <identificador de shell>
Reglas de uso
- La instruccin #Requires debe ser el primer elemento de una
lnea en un script.
- Un script puede incluir varias instrucciones #Requires.
- Las instrucciones #Requires pueden aparecer en cualquier
lnea de un script.
Ejemplos
La instruccin siguiente requiere el complemento
Microsoft.PowerShell.Security:
#requires -PsSnapIn Microsoft.PowerShell.Security
Si no se carga el complemento Microsoft.PowerShell.Security, el
script no se ejecuta y Windows PowerShell muestra el siguiente

mensaje de error:
"No se puede ejecutar el script '<nombre del script>' porque faltan
los siguientes complementos que estn especificados por las
instrucciones "#requires" del script: Microsoft.PowerShell.Security."
La instruccin siguiente requiere la versin Windows PowerShell
2.0 o cualquier versin posterior del complemento
Microsoft.PowerShell.Security:
#requires -PsSnapIn Microsoft.PowerShell.Security -Version 2
La instruccin siguiente requiere Windows PowerShell 2.0 o una
versin posterior:
#requires -Version 2.0
El siguiente script tiene dos instrucciones #Requires. Se deben
cumplir los requisitos especificados en ambas instrucciones. De lo
contrario, el script no se ejecutar. Cada instruccin #Requires debe
ser el primer elemento de una lnea:
#requires -PsSnapIn Microsoft.PowerShell.Security -Version 2
Get-WMIObject WIN32_LogicalDisk | out-file K:\status\DiskStatus.txt
#requires -Version 2
La siguiente instruccin #Requires impide la ejecucin de un
script si el identificador de shell especificado no coincide con el
identificador de shell actual. El identificador de shell actual est
almacenado en la variable $ShellId:
#requires -ShellId MyLocalShell
VEA TAMBIN
about_Automatic_Variables
about_Language_Keywords
about_PSSnapins
get-PSSnapin