다음을 통해 공유

Update-FormatData

  • 참조
모듈:
Microsoft.PowerShell.Utility

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

구문

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

Description

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

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

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

PowerShell이 시작되면 PowerShell 소스 코드에서 형식 데이터를 로드합니다. 그러나 사용자 지정 format.ps1xml 파일을 만들어 현재 세션에서 서식을 업데이트할 수 있습니다. Update-FormatData 사용하여 PowerShell을 다시 시작하지 않고 서식 데이터를 현재 세션으로 다시 로드할 수 있습니다. 이는 서식 파일을 추가하거나 변경했지만 세션을 중단하지 않으려는 경우에 유용합니다.

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 파일을 추가하고 이러한 세션에서 테스트한 후 작성자가 파일을 편집합니다.

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

매개 변수

-AppendPath

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

.NET 개체의 서식을 지정할 때 PowerShell은 각 .NET 형식에 대해 찾은 첫 번째 서식 정의를 사용합니다. AppendPath 매개 변수를 사용하는 경우 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 개체의 서식을 지정할 때 PowerShell은 각 .NET 형식에 대해 찾은 첫 번째 서식 정의를 사용합니다. PrependPath 매개 변수를 사용하는 경우 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 명령을 실행하여 가져온 명령에 대한 서식 데이터를 업데이트할 수 있습니다. 모듈을 다시 가져올 필요가 없습니다.