Informationen zu Sprachstichwörtern
KURZE BESCHREIBUNG
Beschreibt die Schlüsselwörter in der PowerShell-Skriptsprache.
LANGE BESCHREIBUNG
PowerShell verfügt über die folgenden Sprachstichwörter. Weitere Informationen finden Sie im Thema für das Schlüsselwort und die Informationen, die der Tabelle folgen.
Sprachschlüsselwörter
Starten
Gibt einen Teil des Textkörpers einer Funktion zusammen mit den Schlüsselwörtern , und End
den DynamicParam
Process
Schlüsselwörtern an. Die Begin
Anweisungsliste wird einmal ausgeführt, bevor objekte aus der Pipeline empfangen werden.
Syntax:
function <name> {
DynamicParam {<statement list>}
begin {<statement list>}
process {<statement list>}
end {<statement list>}
}
Problemfindung
Bewirkt, dass ein Skript eine Schleife beendet.
Syntax:
while (<condition>) {
<statements>
...
break
...
<statements>
}
Catch
Gibt eine Anweisungsliste an, die ausgeführt werden soll, wenn in der zugehörigen Try-Anweisungsliste ein Fehler auftritt. Ein Fehlertyp erfordert Klammern. Das zweite Klammernpaar gibt an, dass der Fehlertyp optional ist.
Syntax:
try {<statement list>}
catch [[<error type>]] {<statement list>}
Klasse
Gibt eine neue Klasse in PowerShell an.
Syntax:
class <class-name> {
[[hidden] [static] <property-definition> ...]
[<class-name>([argument-list>]) {<constructor-statement-list>} ...]
[[hidden] [static] <method-definition> ...]
}
Weiter
Bewirkt, dass ein Skript die Ausführung einer Schleife beendet und zur Bedingung zurückzukehren. Wenn die Bedingung erfüllt ist, beginnt das Skript erneut mit der Schleife.
Syntax:
while (<condition>) {
<statements>
...
continue
...
<statements>
}
Daten
Definiert in einem Skript einen Abschnitt, der Daten aus der Skriptlogik isoliert. Kann auch Anweisungen und einige eingeschränkte Befehle enthalten If
.
Syntax:
data <variable> [-supportedCommand <cmdlet-name>] {<permitted content>}
Empfohlen
Wird mit dem oder Until
dem While
Schlüsselwort als Looping-Konstrukt verwendet. PowerShell führt die Anweisungsliste mindestens einmal aus, anders als eine Schleife, die verwendet wird While
.
Syntax für While
:
do {<statement list>} while (<condition>)
Syntax für Until
:
do {<statement list>} until (<condition>)
DynamicParam
Gibt einen Teil des Textkörpers einer Funktion zusammen mit den Begin
Schlüsselwörtern ,, Process
an End
. Dynamische Parameter werden zur Laufzeit hinzugefügt.
Syntax:
function <name> {
DynamicParam {<statement list>}
begin {<statement list>}
process {<statement list>}
end {<statement list>}
}
Else
Wird mit dem Schlüsselwort verwendet, um die If
Standardausweisungsliste anzugeben.
Syntax:
if (<condition>) {<statement list>}
else {<statement list>}
Elseif
Wird mit den If
Schlüsselwörtern Else
verwendet, um zusätzliche Bedingten anzugeben. Das Else
Schlüsselwort ist optional.
Syntax:
if (<condition>) {<statement list>}
elseif (<condition>) {<statement list>}
else {<statement list>}
Ende
Gibt einen Teil des Textkörpers einer Funktion zusammen mit den DynamicParam
Schlüsselwörtern ,, Begin
an End
. Die End
Anweisungsliste wird einmal ausgeführt, nachdem alle Objekte aus der Pipeline empfangen wurden.
Syntax:
function <name> {
DynamicParam {<statement list>}
begin {<statement list>}
process {<statement list>}
end {<statement list>}
}
Enumeration
enum
wird verwendet, um eine Aufzählung zu deklarieren; ein eindeutiger Typ, der aus einer Reihe benannter Bezeichnungen besteht, die als Aufzählungsliste bezeichnet werden.
Syntax:
enum <enum-name> {
<label> [= <int-value>]
...
}
Beenden
Bewirkt, dass PowerShell ein Skript oder eine PowerShell-Instanz beendet.
Syntax:
exit
exit <exitcode>
Wenn Sie den Dateiparameter verwendenpwsh
, sollte die .ps1
Datei selbst Anweisungen zum Behandeln von Fehlern oder Ausnahmen enthalten, die während der Ausführung des Skripts auftreten. Sie sollten die Anweisung nur verwenden exit
, um den Status nach der Ausführung des Skripts anzugeben.
Unter Windows ist eine beliebige Zahl zwischen [int]::MinValue
und [int]::MaxValue
zulässig.
Auf Unix sind nur positive Zahlen zwischen [byte]::MinValue
und [byte]::MaxValue
zulässig. Eine negative Zahl im Bereich des -1
Durchlaufs -255
wird automatisch in eine positive Zahl übersetzt, indem Sie 256 hinzufügen. So wird z. B -2
. in 254
".
In PowerShell legt die exit
Anweisung den Wert der $LASTEXITCODE
Variable fest. In der Windows-Befehlsshell (cmd.exe) legt die Exit-Anweisung den Wert der %ERRORLEVEL%
Umgebungsvariable fest.
Jedes Argument, das nicht numerische oder außerhalb des plattformspezifischen Bereichs ist, wird in den Wert von 0
.
Im folgenden Beispiel legt der Benutzer den Variablenwert auf Fehlerebene auf 4 fest, indem er der Skriptdatei test.ps1
hinzufügtexit 4
.
C:\scripts\test>type test.ps1
1
2
3
exit 4
C:\scripts\test>pwsh -file ./test.ps1
1
2
3
C:\scripts\test>echo %ERRORLEVEL%
4
Wenn Sie ausführen pwsh.exe -File <path to a script>
und die Skriptdatei mit einem exit
Befehl beendet wird, wird der Exitcode auf das numerische Argument festgelegt, das mit dem exit
Befehl verwendet wird. Wenn das Skript keine exit
Anweisung aufweist, befindet sich der Exitcode immer 0
dann, wenn das Skript ohne Fehler abgeschlossen ist oder 1
wenn das Skript aus einer nicht behandelten Ausnahme beendet wird.
Filter
Gibt eine Funktion an, in der die Anweisungsliste einmal für jedes Eingabeobjekt ausgeführt wird. Es hat den gleichen Effekt wie eine Funktion, die nur einen Prozessblock enthält.
Syntax:
filter <name> {<statement list>}
Finally
Definiert eine Anweisungsliste, die nach Anweisungen ausgeführt wird, die mit Try and Catch verknüpft sind. Eine Finally
Anweisungsliste wird auch ausgeführt, wenn Sie drücken CTRL+C
, um ein Skript zu verlassen oder wenn Sie das Exit-Schlüsselwort im Skript verwenden.
Syntax:
try {<statement list>}
catch [<error type>] {<statement list>}
finally {<statement list>}
Für
Definiert eine Schleife mithilfe einer Bedingung.
Syntax:
for (<initialize>; <condition>; <iterate>) { <statement list> }
ForEach
Definiert eine Schleife mithilfe jedes Elements einer Auflistung.
Syntax:
ForEach (<item> in <collection>) { <statement list> }
Von
Für die zukünftige Verwendung reserviert.
Funktion
Erstellt eine benannte Anweisungsliste mit wiederverwendbarem Code. Sie können den Bereich benennen, zu dem eine Funktion gehört. Außerdem können Sie mithilfe des Schlüsselworts Param
einen oder mehrere benannte Parameter angeben. Innerhalb der Funktionsausweisungsliste können Sie Listen , , Begin
Process
, und End
Anweisungslisten einschließenDynamicParam
.
Syntax:
function [<scope:>]<name> {
param ([type]<$pname1> [, [type]<$pname2>])
DynamicParam {<statement list>}
begin {<statement list>}
process {<statement list>}
end {<statement list>}
}
Sie haben auch die Möglichkeit, einen oder mehrere Parameter außerhalb der Anweisungsliste nach dem Funktionsnamen zu definieren.
Syntax:
function [<scope:>]<name> [([type]<$pname1>, [[type]<$pname2>])] {
DynamicParam {<statement list>}
begin {<statement list>}
process {<statement list>}
end {<statement list>}
}
Wenn
Definiert eine bedingte Bedingung.
Syntax:
if (<condition>) {<statement list>}
Ausgeblendet
Blendet Klassenmitglieder aus den Standardergebnissen des Get-Member
Cmdlets und von IntelliSense- und Registerkartenabschlussergebnissen aus.
Syntax:
Hidden [data type] $member_name
In
Wird in einer ForEach
Anweisung verwendet, um eine Schleife zu erstellen, die jedes Element einer Auflistung verwendet.
Syntax:
ForEach (<item> in <collection>){<statement list>}
InlineScript
Führt Workflowbefehle in einer freigegebenen PowerShell-Sitzung aus. Dieses Schlüsselwort ist nur in einem PowerShell-Workflow gültig.
Syntax:
workflow <verb>-<noun>
{
InlineScript
{
<Command/Expression>
...
}
}
Das InlineScript
Schlüsselwort gibt eine InlineScript
Aktivität an, die Befehle in einer freigegebenen Standardsitzung (nicht-workflow) ausführt. Sie können das InlineScript
Schlüsselwort verwenden, um Befehle auszuführen, die in einem Workflow nicht anderweitig gültig sind, und Befehle ausführen, die Daten freigeben. Standardmäßig werden die Befehle in einem InlineScript-Skriptblock in einem separaten Prozess ausgeführt.
Weitere Informationen finden Sie unter Ausführen von PowerShell-Befehlen in einem Workflow.
Parameter
Definiert die Parameter in einer Funktion.
Syntax:
function [<scope:>]<name> {
param ([type]<$pname1>[, [[type]<$pname2>]])
<statement list>
}
Prozess
Gibt einen Teil des Textkörpers einer Funktion zusammen mit den DynamicParam
Begin
Schlüsselwörtern , uswEnd
. an. Wenn eine Process
Anweisungsliste Eingaben aus der Pipeline empfängt, wird die Process
Anweisungsliste einmal für jedes Element aus der Pipeline ausgeführt. Wenn die Pipeline keine Objekte bereitstellt, wird die Process
Anweisungsliste nicht ausgeführt. Wenn der Befehl der erste Befehl in der Pipeline ist, wird die Process
Anweisungsliste einmal ausgeführt.
Syntax:
function <name> {
DynamicParam {<statement list>}
begin {<statement list>}
process {<statement list>}
end {<statement list>}
}
Rückgabewert
Bewirkt, dass PowerShell den aktuellen Bereich verlassen kann, z. B. ein Skript oder eine Funktion, und schreibt den optionalen Ausdruck in die Ausgabe.
Syntax:
return [<expression>]
Statisch
Gibt die definierte Eigenschaft oder Methode für alle Instanzen der Klasse an, in der definiert wird.
Weitere Informationen finden Sie unter Class
Verwendungsbeispielen.
Schalter
Um mehrere Bedingungen zu überprüfen, verwenden Sie eine Switch
Anweisung. Die Switch
Anweisung entspricht einer Reihe von If
Anweisungen, aber es ist einfacher.
Die Switch
Anweisung listet jede Bedingung und eine optionale Aktion auf. Wenn eine Bedingung abruft, wird die Aktion ausgeführt.
Syntax 1:
switch [-regex|-wildcard|-exact][-casesensitive] ( <value> )
{
<string>|<number>|<variable>|{ <expression> } {<statement list>}
<string>|<number>|<variable>|{ <expression> } {<statement list>}
...
default {<statement list>}
}
Syntax 2:
switch [-regex|-wildcard|-exact][-casesensitive] -file <filename>
{
<string>|<number>|<variable>|{ <expression> } {<statement list>}
<string>|<number>|<variable>|{ <expression> } {<statement list>}
...
default {<statement list>}
}
Throw
Löst ein Objekt als Fehler aus.
Syntax:
throw [<object>]
Trap
Definiert eine Anweisungsliste, die ausgeführt werden soll, wenn ein Fehler aufgetreten ist. Ein Fehlertyp erfordert Klammern. Das zweite Klammernpaar gibt an, dass der Fehlertyp optional ist.
Syntax:
trap [[<error type>]] {<statement list>}
Testen
Definiert eine Anweisungsliste, die während der Ausführung der Anweisungen auf Fehler überprüft werden soll. Wenn ein Fehler auftritt, wird PowerShell weiterhin in einer Catch
oder Finally
Anweisung ausgeführt. Ein Fehlertyp erfordert Klammern. Das zweite Klammernpaar gibt an, dass der Fehlertyp optional ist.
Syntax:
try {<statement list>}
catch [[<error type>]] {<statement list>}
finally {<statement list>}
Until
Wird in einer Do
Anweisung als Schleifenkonstrukt verwendet, bei dem die Anweisungsliste mindestens einmal ausgeführt wird.
Syntax:
do {<statement list>} until (<condition>)
Verwenden
Ermöglicht es, anzugeben, welche Namespaces in der Sitzung verwendet werden. Klassen und Mitglieder erfordern weniger Eingaben, um sie zu erwähnen. Sie können auch Klassen aus Modulen einschließen.
Syntax #1:
using namespace <.Net-framework-namespace>
Syntax #2:
using module <module-name>
While
Die while
Anweisung ist ein Schleifenkonstrukt, bei dem die Bedingung getestet wird, bevor die Anweisungen ausgeführt werden. Wenn die Bedingung FALSE ist, werden die Anweisungen nicht ausgeführt.
Anweisungssyntax:
while (<condition>) {
<statements>
}
Wenn Sie in einer Anweisung verwendet werden, ist ein Teil eines Do
Schleifenkonstrukts, while
in dem die Anweisungsliste mindestens einmal ausgeführt wird.
Syntax der Schleife ausführen:
do {<statement list>} while (<condition>)