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 




Argomenti della Guida