导入 PowerShellDataFile (Microsoft.PowerShell.Utility)

导入 PowerShellDataFile

模块 ：

Microsoft.PowerShell.Utility

从 .PSD1 文件导入值而不调用其内容。

句法

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

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[]

别名：

PSPath, LP

位置：

0

默认值：

None

必需的：

True

接受管道输入：

True

接受通配符：

False

-Path

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

类型 ：

String[]

位置：

0

默认值：

None

必需的：

True

接受管道输入：

False

接受通配符：

True

-SkipLimitCheck

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

类型 ：

开关

位置：

0

默认值：

False

必需的：

False

接受管道输入：

False

接受通配符：

False

输出

哈希表

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