Get-FormatData
Получает данные форматирования для текущего сеанса.
Синтаксис
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.