다음을 통해 공유

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

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

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

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

예제

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

PS C:\> Get-FormatData -TypeName "*" | Export-FormatData -Path "allformat.ps1xml" -IncludeScriptBlock

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

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

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

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

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

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

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

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

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

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

PS C:\> Get-FormatData -TypeName "System.Diagnostics.Process" | Export-FormatData -Path process.format.ps1xml
PS C:\> Update-FormatData -PrependPath ".\process.format.ps1xml"
PS C:\> 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 매개 변수를 생략하는 효과를 보여줍니다.

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

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

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

세 번째 명령은 이 변경의 효과를 보여 줍니다. 이 명령은 Get-Process cmdlet을 사용하여 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 이외의 파일 이름 확장명을 사용하는 경우 Update-FormatData cmdlet에서 파일을 인식하지 않습니다.

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

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

입력

ExtendedTypeDefinition

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

출력

None

Export-FormatData 개체를 반환하지 않습니다. 파일을 생성하고 지정된 경로에 저장합니다.

참고

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