通过

Import-PowerShellDataFile

模块:
Microsoft.PowerShell.Utility Module

从 .psd1 文件中导入值，而无需调用其内容。

语法

ByPath （默认值） 

Import-PowerShellDataFile
    [-Path] <String[]>
    [-SkipLimitCheck]
    [<CommonParameters>]

ByLiteralPath 

Import-PowerShellDataFile
    [-LiteralPath] <String[]>
    [-SkipLimitCheck]
    [<CommonParameters>]

说明

Import-PowerShellDataFile cmdlet 安全地从.psd1文件中定义的哈希表导入键值对。 可以使用文件内容的Invoke-Expression导入值。 但是，Invoke-Expression 运行文件中包含的任何代码。 这可能会生成不需要的结果或执行不安全的代码。 Import-PowerShellDataFile 导入数据而不调用代码。 默认情况下，密钥限制为 500，但可以使用 SkipLimitCheck 开关绕过此限制。

示例

示例 1：从 PSD1 检索值

此示例检索存储在 Configuration.psd1 文件中的哈希表中存储的键值对。 Get-Content 用于显示 Configuration.psd1 文件的内容。

Get-Content .\Configuration.psd1
$config = Import-PowerShellDataFile .\Configuration.psd1
$config.AllNodes

@{
    AllNodes = @(
        @{
            NodeName = 'DSC-01'
        }
        @{
            NodeName = 'DSC-02'
        }
    )
}

Name                           Value
----                           -----
NodeName                       DSC-01
NodeName                       DSC-02

参数

-LiteralPath

要导入的文件的路径。 路径中的所有字符都被视为文本值。 不处理通配符。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False
别名:PSPath, LP

参数集

ByLiteralPath
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-Path

要导入的文件的路径。 允许通配符，但仅导入第一个匹配文件。

参数属性

类型:

String[]

默认值:None
支持通配符:True
不显示:False

参数集

ByPath
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SkipLimitCheck

默认情况下，Import-PowerShellDataFile 仅从 .psd1 文件导入 500 个密钥。 使用 SkipLimitCheck 导入 500 多个密钥。

参数属性

类型:Switch
默认值:False
支持通配符:False
不显示:False

参数集

All
Position:0
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输出

Hashtable

此 cmdlet 以哈希表的形式返回文件中的数据。