Поделиться через

Import-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[]
Aliases:PSPath, LP
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Path

Путь к импортируемму файлу. Подстановочные знаки разрешены, но импортируются только первый соответствующий файл.

Тип:String[]
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-SkipLimitCheck

По умолчанию Import-PowerShellDataFile импортирует только 500 ключей .psd1 из файла. Используйте SkipLimitCheck для импорта более 500 ключей.

Тип:Switch
Position:0
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Выходные данные

Hashtable

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