次の方法で共有


Import-PowerShellDataFile

内容を呼び出さずに、 .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
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Path

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

型:String[]
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:True

-SkipLimitCheck

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

型:Switch
配置:0
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

出力

Hashtable

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