Delen via

about_Data_Sections

  • Artikel

Korte beschrijving

Legt uit: DATA-secties, die tekstreeksen en andere alleen-lezen gegevens isoleren van de scriptlogica.

Lange beschrijving

Scripts die zijn ontworpen voor PowerShell, kunnen een of meer DATA secties bevatten die alleen gegevens bevatten. U kunt een of meer DATA secties opnemen in een script, functie of geavanceerde functie. De inhoud van de sectie DATA is beperkt tot een opgegeven subset van de PowerShell-scripttaal.

Door gegevens van codelogica te scheiden, is het eenvoudiger om zowel logica als gegevens te identificeren en te beheren. Hiermee kunt u afzonderlijke tekenreeksresourcebestanden voor tekst hebben, zoals foutberichten en Help-tekenreeksen. Het isoleert ook de codelogica, waardoor beveiligings- en validatietests mogelijk zijn.

In PowerShell kunt u de sectie DATA gebruiken om internationalisering van scripts te ondersteunen. U kunt DATA secties gebruiken om gemakkelijker tekenreeksen te isoleren, te zoeken en te verwerken die in andere talen kunnen worden vertaald.

De sectie DATA is toegevoegd in de functie PowerShell 2.0.

Syntaxis

De syntaxis voor een DATA sectie is als volgt:

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

Het DATA trefwoord is vereist. Het is niet hoofdlettergevoelig. De toegestane inhoud is beperkt tot de volgende elementen:

  • Alle PowerShell-operators, behalve -match

  • If, Elseen ElseIf instructies

  • De volgende automatische variabelen: $PsCulture, $PsUICulture, $True, $Falseen $Null

  • Opmerkingen

  • Pipelines

  • Instructies gescheiden door puntkomma's (;)

  • Letterlijke waarden, zoals de volgende:

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

  • Cmdlets die zijn toegestaan in een DATA sectie. Standaard is alleen de ConvertFrom-StringData cmdlet toegestaan.

  • Cmdlets die u in een DATA sectie toestaat met behulp van de parameter -SupportedCommand.

Wanneer u de cmdlet ConvertFrom-StringData in een DATA-sectie gebruikt, kunt u de sleutel-waardeparen tussen enkelvoudige of dubbele aanhalingstekens plaatsen, of in enkelvoudige of dubbele here-strings. Tekenreeksen die variabelen en subexpressies bevatten, moeten echter tussen enkele aanhalingstekens of in enkele aanhalingstekens hier-tekenreeksen staan, zodat de variabelen niet worden geëxpandeerd en de subexpressies niet uitvoerbaar zijn.

-SupportedCommand

Met de parameter SupportedCommand kunt u aangeven dat een cmdlet of functie alleen gegevens genereert. Het is ontworpen om gebruikers te vergunnen cmdlets en functies op te nemen in een DATA-gedeelte dat ze hebben geschreven of getest.

De waarde van SupportedCommand is een door komma's gescheiden lijst met een of meer cmdlets of functienamen.

De volgende DATA sectie bevat bijvoorbeeld een door de gebruiker geschreven cmdlet, Format-Xml, waarmee gegevens in een XML-bestand worden opgemaakt:

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

Een DATA-sectie gebruiken

Als u de inhoud van een DATA sectie wilt gebruiken, wijst u deze toe aan een variabele en gebruikt u de variabele notatie voor toegang tot de inhoud.

De volgende DATA sectie bevat bijvoorbeeld een ConvertFrom-StringData opdracht waarmee de hier-tekenreeks wordt geconverteerd naar een hash-tabel. De hash-tabel wordt toegewezen aan de $TextMsgs variabele.

De $TextMsgs variabele maakt geen deel uit van de sectie DATA.

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

Gebruik de volgende opdrachten om toegang te krijgen tot de sleutels en waarden in de hash-tabel in $TextMsgs.

$TextMsgs.Text001
$TextMsgs.Text002

U kunt ook de naam van de variabele in de definitie van de sectie DATA plaatsen. Voorbeeld:

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

$TextMsgs

Het resultaat is hetzelfde als in het vorige voorbeeld.

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

Voorbeelden

Eenvoudige gegevensreeksen.

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."
}

Tekenreeksen met toegestane variabelen.

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

Een enkele aanhalingstekenreeks die gebruikmaakt van de ConvertFrom-StringData cmdlet:

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

Een tekenreeks met dubbele aanhalingstekens die gebruikmaakt van de ConvertFrom-StringData cmdlet:

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

Een gegevenssectie met een door de gebruiker geschreven cmdlet waarmee gegevens worden gegenereerd:

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

Zie ook