about_Data_Sections

Artikel
05/09/2024

Kurze Beschreibung

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

Lange Beschreibung

Skripts, die für PowerShell entwickelt wurden, können einen oder mehrere Datenabschnitte enthalten, die nur Daten enthalten. Sie können einen oder mehrere Datenabschnitte in ein beliebiges Skript, eine Funktion oder eine erweiterte Funktion einschließen. Der Inhalt des Abschnitts Daten ist auf eine angegebene Teilmenge der PowerShell-Skriptsprache beschränkt.

Das Trennen von Daten von der Codelogik erleichtert das Identifizieren und Verwalten von Logik und Daten. Damit können Sie separate Zeichenfolgenressourcendateien für Text verwenden, z. B. Fehlermeldungen und Hilfezeichenfolgen. Außerdem wird die Codelogik isoliert, wodurch Sicherheits- und Validierungstests erleichtert werden.

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 Revision nicht ausgeführt.

Syntax

Die Syntax für einen Datenabschnitt lautet wie folgt:

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

Die daten-Schlüsselwort (keyword) 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. die folgenden:

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 Zeichenfolgen mit einfachem oder doppeltem Anführungszeichen einschließen. Zeichenfolgen, die Variablen und Teilausdrücke enthalten, müssen jedoch in Zeichenfolgen mit einfachem Anführungszeichen oder in Zeichenfolgen mit einfachem Anführungszeichen eingeschlossen werden, damit die Variablen nicht erweitert und die Teilausdrücke nicht ausführbar sind.

-SupportedCommand

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

Der Wert von -SupportedCommand ist eine durch Trennzeichen getrennte Liste von einem oder mehreren Cmdlet- oder Funktionsnamen.

Der folgende Datenabschnitt enthält beispielsweise das vom Benutzer geschriebene Cmdlet Format-Xml, das 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 Variablennotation, um auf den Inhalt zuzugreifen.

Der folgende Datenabschnitt enthält beispielsweise einen ConvertFrom-StringData Befehl, der die here-string in eine Hashtabelle konvertiert. 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 in $TextMsgszuzugreifen.

$TextMsgs.Text001
$TextMsgs.Text002

Alternativ können Sie den Variablennamen in die Definition des Abschnitts Daten einfügen. 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 Zeichenfolge mit einfachem Anführungszeichen, die das ConvertFrom-StringData Cmdlet verwendet:

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

Eine Zeichenfolge mit doppeltem Anführungszeichen, 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