다음을 통해 공유


Update-FormatData

현재 세션에 있는 형식 지정 데이터를 업데이트합니다.

구문

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

설명

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

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

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

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

Windows PowerShell의 형식 지정 파일에 대한 자세한 내용은 about_Format.ps1xml을 참조하십시오.

매개 변수

-AppendPath <string[]>

지정된 형식 지정 파일을 세션에 추가합니다. 이 파일은 Windows PowerShell에서 기본 제공 형식 지정 파일을 로드한 이후에 로드됩니다.

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

이 매개 변수를 사용하면 기본 형식 지정 파일에서 참조되지 않는 .NET 개체의 형식을 지정하는 파일을 추가할 수 있습니다.

필수 여부

false

위치

1

기본값

파이프라인 입력 적용 여부

true (ByValue, ByPropertyName)

와일드카드 문자 적용 여부

false

-PrependPath <string[]>

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

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

이 매개 변수를 사용하면 기본 형식 지정 파일에서도 참조되는 .NET 개체의 형식을 지정하는 파일을 추가할 수 있습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Confirm

명령을 실행하기 전에 확인 메시지를 표시합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-WhatIf

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.String

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

출력

없음

이 cmdlet은 어떠한 출력도 반환하지 않습니다.

참고

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

예 1

C:\PS>update-formatdata

설명
-----------
이 명령은 이전에 로드한 형식 지정 파일을 다시 로드합니다.





예 2

C:\PS>update-formatdata -appendpath trace.format.ps1xml, log.format.ps1xml

설명
-----------
이 명령은 두 개의 새 파일 Trace.format.ps1xml 및 Log.format.ps1xml을 비롯한 형식 지정 파일을 세션으로 다시 로드합니다. 

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

새 파일에 기본 제공 파일에서 참조되지 않은 개체에 대한 형식 지정 데이터가 포함되어 있으므로 AppendPath 매개 변수를 사용합니다.





예 3

C:\PS>update-formatdata -prependPath c:\test\NewFiles.format.ps1xml

# Edit the NewFiles.format.ps1 file.

C:\PS> update-formatdata

설명
-----------
이 예에서는 형식 지정 파일을 편집한 후 다시 로드하는 방법을 보여 줍니다.

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

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

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