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