about_Data_Sections

Artikel
10/04/2023

Kurze Beschreibung

Erläutert Datenabschnitte, die Textzeichenfolgen und andere schreibgeschützte Daten aus skriptlogik isolieren.

Lange Beschreibung

Skripts, die für PowerShell entwickelt wurden, können über einen oder mehrere Datenabschnitte verfügen, die nur Daten enthalten. Sie können einen oder mehrere Datenabschnitte in beliebige Skript-, Funktions- oder erweiterte Funktionen einschließen. Der Inhalt des Datenabschnitts ist auf eine bestimmte Teilmenge der PowerShell-Skriptsprache beschränkt.

Das Trennen von Daten aus der Codelogik erleichtert das Identifizieren und Verwalten von Logik und Daten. Sie können separate Zeichenfolgenressourcendateien für Text verwenden, z. B. Fehlermeldungen und Hilfezeichenfolgen. Sie isoliert auch die Codelogik, die Sicherheits- und Validierungstests erleichtert.

In PowerShell wird der Abschnitt "Daten" verwendet, um die Skript-Internationalisierung zu unterstützen. Sie können Datenabschnitte verwenden, um das Isolieren, Suchen und Verarbeiten von Zeichenfolgen zu vereinfachen, die in viele Benutzeroberflächensprachen übersetzt werden.

Der Abschnitt "Daten" ist ein PowerShell 2.0-Feature. Skripts mit Datenabschnitten werden in PowerShell 1.0 ohne Überarbeitung nicht ausgeführt.

Syntax

Die Syntax für einen Datenabschnitt lautet wie folgt:

DATA [<variable-name>] [-supportedCommand <cmdlet-name>] {
    <Permitted content>
}

Das Schlüsselwort "Data" ist erforderlich. Es wird nicht zwischen Groß- und Kleinschreibung unterschieden. Der zulässige Inhalt ist auf die folgenden Elemente beschränkt:

Alle PowerShell-Operatoren außer -match
If-, Else- und ElseIf-Anweisungen
Die folgenden automatischen Variablen: $PsCulture, , $PsUICulture$True, , $Falseund$Null
Kommentare
Pipelines
Durch Semikolons getrennte Anweisungen (;)

Literale, z. B. folgendes:

a
1
1,2,3
"PowerShell 2.0"
@( "red", "green", "blue" )
@{ a = 0x1; b = "great"; c ="script" }
[XML] @'
<p> Hello, World </p>
'@

Cmdlets, die in einem Datenabschnitt zulässig sind. Standardmäßig ist nur das ConvertFrom-StringData Cmdlet zulässig.
Cmdlets, die Sie in einem Datenabschnitt mithilfe des -SupportedCommand Parameters zulassen.

Wenn Sie das ConvertFrom-StringData Cmdlet in einem Datenabschnitt verwenden, können Sie die Schlüssel-Wert-Paare in Zeichenfolgen mit einfachem oder doppeltem Anführungszeichen oder in ein- oder doppelt zitierten Hier-Zeichenfolgen einschließen. Zeichenfolgen, die Variablen und Unterausdrücke enthalten, müssen jedoch in Zeichenfolgen mit einfachem Zitat oder in hier zitierten Zeichenfolgen eingeschlossen werden, sodass die Variablen nicht erweitert werden und die Unterausdrücke nicht ausführbar sind.

-SupportedCommand

Mit dem -SupportedCommand Parameter können Sie angeben, dass ein Cmdlet oder eine Funktion nur Daten generiert. Sie ist so konzipiert, dass Benutzer Cmdlets und Funktionen in einen Datenabschnitt aufnehmen können, den sie geschrieben oder getestet haben.

Der Wert ist -SupportedCommand eine durch Kommas getrennte Liste mit einem oder mehreren Cmdlet- oder Funktionsnamen.

Der folgende Datenabschnitt enthält beispielsweise ein vom Benutzer geschriebenes Cmdlet, Format-Xmldas Daten in einer XML-Datei formatiert:

DATA -supportedCommand Format-Xml
{
    Format-Xml -Strings string1, string2, string3
}

Verwenden eines Datenabschnitts

Um den Inhalt eines Datenabschnitts zu verwenden, weisen Sie ihn einer Variablen zu, und verwenden Sie die Variablenotation, um auf den Inhalt zuzugreifen.

Der folgende Datenabschnitt enthält z. B. einen ConvertFrom-StringData Befehl, mit dem die here-Zeichenfolge in eine Hashtabelle konvertiert wird. Die Hashtabelle wird der $TextMsgs Variablen zugewiesen.

Die $TextMsgs Variable ist nicht Teil des Datenabschnitts.

$TextMsgs = DATA {
    ConvertFrom-StringData -StringData @'
Text001 = Windows 7
Text002 = Windows Server 2008 R2
'@
}

Verwenden Sie die folgenden Befehle, um auf die Schlüssel und Werte in der Hashtabelle $TextMsgszuzugreifen.

$TextMsgs.Text001
$TextMsgs.Text002

Alternativ können Sie den Variablennamen in die Definition des Datenabschnitts einfügen. Zum Beispiel:

DATA TextMsgs {
    ConvertFrom-StringData -StringData @'
Text001 = Windows 7
Text002 = Windows Server 2008 R2
'@
}

$TextMsgs

Das Ergebnis entspricht dem vorherigen Beispiel.

Name                           Value
----                           -----
Text001                        Windows 7
Text002                        Windows Server 2008 R2

Beispiele

Einfache Datenzeichenfolgen.

DATA {
    "Thank you for using my PowerShell Organize.pst script."
    "It is provided free of charge to the community."
    "I appreciate your comments and feedback."
}

Zeichenfolgen, die zulässige Variablen enthalten.

DATA {
    if ($null) {
        "To get help for this cmdlet, type get-help new-dictionary."
    }
}

Eine hier zitierte einzel zitierte Zeichenfolge, die das ConvertFrom-StringData Cmdlet verwendet:

DATA {
    ConvertFrom-StringData -stringdata @'
Text001 = Windows 7
Text002 = Windows Server 2008 R2
'@
}

Eine hier zitierte doppelte Zeichenfolge, die das ConvertFrom-StringData Cmdlet verwendet:

DATA  {
    ConvertFrom-StringData -stringdata @"
Msg1 = To start, press any key.
Msg2 = To exit, type "quit".
"@
}

Ein Datenabschnitt, der ein vom Benutzer geschriebenes Cmdlet enthält, das Daten generiert:

DATA -supportedCommand Format-XML {
    Format-Xml -strings string1, string2, string3
}

Freigeben über