Sie sind auf Seite 1von 2

THEMA

about_Requires
KURZBESCHREIBUNG
Verhindert die Ausfhrung eines Skripts, wenn die angegebenen
erforderlichen Snap-Ins und Versionen nicht verfgbar sind.
DETAILBESCHREIBUNG
Die Anweisung "#Requires" verhindert die Ausfhrung eines
Skripts, es sei denn, Windows PowerShell-Version, Snap-In und
Version des Snap-Ins entsprechen den angegebenen Anforderungen.
Wenn die Anforderungen nicht erfllt sind, fhrt Windows
PowerShell das Skript nicht aus.
Sie knnen die #Requires-Anweisung in jedem Skript verwenden. Sie
knnen sie nicht in Funktionen, Cmdlets oder Snap-Ins verwenden.
Syntax
Geben Sie das Snap-In und die Version des Snap-Ins, die Sie
voraussetzen mchten, mit der folgenden Syntax an:
#requires -PsSnapIn <PsSnapIn> [-Version <N>[.<n>]]
Geben Sie die Mindestversion von Windows PowerShell, die Sie
voraussetzen mchten, mithilfe der folgenden Syntax an:
#requires -Version <N>[.<n>]
Geben Sie mit der folgenden Syntax die erforderliche Shell an:
#requires -ShellId <ShellId>
Regeln fr 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 ausgefhrt, und Windows PowerShell
zeigt die folgende Fehlermeldung an:
"Das Skript '<Skriptname>' kann nicht ausgefhrt 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 hhere Version des Snap-Ins
Microsoft.PowerShell.Security:
#requires -PsSnapIn Microsoft.PowerShell.Security -Version 2
Die folgende Anweisung erfordert Windows PowerShell 2.0 oder
eine hhere Version:
#requires -Version 2.0
Das folgende Skript beinhaltet zwei #Requires-Anweisungen. Die
in beiden Anweisungen angegebenen Anforderungen mssen erfllt
werden. Andernfalls wird das Skript nicht ausgefhrt. 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
ausgefhrt 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