ARGOMENTO
about_Requires
DESCRIZIONE BREVE
Impedisce l'esecuzione di uno script richiedendo gli snap-in e la
versione specificati.
DESCRIZIONE DETTAGLIATA
L'istruzione #Requires impedisce l'esecuzione di uno script se
non sono soddisfatti i prerequisiti di versione di Windows
PowerShell , snap-in e versione snap-in. Se i prerequisiti non sono
soddisfatti, lo script non viene eseguito.
È possibile utilizzare le istruzioni #Requires in qualsiasi
script. Non è possibile utilizzare in funzioni, cmdlet o snap-in.
Sintassi
Utilizzare la sintassi seguente per specificare lo snap-in e la
versione dello snap-in che si desidera richiedere:
#requires -PsSnapIn <PsSnapIn> [-Version <N>[.<n>]]
Utilizzare la sintassi seguente per specificare la versione
minima di Windows PowerShell che si desidera richiedere:
#requires -Version <N>[.<n>]
Utilizzare la sintassi seguente per specificare la shell che si
desidera richiedere:
#requires -ShellId <ShellId>
Regole per l'utilizzo
- L'istruzione #Requires deve essere il primo elemento di una
riga di uno script.
- Uno script può includere più istruzioni Requires.
- Le istruzioni #Requires possono essere riportate in qualsiasi
riga di uno script.
Esempi
L'istruzione seguente richiede lo snap-in Microsoft.PowerShell.S
ecurity:
#requires -PsSnapIn Microsoft.PowerShell.Security
Se lo snap-in Microsoft.PowerShell.Security non è caricato, lo
script non viene eseguito e in Windows PowerShell viene
visualizzato il seguente messaggio di errore:
"Impossibile eseguire lo script '<nome-script>' perché i
seguenti snap-in specificati dalle istruzioni
"#requires" dello script risultano mancanti:
Microsoft.PowerShell.Security."
L'istruzione seguente richiede la versione di Windows
PowerShell 2.0 o qualsiasi versione successiva dello snap-in
Microsoft.PowerShell.Security:
#requires -PsSnapIn Microsoft.PowerShell.Security -Version 2
L'istruzione seguente richiede Windows PowerShell 2.0 o una versione
successiva:
#requires -Version 2.0
Il seguente script presenta due istruzioni #Requires. È
necessario che siano soddisfatti i requisiti specificati in
entrambe le istruzioni. In caso contrario, lo script non verrà
eseguito. Ogni istruzione #Requires deve essere il primo
elemento in una riga:
#requires -PsSnapIn Microsoft.PowerShell.Security -Version 2 Get-
WMIObject WIN32_LogicalDisk | out-file K:\status\DiskStatus.txt
#requires -Version 2
L'istruzione #Requires seguente impedisce l'esecuzione di uno
script se l'ID shell specificato non corrisponde all'ID shell
corrente. L'ID shell corrente è archiviato nella variabile $ShellId:
#requires -ShellId MyLocalShell
VEDERE ANCHE
about_Automatic_Variables
about_Language_Keywords
about_PSSnapins
get-PSSnapin