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

Синтаксис

Get-FormatData [[-TypeName] <string[]>] [<CommonParameters>]

Описание

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

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

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

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

Параметры

-TypeName <string[]>

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

Обязательно?

false

Позиция?

1

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

Принимать входные данные из конвейера?

false

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

true

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

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

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

None

Передать входные данные этому командлету по конвейеру невозможно.

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

System.Management.Automation.ExtendedTypeDefinition

Пример 1

C:\PS>get-formatdata

Описание
-----------
Эта команда возвращает все данные форматирования в текущем сеансе.






Пример 2

C:\PS>get-formatdata -typename Microsoft.Wsman*

Описание
-----------
Эта команда возвращает элементы данных форматирования с именами, начинающимися с "Microsoft.Wsman".






Пример 3

C:\PS>$f = get-formatdata -typename helpinfoshort

C:\PS> $f 

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

C:\PS> $f.FormatViewDefinition[0].control

Headers																	Rows
-------																	----
{System.Management.Automation.TableControlColumnHeader, System.Manageme... {System.Management.Automation.TableControlRow}


C:\PS> $f.FormatViewDefinition[0].control.headers

Label		 Alignment	Width
-----		 ---------	-----
Name		Left		 33
Category	Left		 9
			Undefined	0

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






Пример 4

C:\PS>$a = get-formatdata

C:\PS> import-module bitstransfer
C:\PS> $b = get-formatdata
C:\PS> compare-object $a $b

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


C:\PS> get-formatdata *bits* | export-formatdata -filepath c:\test\bits.format.ps1xml

C:\PS> 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 и Export-FormatData для экспорта данных форматирования, которые добавляются модулем.

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

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

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






См. также