about_Requires

РАЗДЕЛ
    about_Requires

КРАТКОЕ ОПИСАНИЕ
    Запрещает выполнение скриптов при отсутствии указанных оснасток 
    и версии.


ПОЛНОЕ ОПИСАНИЕ
    Инструкция #Requires запрещает выполнение скрипта, если не выполняются 
    предварительные условия по версии Windows PowerShell, оснастке и версии 
    оснастки. Если предварительные условия не выполняются, Windows 
    PowerShell не выполняет скрипт. 

    Инструкции #Requires можно использовать в любом скрипте. Их нельзя 
    использовать в функциях, командлетах и оснастках. 


  Синтаксис 

      Для указания требуемой оснастки и ее версии используйте следующий 
      синтаксис: 

          #requires -PsSnapIn <оснастка_PS> [-Version <N>[.<n>]]


      Для указания минимальной требуемой версии Windows PowerShell 
      используйте следующий синтаксис: 

          #requires -Version <N>[.<n>]


      Для указания требуемой оболочки используйте следующий синтаксис: 

          #requires -ShellId <ИД_оболочки>


  Правила использования 

      - Инструкция #Requires должна быть первым элементом в строке 
        скрипта.

      - Скрипт может включать несколько инструкций #Requires. 

      - Инструкции #Requires могут быть расположены в любой строке 
        скрипта.


  Примеры

      Следующая инструкция требует оснастку Microsoft.PowerShell.Security:

          #requires -PsSnapIn Microsoft.PowerShell.Security


      Если оснастка Microsoft.PowerShell.Security не загружена, скрипт не 
      выполняется и в Windows PowerShell отображается следующее сообщение 
      об ошибке: 

          "Не удалось выполнить скрипт "<имя_скрипта>", так как 
          отсутствуют следующие оснастки Windows PowerShell, 
      указанные инструкциями "#requires": Microsoft.PowerShell.Security.". 


      Следующая инструкция требует версию Windows PowerShell 2.0 или 
      любую более позднюю версию оснастки Microsoft.PowerShell.Security:

          #requires -PsSnapIn Microsoft.PowerShell.Security -Version 2


      Следующая инструкция требует Windows PowerShell 2.0 или более 
      поздней версии:

          #requires -Version 2.0


      В следующем скрипте содержатся две инструкции #Requires. Должны быть 
      выполнены требования, указанные в обеих инструкциях. В противном 
      случае скрипт не будет выполнен. Каждая инструкция #Requires должна 
      быть первым элементом в строке.

          #requires -PsSnapIn Microsoft.PowerShell.Security -Version 2 
          Get-WMIObject WIN32_LogicalDisk | out-file K:\status\DiskStatus.txt 
          #requires -Version 2


      Следующая инструкция #Requires запрещает выполнение скрипта, если 
      указанный идентификатор оболочки не соответствует текущему. Текущий 
      идентификатор оболочки хранится в переменной $ShellId.

          #requires -ShellId MyLocalShell


СМ. ТАКЖЕ
    about_Automatic_Variables
    about_Language_Keywords
    about_PSSnapins
    get-PSSnapin