Get-FormatData

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

Командлет Get-FormatData получает данные форматирования в текущем сеансе.

Данные форматирования в сеансе включают в себя форматирование данных из файлов форматирования Format.ps1xml, например, находящихся в каталоге $PSHOME, а также форматирование данных для модулей, которые вы импортируете в сеанс, и для команд, которые вы импортируете в сеанс с помощью командлета Import-PSSession.

Этот командлет можно использовать для проверки данных форматирования. Затем можно использовать командлет Export-FormatData для сериализации объектов, преобразования их в XML и их сохранения в Format.ps1xml файлах.

Дополнительные сведения о форматировании файлов в PowerShell см. в about_Format.ps1xml.

Этот пример получает все данные форматирования в рамках сеанса.

Get-FormatData

В этом примере возвращаются данные форматирования, имена которых начинаются с System.Management.Automation.Cmd.

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

В этом примере показано, как получить объект данных форматирования и проверить его свойства.

$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

В этом примере показано, как использовать 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>
...

Первые четыре команды используют командлеты , и для определения типа формата, который модуль BitsTransfer добавляет в сеанс.

Пятая команда использует командлет Get-FormatData для получения типа формата, который добавляет модуль BitsTransfer. Он использует оператор конвейера (|) для отправки объекта типа формата в командлет Export-FormatData, который преобразует его обратно в XML и сохраняет его в указанном Bits.format.ps1xml файле.

Последняя команда содержит фрагмент содержимого файла format.ps1xml.

В этом примере показано, как использовать Get-FormatData для получения данных формата для указанного TypeName и версии PowerShell.

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

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

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Невозможно передать объекты в этот командлет.