다음을 통해 공유

Import-PowerShellDataFile

모듈:
Microsoft.PowerShell.Utility Module

콘텐츠를 호출하지 않고 .psd1 파일에서 값을 가져옵니다.

구문

ByPath (기본값) 

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

ByLiteralPath 

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

Description

Import-PowerShellDataFile cmdlet은 .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[]

Default value:None
와일드카드 지원:False
DontShow:False
별칭:PSPath, Lp 로

매개 변수 집합

ByLiteralPath
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Path

가져올 파일의 경로입니다. 와일드카드는 허용되지만 일치하는 첫 번째 파일만 가져옵니다.

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:True
DontShow:False

매개 변수 집합

ByPath
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SkipLimitCheck

기본적으로 Import-PowerShellDataFile.psd1 파일에서 500개의 키만 가져옵니다. SkipLimitCheck 사용하여 500개 이상의 키를 가져옵니다.

매개 변수 속성

형식:Switch
Default value:False
와일드카드 지원:False
DontShow:False

매개 변수 집합

All
Position:0
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

출력

Hashtable

이 cmdlet은 파일의 데이터를 해시 테이블로 반환합니다.