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

Путь к импортируемму файлу. Все символы в пути рассматриваются как литеральные значения. Дикие карта символы не обрабатываются.

Type:String[]
Aliases:PSPath, LP
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-SkipLimitCheck

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

Type:Switch
Position:0
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

Hashtable

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