關於數據區段

發行項
05/09/2024

簡短描述

說明數據區段，這些區段會隔離文字字串和其他只讀數據與腳本邏輯。

完整描述

針對 PowerShell 設計的腳本可以有一或多個只包含數據的 Data 區段。您可以在任何文稿、函式或進階函式中包含一或多個數據區段。 [數據] 區段的內容僅限於 PowerShell 腳本語言的指定子集。

將數據與程式代碼邏輯分開，可讓您更輕鬆地識別和管理邏輯和數據。它可讓您針對文字有個別的字串資源檔，例如錯誤訊息和說明字串。它也會隔離程式代碼邏輯，以利安全性和驗證測試。

在 PowerShell 中，[數據] 區段用來支援腳本國際化。您可以使用 [數據] 區段，更輕鬆地隔離、尋找及處理將轉譯成許多使用者介面的字串， (UI) 語言。

[數據] 區段是 PowerShell 2.0 功能。沒有修訂的 PowerShell 1.0 中不會執行具有數據區段的腳本。

Syntax

Data 區段的語法如下所示：

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

需要 Data 關鍵詞。不區分大小寫。允許的內容僅限於下列元素：

所有 PowerShell 運算符除外 -match
If、 Else和 ElseIf 語句
下列自動變數：$PsCulture、、、$PsUICulture$True$False、和$Null
註解
Pipelines
以分號分隔的語句 (;)

常值，例如：

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

數據區段中允許的 Cmdlet。根據預設，只 ConvertFrom-StringData 允許 Cmdlet。
您可以使用參數，在 [數據] 區段中允許的 -SupportedCommand Cmdlet。

當您在 [數據] 區段中使用 ConvertFrom-StringData Cmdlet 時，可以將索引鍵/值組括在單引號或雙引號字串中，或是以單引號或雙引弧括住 here-strings。不過，包含變數和子表達式的字串必須以單引號字串或以單引弧括住，如此變數就不會展開，而且子表達式不是可執行的。

-SupportedCommand

參數 -SupportedCommand 可讓您指出 Cmdlet 或函式只會產生數據。其設計目的是允許使用者在撰寫或測試的數據區段中包含 Cmdlet 和函式。

的值 -SupportedCommand 是一或多個 Cmdlet 或函式名稱的逗號分隔清單。

例如，下列數據區段包含使用者寫入的 Cmdlet， Format-XML該 Cmdlet 會將 XML 檔案中的數據格式化：

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

使用數據區段

若要使用 [數據] 區段的內容，請將它指派給變數，並使用變數表示法來存取內容。

例如，下列數據區段包含可將 ConvertFrom-StringData here-string 轉換成哈希表的命令。哈希表會指派給 $TextMsgs 變數。

變數 $TextMsgs 不是數據區段的一部分。

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

若要存取中 $TextMsgs哈希表中的索引鍵和值，請使用下列命令。

$TextMsgs.Text001
$TextMsgs.Text002

或者，您可以將變數名稱放在 [資料] 區段的定義中。例如：

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

$TextMsgs

結果與上一個範例相同。

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

範例

簡單數據字串。

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

包含允許變數的字串。

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

使用 ConvertFrom-StringData Cmdlet 的單引號 here-string：

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

使用 Cmdlet 的 ConvertFrom-StringData 雙引號 here-string：

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

資料區段，其中包含產生資料的使用者撰寫 Cmdlet：

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

另請參閱

about_Automatic_Variables

about_Comparison_Operators

about_Script_Internationalization

ConvertFrom-StringData

Import-LocalizedData

共用方式為