about_Script_Internationalization

Korte beschrijving

Beschrijft de internationalisatiefuncties van scripts waarmee scripts eenvoudig berichten en instructies kunnen weergeven voor gebruikers in hun gebruikersinterfacetaal (UI).

Lange beschrijving

Met de internationalisatiefuncties van PowerShell-scripts kunt u gebruikers overal ter wereld beter bedienen door help- en gebruikersberichten weer te geven in de taal van de gebruiker.

De internationalisatiefuncties van het script voeren een query uit op de UI-cultuur van het besturingssysteem tijdens de uitvoering, importeren van de juiste vertaalde teksttekenreeksen en deze weergeven aan de gebruiker. Met de sectie Gegevens kunt u tekenreeksen los van code opslaan, zodat ze eenvoudig kunnen worden geïdentificeerd en geëxtraheerd. Een nieuwe cmdlet, ConvertFrom-StringDataconverteert teksttekenreeksen naar woordenlijstachtige hashtabellen om vertaling te vergemakkelijken.

PowerShell bevat de volgende functies om internationale Help-tekst te ondersteunen:

  • Een gegevenssectie die teksttekenreeksen scheidt van code-instructies. Zie about_Data_Sections voor meer informatie over de sectie Gegevens.

  • Nieuwe automatische variabelen en $PSCulture$PSUICulture. $PSCulture slaat de naam op van de taal van de gebruikersinterface die in het systeem wordt gebruikt voor elementen zoals de datum, tijd en valuta. De $PSUICulture variabele slaat de naam op van de ui-taal die wordt gebruikt in het systeem voor elementen van de gebruikersinterface, zoals menu's en tekenreeksen.

  • Een cmdlet, ConvertFrom-StringDatawaarmee teksttekenreeksen worden geconverteerd naar hashtabellen in woordenlijstachtige hashtabellen om vertaling mogelijk te maken. Zie ConvertFrom-StringData voor meer informatie.

  • Een nieuw bestandstype, .psd1waarin vertaalde teksttekenreeksen worden opgeslagen. De .psd1 bestanden worden opgeslagen in taalspecifieke submappen van de scriptmap.

  • Een cmdlet, Import-LocalizedDatawaarmee vertaalde teksttekenreeksen voor een opgegeven taal tijdens runtime worden geïmporteerd in een script. Met deze cmdlet worden tekenreeksen herkend en geïmporteerd in elke door Windows ondersteunde taal. Zie Import-LocalizedData voor meer informatie.

De sectie Gegevens: standaardtekenreeksen opslaan

Gebruik een sectie Gegevens in het script om de tekenreeksen in de standaardtaal op te slaan. Rangschik de tekenreeksen in sleutel-/waardeparen in een hier-tekenreeks. Elk sleutel-waardepaar moet zich op een afzonderlijke regel bevinden. Als u opmerkingen opneemt, moeten de opmerkingen op afzonderlijke regels staan.

Met ConvertFrom-StringData de cmdlet worden de sleutel-/waardeparen in de hier-tekenreeks geconverteerd naar een hash-tabel die is opgeslagen in de waarde van de sectievariabele Gegevens.

In het volgende voorbeeld bevat de sectie Gegevens van het World.ps1 script de set English-United Staten (en-US) met promptberichten voor een script. De ConvertFrom-StringData cmdlet converteert de tekenreeksen naar een hash-tabel en slaat deze op in de $msgtable variabele.

$msgTable = Data {
    #culture="en-US"
    ConvertFrom-StringData @'
    helloWorld = Hello, World.
    errorMsg1 = You cannot leave the user name field blank.
    promptMsg = Please enter your user name.
'@
}

Zie about_Quoting_Rules voor meer informatie over hier-tekenreeksen.

PSD1-bestanden: vertaalde tekenreeksen opslaan

Sla de scriptberichten voor elke UI-taal op in afzonderlijke tekstbestanden met dezelfde naam als het script en de .psd1 bestandsnaamextensie. Sla de bestanden op in submappen van de scriptmap met namen van culturen in de volgende indeling:

<language>-<region>

Voorbeelden: de-DE, ar-SA en zh-Hans

Als het World.ps1 script bijvoorbeeld is opgeslagen in de C:\Scripts map, maakt u een bestandsmapstructuur die er ongeveer als volgt uitziet:

C:\Scripts
C:\Scripts\World.ps1
C:\Scripts\de-DE\World.psd1
C:\Scripts\ar-SA\World.psd1
C:\Scripts\zh-CN\World.psd1
...

Het World.psd1 bestand in de submap de-DE van de scriptmap kan de volgende instructie bevatten:

ConvertFrom-StringData -StringData @'
helloWorld = Hallo, Welt.
errorMsg1 = Das Feld Benutzername darf nicht leer sein.
promptMsg = Geben Sie Ihren Benutzernamen ein.
'@

Op dezelfde manier kan het World.psd1 bestand in de submap ar-SA van de scriptmap de volgende instructie bevatten:

ConvertFrom-StringData -StringData @'
helloWorld = مرحبًا أيها العالَم
errorMsg1 = لا يمكنك ترك حقل اسم المستخدم فارغًا
promptMsg = يرجى إدخال اسم المستخدم الخاص بك
'@

Import-LocalizedData: Dynamisch ophalen van vertaalde tekenreeksen

Gebruik de Import-LocalizedData cmdlet om de tekenreeksen op te halen in de gebruikersinterfacetaal van de huidige gebruiker.

Import-LocalizedData zoekt de waarde van de $PSUICulture automatische variabele en importeert de inhoud van de <script-name>.psd1 bestanden in de submap die overeenkomt met de $PSUICulture waarde. Vervolgens wordt de geïmporteerde inhoud opgeslagen in de variabele die is opgegeven met de waarde van de parameter BindingVariable .

Import-LocalizedData -BindingVariable msgTable

Als de Import-LocalizedData opdracht bijvoorbeeld wordt weergegeven in het C:\Scripts\World.ps1 script en de waarde $PSUICulture 'ar-SA' is, Import-LocalizedData zoekt u het volgende bestand:

C:\Scripts\ar-SA\World.psd1

Vervolgens worden de Arabische tekenreeksen uit het bestand geïmporteerd in de $msgTable variabele, waarbij alle standaardtekenreeksen worden vervangen die kunnen worden gedefinieerd in de sectie Gegevens van het World.ps1 script.

Als het script de $msgTable variabele gebruikt om gebruikersberichten weer te geven, worden de berichten in het Arabisch weergegeven.

In het volgende script wordt bijvoorbeeld het bericht 'Geef uw gebruikersnaam op' in het Arabisch weergegeven:

if (!($username)) { $msgTable.promptMsg }

Als Import-LocalizedData er geen .psd1 bestand kan worden gevonden dat overeenkomt met de waarde van$PSUIculture$msgTable, wordt de waarde niet vervangen en wordt de aanroep om de terugvaltekenreeksen en-US weer te $msgTable.promptMsg geven.

Voorbeelden

In dit voorbeeld ziet u hoe de internationalisatiefuncties van het script worden gebruikt in een script om een dag van de week weer te geven aan gebruikers in de taal die op de computer is ingesteld.

Hier volgt een volledige lijst van het Sample1.ps1 scriptbestand.

Het script begint met een sectie Gegevens met de naam Dag ($Day) die een ConvertFrom-StringData opdracht bevat. De expressie waarnaar wordt verzonden ConvertFrom-StringData , is een hier-tekenreeks die de dagnamen bevat in de standaard-UI-cultuur, en-US, in sleutel-/waardeparen. De ConvertFrom-StringData cmdlet converteert de sleutel-waardeparen in de hier-tekenreeks naar een hash-tabel en slaat deze vervolgens op in de waarde van de $Day variabele.

De Import-LocalizedData opdracht importeert de inhoud van het .psd1 bestand in de map die overeenkomt met de waarde van de $PSUICulture automatische variabele en slaat deze vervolgens op in de $Day variabele, waarbij de waarden worden vervangen die $Day zijn gedefinieerd in de sectie Gegevens.

De resterende opdrachten laden de tekenreeksen in een matrix en geven ze weer.

$Day = Data {
#culture="en-US"
ConvertFrom-StringData -StringData @'
    messageDate = Today is
    d0 = Sunday
    d1 = Monday
    d2 = Tuesday
    d3 = Wednesday
    d4 = Thursday
    d5 = Friday
    d6 = Saturday
'@
}

Import-LocalizedData -BindingVariable Day

#Build an array of weekdays.
$a = $Day.d0, $Day.d1, $Day.d2, $Day.d3, $Day.d4, $Day.d5, $Day.d6

# Get the day of the week as a number (Monday = 1).
# Index into $a to get the name of the day.
# Use string formatting to build a sentence.

"{0} {1}" -f $Day.messageDate, $a[(Get-Date -UFormat %u)] | Out-Host

De .psd1 bestanden die het script ondersteunen, worden opgeslagen in submappen van de scriptmap met namen die overeenkomen met de $PSUICulture waarden.

Hier volgt een volledige lijst met .\de-DE\sample1.psd1:

# culture="de-DE"
ConvertFrom-StringData @'
    messageDate = Heute ist
    d0 = Sonntag
    d1 = Montag
    d2 = Dienstag
    d3 = Mittwoch
    d4 = Donnerstag
    d5 = Freitag
    d6 = Samstag
'@

Als u Sample.ps1 uitvoert op een systeem waarvan de waarde $PSUICulture de-DE is, is de uitvoer van het script:

Heute ist Freitag

Zie ook