Share via

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, на который нет ссылок во встроенных файлах форматирования.

Type:String[]
Aliases:PSPath, Path
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrependPath

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

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

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

String

Можно передать по конвейеру строку, содержащую путь к добавлению в Update-FormatData.

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

None

Этот командлет не создает никаких выходных данных.

Примечания

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