다음을 통해 공유

Update-FormatData

  • 참조
모듈:
Microsoft.PowerShell.Utility

현재 세션의 서식 데이터를 업데이트합니다.

구문

Update-FormatData
      [[-AppendPath] <String[]>]
      [-PrependPath <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

cmdlet은 Update-FormatData 서식 지정 파일에서 현재 세션으로 서식 지정 데이터를 다시 로드합니다. 이 cmdlet을 사용하면 PowerShell을 다시 시작하지 않고도 서식 데이터를 업데이트할 수 있습니다.

매개 변수 Update-FormatData 가 없으면 이전에 로드한 서식 파일을 다시 로드합니다. 매개 변수 Update-FormatData 를 사용하여 세션에 새 서식 파일을 추가할 수 있습니다.

서식 파일은 파일 이름 확장명을 가진 XML 형식의 format.ps1xml 텍스트 파일입니다. 파일의 서식 지정 데이터는 세션에서 Microsoft .NET Framework 개체의 표시를 정의합니다.

Windows PowerShell이 시작되면 PowerShell 설치 디렉터리($pshome)의 서식 파일에서 세션으로 형식 데이터를 로드합니다. PowerShell을 다시 시작하지 않고 서식 데이터를 현재 세션으로 다시 로드하는 데 사용할 Update-FormatData 수 있습니다. 이는 서식 파일을 추가하거나 변경했지만 세션을 중단하지 않으려는 경우에 유용합니다.

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

예제

예제 1: 이전에 로드한 서식 파일 다시 로드

Update-FormatData

이 명령은 이전에 로드한 서식 파일을 다시 로드합니다.

예제 2: 서식 파일 다시 로드 및 추적 및 로그 서식 지정 파일

Update-FormatData -AppendPath "trace.format.ps1xml, log.format.ps1xml"

이 명령은 두 개의 새 파일인 Trace.format.ps1xml 및 Log.format.ps1xml을 포함하여 서식 파일을 세션에 다시 로드합니다.

이 명령은 AppendPath 매개 변수를 사용하므로 새 파일의 서식 지정 데이터는 기본 제공 파일의 데이터 서식 지정 후에 로드됩니다.

AppendPath 매개 변수는 새 파일에 기본 제공 파일에서 참조되지 않는 개체에 대한 서식 데이터가 포함되어 있기 때문에 사용됩니다.

예제 3: 서식 파일 편집 및 다시 로드

Update-FormatData -PrependPath "c:\test\NewFiles.format.ps1xml"

# Edit the NewFiles.format.ps1 file.

Update-FormatData

이 예제에서는 서식 파일을 편집한 후 다시 로드하는 방법을 보여줍니다.

첫 번째 명령은 NewFiles.format.ps1xml 파일을 세션에 추가합니다. 파일에 기본 제공 파일에서 참조되는 개체에 대한 서식 데이터가 포함되어 있으므로 PrependPath 매개 변수를 사용합니다.

NewFiles.format.ps1xml 파일을 추가하고 이러한 세션에서 테스트한 후 작성자가 파일을 편집합니다.

두 번째 명령은 cmdlet을 Update-FormatData 사용하여 서식 파일을 다시 로드합니다. NewFiles.format.ps1xml 파일이 이전에 로드되었 Update-FormatData 으므로 매개 변수를 사용하지 않고 자동으로 다시 로드합니다.

매개 변수

-AppendPath

이 cmdlet이 세션에 추가하는 서식 파일을 지정합니다. PowerShell에서 기본 제공 서식 파일을 로드한 후 파일이 로드됩니다.

.NET 개체의 서식을 지정할 때 Windows PowerShell은 각 .NET 형식에 대해 찾은 첫 번째 서식 정의를 사용합니다. AppendPath 매개 변수를 사용하는 경우 추가하려는 서식 데이터가 발견되기 전에 Windows PowerShell에서 기본 제공 파일의 데이터를 검색합니다.

이 매개 변수를 사용하여 기본 제공 서식 파일에서 참조되지 않는 .NET 개체의 서식을 지정하는 파일을 추가합니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-PrependPath

이 cmdlet이 세션에 추가하는 서식 파일을 지정합니다. PowerShell에서 기본 제공 서식 파일을 로드하기 전에 파일이 로드됩니다.

.NET 개체의 서식을 지정할 때 Windows PowerShell은 각 .NET 형식에 대해 찾은 첫 번째 서식 정의를 사용합니다. PrependPath 매개 변수를 사용하는 경우 Windows PowerShell은 기본 제공 파일에서 서식 지정 데이터가 발생하기 전에 추가 중인 파일에서 데이터를 검색합니다.

이 매개 변수를 사용하여 기본 제공 서식 파일에서도 참조되는 .NET 개체의 서식을 지정하는 파일을 추가합니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

String

이 cmdlet에 추가 경로가 포함된 문자열을 파이프할 수 있습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다.

참고

  • Update-FormatData 또한 모듈에서 가져온 세션의 명령에 대한 서식 데이터를 업데이트합니다. 모듈의 서식 파일이 변경되면 명령을 실행 Update-FormatData 하여 가져온 명령에 대한 서식 데이터를 업데이트할 수 있습니다. 모듈을 다시 가져올 필요가 없습니다.