次の方法で共有

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

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