Import-PowerShellDataFile (Microsoft.PowerShell.Utility)

Импорт-PowerShellDataFile

Модуль:: Microsoft.PowerShell.Utility

Импортирует значения из файла .PSD1, не вызывая его содержимое.

Синтаксис

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

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

Описание

Командлет Import-PowerShellDataFile безопасно импортирует пары «ключ-значение» из хэш-таблиц, определенных в файле .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 импортирует только 500 ключей из файла .psd1. Используйте SkipLimitCheck, чтобы импортировать более 500 ключей.

Тип :: Переключатель
Позиция:: 0
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

Выходы

Хеш-таблица

Этот командлет возвращает данные из файла в виде хеш-таблицы.