Import-PowerShellDataFile

  • リファレンス
モジュール:
Microsoft.PowerShell.Utility

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

構文

Import-PowerShellDataFile
      [[-Path] <string[]>]
      [<CommonParameters>]
Import-PowerShellDataFile
      [-LiteralPath <string[]>]
      [<CommonParameters>]

説明

このコマンドレットは Import-PowerShellDataFile 、ファイルで定義されているハッシュテーブルからキーと値のペアを安全に .PSD1 インポートします。 値は、ファイルの内容を使用して Invoke-Expression インポートできます。 ただし、 Invoke-Expression ファイルに含まれるすべてのコードを実行します。 これにより、望ましくない結果が生成されたり、安全でないコードが実行されたりする可能性があります。 Import-PowerShellDataFile は、コードを呼び出さずにデータをインポートします。

Note

最初の 500 個のキーと値のペアのみをインポートできます。

例

例 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:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

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

出力

Hashtable

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