Сохраняет данные форматирования текущего сеанса в файле форматирования.
Синтаксис
Export-FormatData [-Force] [-IncludeScriptBlock] [-InputObject <ExtendedTypeDefinition[]>] [-NoClobber] [-Path <string>] [<CommonParameters>]
Описание
Командлет Export-FormatData создает файлы форматирования Windows PowerShell (format.ps1xml) из объектов форматирования в текущем сеансе. Он принимает объекты ExtendedTypeDefinition, возвращаемые командлетом Get-FormatData, и сохраняет их в файле в формате XML.
На основе данных из файлов форматирования (format.ps1xml) Windows PowerShell создает способ отображения объектов Microsoft .NET Framework в сеансе, используемый по умолчанию. Файлы форматирования можно просматривать и изменять, а с помощью командлета Update-FormatData можно добавлять в сеанс данные форматирования.
Дополнительные сведения о файлах форматирования в Windows PowerShell см. в разделе about_Format.ps1xml.
Параметры
-Force
Перезаписывает существующий выходной файл, даже если для него установлен атрибут "только чтение".
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
False |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-IncludeScriptBlock
Определяет, экспортируются ли блоки скриптов, содержащиеся в данных форматирования.
Поскольку блоки скриптов содержат выполняемый код и могут использоваться для вредоносных целей, по умолчанию они не экспортируются.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
False |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-InputObject <ExtendedTypeDefinition[]>
Задает экспортируемые объекты форматирования данных. Введите переменную, содержащую объекты, либо команду, получающую объекты, например Get-FormatData. Кроме того, можно передать объекты командлету Export-FormatData от командлета Get-FormatData по конвейеру.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByValue) |
|
Принимать подстановочные знаки? |
false |
-NoClobber
Запрещает командлету перезаписывать существующие файлы. По умолчанию командлет Export-FormatData без предупреждения перезаписывает файлы, для которых не задан атрибут "только чтение".
Чтобы задать командлету Export-FormatData принудительную перезапись файлов с атрибутом "только чтение", используйте параметр Force.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Path <string>
Задает расположение выходного файла. Укажите путь (необязательно) и имя файла с расширением format.ps1xml. Если путь не указан, командлет Export-FormatData создает файл в текущем каталоге.
Если используется расширение, отличное от PS1XML, командлет Update-FormatData не распознает файл.
Если указан существующий файл, командлет Export-FormatData перезаписывает имеющийся файл без предупреждения, если этому файлу не задан атрибут "только чтение". Чтобы перезаписать файл с атрибутом "только чтение", используйте параметр Force. Чтобы запретить перезапись существующих файлов, используйте параметр NoClobber.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
нет |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
System.Management.Automation.ExtendedTypeDefinition Кроме того, можно передать объекты ExtendedTypeDefinition командлету Export-FormatData от командлета Get-FormatData по конвейеру. |
|
Выходные данные |
Нет Командлет Export-FormatData не возвращает никаких объектов. Он создает файл и сохраняет его по указанному пути. |
Примечания
Чтобы использовать любой файл форматирования, в том числе экспортированный, необходимо, чтобы в политике выполнения для сеанса было разрешено выполнение скриптов и файлов конфигурации. Дополнительные сведения см. в разделе about_Execution_Policies.
Пример 1
C:\PS>get-formatdata -typename * | export-formatdata -path allformat.ps1xml -IncludeScriptBlock Описание ----------- Эта команда экспортирует все данные форматирования из сеанса в файл AllFormat.ps1xml. Эта команда получает все данные форматирования из сеанса с помощью командлета Get-FormatData. Оператор "*", используемый в качестве значения параметра TypeName, предписывает командлету получить все данные из сеанса. В этой команде с помощью оператора конвейера (|) данные форматирования передаются от командлета Get-FormatData командлету Export-FormatData, экспортирующему все данные форматирования в файл AllFormat.ps1. В команде Export-FormatData используется параметр IncludeScriptBlock, чтобы включить все блоки скриптов в данных форматирования в файле.
Пример 2
C:\PS>$f = get-formatdata -typename helpinfoshort C:\PS> export-formatdata -inputObject $f -path c:\test\help.format.ps1xml -IncludeScriptBlock Описание ----------- Эти команды экспортируют данные форматирования для типа HelpInfoShort в файл Help.format.ps1xml. Первая команда получает данные форматирования для типа HelpInfoShort с помощью командлета Get-FormatData и сохраняет их в переменной $f. Вторая команда с помощью командлета Export-FormatData с параметром InputObject вводит данные форматирования, сохраненные в переменной $f. В ней также используется параметр IncludeScriptBlock, включающий блоки скриптов в выходные данные.
Пример 3
C:\PS>get-formatdata -typename System.Diagnostics.Process | export-FormatData -path process.format.ps1xml C:\PS> Update-FormatData -prependPath .\process.format.ps1xml C:\PS> get-process p* Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName ------- ------ ----- ----- ----- ------ -- ----------- 323 5600 powershell 336 3900 powershell_ise 138 4076 PresentationFontCache Описание ----------- В этом примере показан результат выполнения команды Export-FormatData без параметра IncludeScriptBlock. В первой команде с помощью командлета Get-FormatData получаются данные форматирования для объекта System.Diagnostics.Process, возвращаемого командлетом Get-Process. С помощью оператора конвейера (|) объекты форматирования передаются командлету Export-FormatData, который экспортирует их в файл Process.format.ps1xml в текущем каталоге. В данном случае командлет Export-FormatData используется без параметра IncludeScriptBlock. Во второй команде с помощью командлета Update-FormatData файл Process.format.ps1xml добавляется в текущий сеанс. В этой команде используется параметр PrependPath, обеспечивающий, что данные форматирования для объектов процессов, содержащиеся в файле Process.format.ps1xml, обнаруживаются раньше стандартных данных форматирования для объектов процессов. Третья команда показывает результат этого изменения. В ней используется командлет Get-Process для получения процессов с именами, начинающимися с символа "P". По выходным данным видно, что значения свойств, вычисляемые с использованием блоков скриптов, не отображаются.