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-FormatDataImport-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.

Type:Version
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TypeName

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Входные данные

None

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

Выходные данные

ExtendedTypeDefinition