Get-FormatData (Microsoft.PowerShell.Utility)

Get-FormatData

Модуль:

Microsoft.PowerShell.Utility

Получает данные форматирования в текущем сеансе.

Синтаксис

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

Описание

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

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

Этот командлет можно использовать для проверки данных форматирования. Затем вы можете использовать командлет 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>
...

Первые четыре команды используют командлеты Get-FormatData, Import-Module и Compare-Object для определения типа формата, который Модуль BitsTransfer добавляет в сессию.

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

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

Пример 5. Получение данных форматирования на основе указанной версии PowerShell.

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

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

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

Параметры

-PowerShellVersion

Укажите версию PowerShell, которую этот командлет получит для данных форматирования. Введите двузначное число, разделенное точкой.

Этот параметр был добавлен в PowerShell 5.1 для улучшения совместимости при удаленном удалении компьютеров, на которых работают более старые версии PowerShell.

Тип :

Версия

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-TypeName

Указывает имена типов, которые этот командлет получает для данных форматирования. Введите имена типов. Подстановочные знаки разрешены.

Тип :

String[]

Позиция:

0

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

True

Входы

Нет

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

Выходы

Определение расширенного типа