다음을 통해 공유

Get-FormatData

  • 참조
모듈:
Microsoft.PowerShell.Utility

현재 세션의 서식 데이터를 가져옵니다.

구문

Get-FormatData
   [[-TypeName] <String[]>]
   [-PowerShellVersion <Version>]
   [<CommonParameters>]

Description

cmdlet은 Get-FormatData 현재 세션의 서식 데이터를 가져옵니다.

세션의 서식 지정 데이터에는 디렉터리에 있는 $PSHOME 파일과 같은 서식 파일의 Format.ps1xml 데이터 서식 지정, 세션으로 가져오는 모듈의 데이터 서식 지정, cmdlet을 사용하여 Import-PSSession 세션으로 가져오는 명령에 대한 데이터 서식 지정이 포함됩니다.

이 cmdlet을 사용하여 서식 데이터를 검사할 수 있습니다. 그런 다음 cmdlet을 Export-FormatData 사용하여 개체를 직렬화하고 XML로 변환한 다음 파일에 저장할 수 있습니다 Format.ps1xml .

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

예제

예제 1: 모든 서식 데이터 가져오기

이 예제에서는 세션의 모든 서식 데이터를 가져옵니다.

Get-FormatData

예제 2: 형식 이름으로 서식 데이터 가져오기

이 예제에서는 이름이 .로 System.Management.Automation.Cmd시작하는 서식 지정 데이터 항목을 가져옵니다.

Get-FormatData -TypeName 'System.Management.Automation.Cmd*'

예제 3: 서식 데이터 개체 검사

이 예제에서는 형식 지정 데이터 개체를 가져오고 해당 속성을 검사하는 방법을 보여 줍니다.

$F = Get-FormatData -TypeName 'System.Management.Automation.Cmd*'
$F

TypeName        FormatViewDefinition
--------        --------------------
HelpInfoShort   {help , TableControl}

$F.FormatViewDefinition[0].control

Headers          : {System.Management.Automation.TableControlColumnHeader,
                   System.Management.Automation.TableControlColumnHeader,
                   System.Management.Automation.TableControlColumnHeader,
                   System.Management.Automation.TableControlColumnHeader}
Rows             : {System.Management.Automation.TableControlRow}
AutoSize         : False
HideTableHeaders : False
GroupBy          :
OutOfBand        : False

$F.FormatViewDefinition[0].control.Headers

Label       Alignment Width
-----       --------- -----
CommandType Undefined    15
Name        Undefined    50
Version     Undefined    10
Source      Undefined     0

예제 4: 서식 데이터 가져오기 및 내보내기

이 예제에서는 모듈에서 추가한 서식 데이터를 사용하고 Get-FormatData Export-FormatData 내보내는 방법을 보여 있습니다.

$A = Get-FormatData
Import-Module bitstransfer
$B = Get-FormatData
Compare-Object $A $B

InputObject                                                SideIndicator
-----------                                                -------------
Microsoft.BackgroundIntelligentTransfer.Management.BitsJob =>

Get-FormatData *bits* | Export-FormatData -FilePath c:\test\bits.format.ps1xml
Get-Content c:\test\bits.format.ps1xml

<?xml version="1.0" encoding="utf-8"?><Configuration><ViewDefinitions>
<View><Name>Microsoft.BackgroundIntelligentTransfer.Management.BitsJob</Name>
...

처음 네 개의 명령은 , Import-Module및 Compare-Object cmdlet을 사용하여 Get-FormatDataBitsTransfer 모듈이 세션에 추가하는 형식 형식을 식별합니다.

다섯 번째 명령은 cmdlet을 사용하여 Get-FormatData BitsTransfer 모듈이 추가하는 형식 형식을 가져옵니다. 파이프라인 연산자(|)를 사용하여 형식 형식 개체를 Export-FormatData cmdlet으로 보내면 다시 XML로 변환되고 지정된 format.ps1xml 파일에 저장됩니다.

마지막 명령은 파일 콘텐츠의 발췌를 format.ps1xml 보여줍니다.

예제 5: 지정된 버전의 PowerShell을 기반으로 서식 지정 데이터 가져오기

이 예제에서는 지정된 TypeName 및 PowerShell 버전에 대한 형식 데이터를 가져오는 데 사용하는 Get-FormatData 방법을 보여줍니다.

Get-FormatData -TypeName 'Microsoft.Powershell.Utility.FileHash' -PowerShellVersion $PSVersionTable.PSVersion

TypeNames                               FormatViewDefinition
---------                               --------------------
{Microsoft.Powershell.Utility.FileHash} {Microsoft.Powershell.Utility.FileHash}

Important

전체 형식 서식 지정 정보가 반환되도록 하려면 항상 PowerShellVersion 매개 변수를 적절한 버전에 포함해야 합니다. 매개 변수와 값을 생략하면 올바른 형식 정보를 모두 얻지 못할 수 있습니다.

매개 변수

-PowerShellVersion

서식 지정 데이터에 대해 이 cmdlet이 가져오는 PowerShell 버전을 지정합니다. 마침표로 구분된 두 자리 숫자를 입력합니다.

이 매개 변수는 이전 버전의 PowerShell을 실행하는 컴퓨터를 원격으로 실행할 때 호환성을 향상시키기 위해 PowerShell 5.1에 추가되었습니다.

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

-TypeName

이 cmdlet이 서식 지정 데이터에 대해 가져오는 형식 이름을 지정합니다. 형식 이름을 입력합니다. 와일드카드가 허용됩니다.

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

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

ExtendedTypeDefinition