Update-FormatData (Microsoft.PowerShell.Utility)

Update-FormatData

Модуль:: Microsoft.PowerShell.Utility

Обновляет данные форматирования в текущем сеансе.

Синтаксис

Update-FormatData
      [[-AppendPath] <String[]>]
      [-PrependPath <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Update-FormatData перезагружает данные форматирования из файлов форматирования в текущий сеанс. Этот командлет позволяет обновлять данные форматирования без перезапуска PowerShell.

Без параметров Update-FormatData перезагружает файлы форматирования, которые он загрузил ранее. Вы можете использовать параметры Update-FormatData, чтобы добавить в сеанс новые файлы форматирования.

Файлы форматирования представляют собой текстовые файлы в формате XML с расширением имени файла format.ps1xml. Данные форматирования в файлах определяют отображение объектов Microsoft .NET Framework в сеансе.

Когда PowerShell запускается, он загружает данные формата из исходного кода PowerShell. Однако вы можете создать собственные файлы format.ps1xml для обновления форматирования в текущем сеансе. Вы можете использовать Update-FormatData, чтобы перезагрузить данные форматирования в текущий сеанс без перезапуска PowerShell. Это полезно, если вы добавили или изменили файл форматирования, но не хотите прерывать сеанс.

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

Примеры

Пример 1. Перезагрузите ранее загруженные файлы форматирования.

Update-FormatData

Эта команда перезагружает файлы форматирования, которые она загрузила ранее.

Пример 2. Перезагрузка файлов форматирования, а также файлов форматирования трассировки и журнала.

Update-FormatData -AppendPath "trace.format.ps1xml, log.format.ps1xml"

Эта команда перезагружает файлы форматирования в сеанс, включая два новых файла: Trace.format.ps1xml и Log.format.ps1xml.

Поскольку команда использует параметр AppendPath, данные форматирования в новых файлах загружаются после данных форматирования из встроенных файлов.

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

Пример 3. Отредактируйте файл форматирования и перезагрузите его.

Update-FormatData -PrependPath "c:\test\NewFiles.format.ps1xml"

# Edit the NewFiles.format.ps1 file.

Update-FormatData

В этом примере показано, как перезагрузить файл форматирования после его редактирования.

Первая команда добавляет в сеанс файл NewFiles.format.ps1xml. Он использует параметр PrependPath, поскольку файл содержит данные форматирования для объектов, на которые имеются ссылки во встроенных файлах.

После добавления файла NewFiles.format.ps1xml и его тестирования в этих сеансах автор редактирует файл.

Вторая команда использует командлет Update-FormatData для перезагрузки файлов форматирования. Поскольку файл NewFiles.format.ps1xml был ранее загружен, Update-FormatData автоматически перезагружает его без использования параметров.

Параметры

-AppendPath

Указывает файлы форматирования, которые этот командлет добавляет в сеанс. Файлы загружаются после того, как PowerShell загрузит встроенные файлы форматирования.

При форматировании объектов .NET PowerShell использует первое найденное определение форматирования для каждого типа .NET. Если вы используете параметр AppendPath, PowerShell выполняет поиск данных во встроенных файлах, прежде чем обнаружит добавляемые вами данные форматирования.

Используйте этот параметр, чтобы добавить файл, форматирующий объект .NET, на который нет ссылок во встроенных файлах форматирования.

Тип :: String[]
Псевдонимы:: PSPath, Path
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип :: SwitchParameter
Псевдонимы:: cf
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-PrependPath

Указывает файлы форматирования, которые этот командлет добавляет в сеанс. Файлы загружаются до того, как PowerShell загрузит встроенные файлы форматирования.

При форматировании объектов .NET PowerShell использует первое найденное определение форматирования для каждого типа .NET. Если вы используете параметр PrependPath, PowerShell выполняет поиск данных в добавляемых вами файлах, прежде чем обнаружит данные форматирования из встроенных файлов.

Используйте этот параметр, чтобы добавить файл, форматирующий объект .NET, на который также ссылаются встроенные файлы форматирования.

Тип :: String[]
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-WhatIf

Показывает, что произойдет, если командлет запустится. Командлет не запускается.

Тип :: SwitchParameter
Псевдонимы:: wi
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

Входы

Строка

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

Выходы

Нет

Этот командлет не возвращает никаких результатов.

Примечания

Update-FormatData также обновляет данные форматирования для команд в сеансе, которые были импортированы из модулей. Если файл форматирования модуля изменится, вы можете запустить команду Update-FormatData, чтобы обновить данные форматирования для импортированных команд. Вам не нужно импортировать модуль повторно.