Import-PowerShellDataFile

モジュール:

Microsoft.PowerShell.Utility Module

内容を呼び出さずに、.psd1 ファイルから値をインポートします。

構文

ByPath (既定)

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

ByLiteralPath

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[]
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False
Aliases:	PSPath, LP

パラメーター セット

ByLiteralPath

配置:	0
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	True
残りの引数からの値:	False

-Path

インポートするファイルへのパス。 ワイルドカードは使用できますが、最初に一致するファイルのみがインポートされます。

パラメーターのプロパティ

型:	String[]
規定値:	None
ワイルドカードのサポート:	True
DontShow:	False

パラメーター セット

ByPath

配置:	0
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-SkipLimitCheck

既定では、Import-PowerShellDataFile は .psd1 ファイルから 500 個のキーのみをインポートします。 SkipLimitCheck 使用して、500 を超えるキーをインポートします。

パラメーターのプロパティ

型:	Switch
規定値:	False
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

All

配置:	0
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

出力

Hashtable

このコマンドレットは、ファイルのデータをハッシュ テーブルとして返します。

関連リンク

• Invoke-Expression
• Import-LocalizedData
• データファイルについて