다음을 통해 공유

Export-FormatData

  • 참조
모듈:
Microsoft.PowerShell.Utility

현재 세션의 형식 지정 데이터를 형식 지정 파일에 저장합니다.

구문

Export-FormatData
      -InputObject <ExtendedTypeDefinition[]>
      -Path <String>
      [-Force]
      [-NoClobber]
      [-IncludeScriptBlock]
      [<CommonParameters>]
Export-FormatData
      -InputObject <ExtendedTypeDefinition[]>
      -LiteralPath <String>
      [-Force]
      [-NoClobber]
      [-IncludeScriptBlock]
      [<CommonParameters>]

Description

cmdlet은 Export-FormatData 현재 세션의 서식 개체에서 Windows PowerShell 서식 파일(format.ps1xml)을 만듭니다. XML 형식으로 파일을 반환하고 저장하는 ExtendedTypeDefinition 개체 Get-FormatData 를 사용합니다.

Windows PowerShell은 형식 지정 파일(format.ps1xml)의 데이터를 사용하여 세션에 있는 Microsoft .NET Framework 개체의 기본 표시를 생성합니다. 사용자는 형식 지정 파일을 보고 편집할 수 있으며 Update-FormatData cmdlet을 사용하여 세션에 형식 지정 데이터를 추가할 수 있습니다.

Windows PowerShell에서 파일 서식 지정에 대한 자세한 내용은 about_Format.ps1xml을 참조 하세요.

예제

예제 1: 세션 형식 데이터 내보내기

Get-FormatData -TypeName "*" | Export-FormatData -Path "allformat.ps1xml" -IncludeScriptBlock

이 명령은 세션의 모든 형식 데이터를 AllFormat.ps1xml 파일로 내보냅니다.

이 명령은 cmdlet을 Get-FormatData 사용하여 세션의 형식 데이터를 가져옵니다. TypeName 매개 변수에 * 대한 값(모두)은 cmdlet이 세션의 모든 데이터를 가져올 수 있도록 지시합니다.

이 명령은 파이프라인 연산자(|)를 사용하여 명령에서 Get-FormatData cmdlet으로 Export-FormatData 형식 데이터를 보내고, 이 cmdlet은 형식 데이터를 AllFormat.ps1 파일로 내보냅니다.

이 Export-FormatData 명령은 IncludeScriptBlock 매개 변수를 사용하여 파일의 형식 데이터에 스크립트 블록을 포함합니다.

예제 2: 형식에 대한 형식 데이터 내보내기

$F = Get-FormatData -TypeName "helpinfoshort"
Export-FormatData -InputObject $F -Path "c:\test\help.format.ps1xml" -IncludeScriptBlock

이러한 명령은 HelpInfoShort 형식의 형식 데이터를 Help.format.ps1xml 파일로 내보냅니다.

첫 번째 명령은 cmdlet을 사용하여 Get-FormatData HelpInfoShort 형식에 대한 형식 데이터를 가져와 변수에 $F 저장합니다.

두 번째 명령은 cmdlet의 Export-FormatData InputObject 매개 변수를 사용하여 변수에 $F 저장된 형식 데이터를 입력합니다. 또한 IncludeScriptBlock 매개 변수를 사용하여 출력에 스크립트 블록을 포함합니다.

예제 3: 스크립트 블록 없이 형식 데이터 내보내기

Get-FormatData -TypeName "System.Diagnostics.Process" | Export-FormatData -Path process.format.ps1xml
Update-FormatData -PrependPath ".\process.format.ps1xml"
Get-Process p*

Handles  NPM(K)  PM(K)  WS(K) VM(M)   CPU(s)    Id ProcessName
-------  ------  -----  ----- -----   ------    -- -----------
323                                       5600 powershell
336                                       3900 powershell_ise
138                                       4076 PresentationFontCache

이 예제에서는 명령에서 Export-FormatData IncludeScriptBlock 매개 변수를 생략하는 효과를 보여줍니다.

첫 번째 명령은 cmdlet을 Get-FormatData 사용하여 Get-Process cmdlet이 반환하는 System.Diagnostics.Process 개체의 형식 데이터를 가져옵니다. 이 명령은 파이프라인 연산자(|)를 사용하여 형식 지정 데이터를 Export-FormatData cmdlet으로 보내 현재 디렉터리의 Process.format.ps1xml 파일로 내보냅니다.

이 경우 Export-FormatData 명령은 IncludeScriptBlock 매개 변수를 사용하지 않습니다.

두 번째 명령은 cmdlet을 Update-FormatData 사용하여 Process.format.ps1xml 파일을 현재 세션에 추가합니다. 이 명령은 PrependPath 매개 변수를 사용하여 Process.format.ps1xml 파일의 프로세스 개체에 대한 서식 지정 데이터가 프로세스 개체의 표준 서식 데이터 앞에 있는지 확인합니다.

세 번째 명령은 이 변경의 효과를 보여 줍니다. 이 명령은 cmdlet을 Get-Process 사용하여 P로 시작하는 이름을 가진 프로세스를 가져옵니다. 출력은 스크립트 블록을 사용하여 계산된 속성 값이 디스플레이에서 누락되었음을 보여 줍니다.

매개 변수

-Force

사용자 확인을 요청하지 않고 명령을 강제 실행합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IncludeScriptBlock

형식 데이터의 스크립트 블록을 내보낼지 여부를 나타냅니다.

스크립트 블록은 코드를 포함하며 악의적으로 사용할 수 있으므로 기본적으로 내보내지 않습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

내보낼 형식 데이터 개체를 지정합니다. 개체 또는 명령과 같은 개체를 가져오는 명령이 포함된 변수를 Get-FormatData 입력합니다. 개체를 .로 Get-FormatData 파이프할 Export-FormatData수도 있습니다.

형식:ExtendedTypeDefinition[]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-LiteralPath

출력 파일의 위치를 지정합니다. Path 매개 변수와 달리 LiteralPath의 값은 입력된 대로 정확하게 사용됩니다. 와일드카드로 해석되는 문자는 없습니다. 경로에 이스케이프 문자가 포함된 경우 작은따옴표로 묶습니다. 작은따옴표는 Windows PowerShell에 문자를 이스케이프 시퀀스로 해석하지 않도록 지시합니다.

형식:String
별칭:PSPath
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NoClobber

cmdlet이 기존 파일을 덮어쓰지 않음을 나타냅니다. 기본적으로 Export-FormatData 파일에 읽기 전용 특성이 없는 한 경고 없이 파일을 덮어씁니다.

Export-FormatData 읽기 전용 파일을 덮어쓰도록 하려면 Force 매개 변수를 사용합니다.

형식:SwitchParameter
별칭:NoOverwrite
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Path

출력 파일의 위치를 지정합니다. 파일 이름 확장명이 format.ps1xml인 파일 이름과 경로(선택 사항)를 입력합니다. 경로를 Export-FormatData 생략하면 현재 디렉터리에 파일을 만듭니다.

.ps1xml 이외의 파일 이름 확장명을 사용하는 경우 cmdlet은 Update-FormatData 파일을 인식하지 않습니다.

기존 파일을 지정하는 경우 파일에 Export-FormatData 읽기 전용 특성이 없는 한 경고 없이 파일을 덮어씁니다. 읽기 전용 파일을 덮어쓰려면 Force 매개 변수를 사용합니다. 파일을 덮어쓰지 않도록 하려면 NoClobber 매개 변수를 사용합니다.

형식:String
별칭:FilePath
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

ExtendedTypeDefinition

ExtendedTypeDefinition 개체를 이 cmdlet으로 Get-FormatData 파이프할 수 있습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다. 파일을 생성하여 지정된 경로에 저장합니다.

참고

  • 내보낸 서식 파일을 포함하여 서식 파일을 사용하려면 세션의 실행 정책에서 스크립트 및 구성 파일을 실행할 수 있도록 허용해야 합니다. 자세한 내용은 about_Execution_Policies를 참조하세요.