THEMA
    about_Requires

KURZBESCHREIBUNG
    Verhindert die Ausführung eines Skripts, wenn die angegebenen 
    erforderlichen Snap-Ins und Versionen nicht verfügbar sind.


DETAILBESCHREIBUNG
    Die Anweisung "#Requires" verhindert die Ausführung eines 
    Skripts, es sei denn, Windows PowerShell-Version, Snap-In und 
    Version des Snap-Ins entsprechen den angegebenen Anforderungen. 
    Wenn die Anforderungen nicht erfüllt sind, führt Windows 
    PowerShell das Skript nicht aus. 

    Sie können die #Requires-Anweisung in jedem Skript verwenden. Sie 
    können sie nicht in Funktionen, Cmdlets oder Snap-Ins verwenden. 


  Syntax 

      Geben Sie das Snap-In und die Version des Snap-Ins, die Sie 
      voraussetzen möchten, mit der folgenden Syntax an: 

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


      Geben Sie die Mindestversion von Windows PowerShell, die Sie 
      voraussetzen möchten, mithilfe der folgenden Syntax an: 

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


      Geben Sie mit der folgenden Syntax die erforderliche Shell an: 

          #requires -ShellId <ShellId>


  Regeln für die Verwendung 

      - Die #Requires-Anweisung muss als erstes Element einer 
        Skriptzeile angegeben werden.

      - Ein Skript kann mehr als eine #Requires-Anweisung enthalten. 

      - Die #Requires-Anweisung kann in jeder beliebigen Skriptzeile 
        verwendet werden.


  Beispiele

      Die folgende Anweisung erfordert das Snap-In Microsoft.PowerShell
      .Security:

          #requires -PsSnapIn Microsoft.PowerShell.Security


      Wenn das Snap-In Microsoft.PowerShell.Security nicht geladen 
      ist, wird das Skript nicht ausgeführt, und Windows PowerShell 
      zeigt die folgende Fehlermeldung an: 

          "Das Skript '<Skriptname>' kann nicht ausgeführt werden, da 
          die folgenden in den #requires-Anweisungen des Skripts 
          angegebenen Snap-Ins fehlen: Microsoft.PowerShell.Security". 


      Die folgende Anweisung erfordert Windows PowerShell, 
      Version 2.0, oder eine beliebige höhere Version des Snap-Ins 
      Microsoft.PowerShell.Security:

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


      Die folgende Anweisung erfordert Windows PowerShell 2.0 oder 
      eine höhere Version:

          #requires -Version 2.0


      Das folgende Skript beinhaltet zwei #Requires-Anweisungen. Die 
      in beiden Anweisungen angegebenen Anforderungen müssen erfüllt 
      werden. Andernfalls wird das Skript nicht ausgeführt. Jede 
      #Requires-Anweisung muss als erstes Element einer Zeile 
      angegeben sein:

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


      Folgende #Requires-Anweisung verhindert, dass ein Skript 
      ausgeführt wird, wenn die angegebene Shell-ID nicht der 
      aktuellen Shell-ID entspricht. Die aktuelle Shell-ID wird in 
      der Variablen "$ShellId" gespeichert:

          #requires -ShellId MyLocalShell


SIEHE AUCH
    about_Automatic_Variables
    about_Language_Keywords
    about_PSSnapins
    get-PSSnapin




Inhaltsverzeichnis