Обновляет данные форматирования для текущего сеанса.
Синтаксис
Update-FormatData [[-AppendPath] <string[]>] [-PrependPath <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>]
Описание
Командлет Update-FormatData перезагружает данные форматирования из файлов форматирования в текущий сеанс. Этот командлет позволяет обновить данные форматирования без перезапуска Windows PowerShell.
Без параметров командлет Update-FormatData перезагружает файлы форматирования, которые он загрузил перед этим. С помощью параметров командлета Update-FormatData можно добавлять в сеанс новые файлы форматирования.
Файлы форматирования представляют собой текстовые файлы в формате XML с расширением имени файла format.ps1xml. Данные форматирования в этих файлах определяют отображение объектов Microsoft .NET Framework в сеансе.
При запуске оболочки Windows PowerShell она загружает в сеанс данные форматирования из файлов форматирования из каталога установки Windows PowerShell ($pshome). С помощью командлета Update-FormatData можно перезагрузить данные форматирования в текущий сеанс без перезапуска Windows PowerShell. Это бывает удобно, если файл форматирования был добавлен или изменен, а прерывать сеанс нежелательно.
Дополнительные сведения о файлах форматирования в Windows PowerShell см. в разделе about_Format.ps1xml.
Параметры
-AppendPath <string[]>
Добавляет в сеанс указанные файлы форматирования. Эти файлы загружаются после того, как Windows PowerShell загрузит встроенные файлы форматирования.
При форматировании объектов .NET оболочка Windows PowerShell использует для каждого из типов .NET первое найденное для него определение форматирования. Если используется параметр AppendPath, оболочка Windows PowerShell ищет данные во встроенных файлах, а лишь затем в добавляемых файлах форматирования.
Этот параметр служит для добавления файла, определяющего форматирование объектов .NET, которые не указаны во встроенных файлах форматирования.
|
Обязательно? |
false |
|
Позиция? |
1 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByValue, ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-PrependPath <string[]>
Добавляет в сеанс указанные файлы форматирования. Эти файлы загружаются до того, как Windows PowerShell загрузит встроенные файлы форматирования.
При форматировании объектов .NET оболочка Windows PowerShell использует для каждого из типов .NET первое найденное для него определение форматирования. Если используется параметр PrependPath, оболочка Windows PowerShell ищет данные в добавляемых файлах, а лишь затем во встроенных файлах форматирования.
Этот параметр служит для добавления файла, определяющего форматирование объектов .NET, которые также указаны во встроенных файлах форматирования.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Confirm
Запрашивает подтверждение перед выполнением команды.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-WhatIf
Описывает, что произойдет при выполнении команды, без ее фактического выполнения.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
System.String Строку, содержащую добавляемый путь, можно передать командлету Update-FormatData по конвейеру. |
|
Выходные данные |
Нет Этот командлет не возвращает никаких выходных данных. |
Примечания
Кроме того, командлет Update-FormatData обновляет данные форматирования для команд в сеансе, которые не были импортированы из модулей. При изменении файла форматирования для модуля можно выполнить команду Update-FormatData, чтобы обновить данные форматирования для импортированных команд. Импортировать модуль повторно не требуется.
Пример 1
C:\PS>update-formatdata Описание ----------- Эта команда перезагружает файлы форматирования, которые были загружены ранее.
Пример 2
C:\PS>update-formatdata -appendpath trace.format.ps1xml, log.format.ps1xml Описание ----------- Эта команда перезагружает в сеанс файлы форматирования, в том числе два новых файла: Trace.format.ps1xml и Log.format.ps1xml. Поскольку в команде используется параметр AppendPath, данные форматирования из новых файлов загружаются после данных форматирования из встроенных файлов. Параметр AppendPath используется потому, что новые файлы содержат данные форматирования для объектов, не указанных во встроенных файлах.
Пример 3
C:\PS>update-formatdata -prependPath c:\test\NewFiles.format.ps1xml # Edit the NewFiles.format.ps1 file. C:\PS> update-formatdata Описание ----------- В этом примере показано, как перезагрузить файл форматирования после его изменения. Первая команда добавляет в сеанс файл NewFiles.format.ps1xml. В ней используется параметр PrependPath, поскольку файл содержит данные форматирования для объектов, указанных во встроенных файлах. После добавления файла NewFiles.format.ps1xml и его тестирования в сеансе автор изменяет файл. Вторая команда с помощью командлета Update-FormatData перезагружает файлы форматирования. Поскольку ранее был загружен файл NewFiles.format.ps1xml, командлет Update-FormatData автоматически перезагружает его без каких-либо параметров.