Beschreibt Regeln zur Verwendung einzelner und doppelter (about_Quoting_Rules)
THEMAabout_Quoting_RulesKURZBESCHREIBUNGBeschreibt Regeln zur Verwendung einzelner und doppelter Anführungszeichen in Windows PowerShell.DETAILBESCHREIBUNGAnführungszeichen werden verwendet, um eine Literalzeichenfolge anzugeben. Zeichenfolgen können in einfache gerade (') oder doppelte gerade Anführungszeichen (") eingeschlossen werden. Anführungszeichen werden außerdem verwendet, um eine here-Zeichenfolge zu erstellen. Eine here-Zeichenfolge ist eine Zeichenfolge in einfachen oder doppelten Anführungszeichen, in der Anführungszeichen buchstäblich interpretiert werden. Eine here-Zeichenfolge kann mehrere Zeilen umfassen. Alle Zeilen in einer here-Zeichenfolge werden als Zeichenfolgen interpretiert, auch wenn sie nicht in Anführungszeichen eingeschlossen sind. In Befehlen an Remotecomputer definieren Anführungszeichen die Teile des Befehls, die auf dem Remotecomputer ausgeführt werden. In einer Remotesitzung legen Anführungszeichen weiterhin fest, ob die Variablen in einem Befehl zuerst auf dem lokalen Computer oder auf dem Remotecomputer interpretiert werden. Zeichenfolgen in einzelnen und doppelten Anführungszeichen Bei Zeichenfolgen zwischen doppelten Anführungszeichen werden Variablennamen nach einem Dollarzeichen ($) durch den Wert der Variablen ersetzt, bevor die Zeichenfolge zur Verarbeitung an den Befehl übergeben wird. Beispiel: $i = 5 "Der Wert von $i ist $i." Dieser Befehl erzeugt folgende Ausgabe: Der Wert von 5 ist 5 In Zeichenfolgen in doppelten Anführungszeichen werden auch Ausdrücke ausgewertet, und das Ergebnis wird in die Zeichenfolge eingefügt. Beispiel: "Der Wert von $(2+3) ist 5." Dieser Befehl erzeugt folgende Ausgabe: Der Wert von 5 ist 5 Zeichenfolgen zwischen einfachen Anführungszeichen werden so an den Befehl übergeben, wie Sie eingegeben wurden. Es findet keine Ersetzung statt. Beispiel: $i = 5 'Der Wert von $i ist $i.' Dieser Befehl erzeugt folgende Ausgabe: Der Wert von $i ist $i. Entsprechend werden Ausdrücke in Zeichenfolgen zwischen einfachen Anführungszeichen nicht ausgewertet. Sie werden als Literale interpretiert. Beispiel: 'Der Wert von $(2+3) ist 5.' Dieser Befehl erzeugt folgende Ausgabe: Der Wert von $(2+3) ist 5. Mit dem Graviszeichen (') (ASCII 96), dem Escapezeichen von Windows PowerShell, können Sie die Ersetzung eines Variablenwerts in einer Zeichenfolge zwischen doppelten Anführungszeichen verhindern. Im folgenden Beispiel wird durch das Graviszeichen vor der ersten $i-Variablen verhindert, dass der Name der Variablen von Windows PowerShell durch ihren Wert ersetzt wird. Beispiel: $i = 5 "Der Wert von `$i ist $i." Dieser Befehl erzeugt folgende Ausgabe: Der Wert von $i ist 5. Doppelte Anführungszeichen können in einer Zeichenfolge angezeigt werden, indem die gesamte Zeichenfolge in einfache Anführungszeichen eingeschlossen wird. Beispiel: 'Wie sagt man so schön: "Man lernt nie aus."' Dieser Befehl erzeugt folgende Ausgabe: Wie sagt man so schön: "Man lernt nie aus." Sie können auch eine Zeichenfolge in einfachen Anführungszeichen in eine Zeichenfolge in doppelten Anführungszeichen einschließen. Beispiel: "Wie sagt man so schön: 'Man lernt nie aus.'" Dieser Befehl erzeugt folgende Ausgabe: Wie sagt man so schön: 'Man lernt nie aus.' Sie können auch einen Satz in doppelten Anführungszeichen in doppelte Anführungszeichen einschließen. Beispiel: "Wie sagt man so schön: ""Man lernt nie aus.""" Dieser Befehl erzeugt folgende Ausgabe: Wie sagt man so schön: "Man lernt nie aus." Um ein einfaches Anführungszeichen in eine Zeichenfolge in einfachen Anführungszeichen einzuschließen, verwenden Sie ein zweites, darauf folgendes einfaches Anführungszeichen. Beispiel: 'Boole''sch' Dieser Befehl erzeugt folgende Ausgabe: Boole'sch Um Windows PowerShell zu zwingen, ein doppeltes Anführungszeichen buchstäblich zu interpretieren, verwenden Sie ein Graviszeichen. Dadurch wird verhindert, dass Windows PowerShell das Anführungszeichen als Zeichenfolgentrennzeichen interpretiert. Beispiel: "Beginnen Sie eine Zeichenfolge mit einem Anführungszeichen (`")." Da der Inhalt von Zeichenfolgen in einfachen Anführungszeichen buchstäblich interpretiert wird, können Sie in einer Zeichenfolge in einfachen Anführungszeichen kein Graviszeichen verwenden, um die buchstäbliche Interpretation von Zeichen zu erzwingen. Mit dem folgenden Befehl wird beispielsweise ein Fehler generiert, da Windows PowerShell das Escapezeichen nicht erkennt. Stattdessen wird das zweite Anführungszeichen als Ende der Zeichenfolge interpretiert. PS C:\> 'Beginnen Sie eine Zeichenfolge mit einem Anführungszeichen (`').' Unerwartetes Token ')' in Ausdruck oder Anweisung. Bei Zeile:1 Zeichen:27 + 'Beginnen Sie eine Zeichenfolge <<<< mit einem Anführungszeichen (`').' Here-Zeichenfolgen in einzelnen und doppelten Anführungszeichen Die Verwendung von Anführungszeichen für here-Zeichenfolgen ist etwas anders geregelt. Eine here-Zeichenfolge ist eine Zeichenfolge in einfachen oder doppelten Anführungszeichen, in der Anführungszeichen buchstäblich interpretiert werden. Eine here-Zeichenfolge kann mehrere Zeilen umfassen. Alle Zeilen in einer here-Zeichenfolge werden als Zeichenfolgen interpretiert, auch wenn sie nicht in Anführungszeichen eingeschlossen sind. Analog zu regulären Zeichenfolgen werden Variablen bei here-Zeichenfolgen in doppelten Anführungszeichen durch die entsprechenden Werte ersetzt. Bei here-Zeichenfolgen in einfachen Anführungszeichen werden Variablen nicht durch die entsprechenden Werte ersetzt. Auch wenn here-Zeichenfolgen für beliebigen Text verwendet werden können, sind sie für die folgenden Arten von Text besonders nützlich: - Text mit literalen Anführungszeichen; - mehrzeiliger Text, beispielsweise Text in einem HTML- oder XML-Dokument; - Hilfetext für ein Skript oder eine Funktion Here-Zeichenfolgen können eines der nachstehenden Formate aufweisen. <Eingabetaste> steht dabei für das ausgeblendete Zeilenvorschubzeichen oder das ausgeblendete Neue-Zeile-Zeichen, das hinzugefügt wird, wenn Sie die EINGABETASTE drücken. Format 1: @"<Eingabetaste> <Zeichenfolge> [Zeichenfolge] ...<Eingabetaste> "@ Format 2: @'<Eingabetaste> <Zeichenfolge> [Zeichenfolge] ...<Eingabetaste> '@ Unabhängig vom verwendeten Format muss das schließende Anführungszeichen das erste Zeichen in der Zeile darstellen. Eine here-Zeichenfolge enthält den gesamten Text zwischen den beiden ausgeblendeten Zeichen. In der here-Zeichenfolge werden alle Anführungszeichen buchstäblich interpretiert. Beispiel: @" Geben Sie "get-help" ein, um Hilfe zu erhalten. "@ Dieser Befehl erzeugt folgende Ausgabe: Geben Sie "get-help" ein, um Hilfe zu erhalten. Here-Zeichenfolgen können die Verwendung von Zeichenfolgen in Befehlen vereinfachen. Beispiel: @" Beginnen Sie eine Zeichenfolge mit einem Anführungszeichen ('). "@ Dieser Befehl erzeugt folgende Ausgabe: Beginnen Sie eine Zeichenfolge mit einem Anführungszeichen ('). Bei here-Zeichenfolgen in einfachen Anführungszeichen werden Variablen buchstäblich interpretiert und exakt reproduziert. Beispiel: @' Die Variable "$profile" enthält den Pfad des Windows PowerShell-Profils. '@ Dieser Befehl erzeugt folgende Ausgabe: Die Variable "$profile" enthält den Pfad des Windows PowerShell-Profils. Bei here-Zeichenfolgen in doppelten Anführungszeichen werden Variablen durch die entsprechenden Werte ersetzt. Beispiel: @" Auch wenn Sie kein Profil erstellt haben, lautet der Pfad der Profildatei wie folgt: $profile. "@ Dieser Befehl erzeugt folgende Ausgabe: Auch wenn Sie kein Profil erstellt haben, lautet der Pfad der Profildatei wie folgt: C:\Users\User01\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1. Here-Zeichenfolgen werden in aller Regel verwendet, um mehrere Zeilen einer Variablen zuzuweisen. Beispielsweise weist die folgende here-Zeichenfolge der Variablen "$page" eine Seite mit XML zu. $page = [XML] @" <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <command:details> <command:name> Format-Table </command:name> <maml:description> <maml:para>Formatiert die Ausgabe als Tabelle.</maml:para> </maml:description> <command:verb>format</command:verb> <command:noun>table</command:noun> <dev:version></dev:version> </command:details> ... </command:command> "@ Here-Zeichenfolgen sind auch ein gut geeignetes Format für Eingaben für das Cmdlet "ConvertFrom-StringData", mit dem here-Zeichenfolgen in Hashtabellen umgewandelt werden. Weitere Informationen finden Sie unter "ConvertFrom-StringData". SIEHE AUCH about_Escape_Characters ConvertFrom-StringData C:\Windows>powershell get-help about_Redirection -full
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export
