Import-PowerShellDataFile

  • 참조
모듈:
Microsoft.PowerShell.Utility

해당 내용을 호출하지 않고 파일에서 .PSD1 값을 가져옵니다.

Syntax

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

Description

cmdlet은 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

가져올 파일의 경로입니다. 경로의 모든 문자는 리터럴 값으로 처리됩니다. 와일드카드 문자는 처리되지 않습니다.

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

-Path

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

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

-SkipLimitCheck

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

Type:Switch
Position:0
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

출력

Hashtable

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