Update-FormatData
Обновляет данные форматирования в текущем сеансе.
Синтаксис
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 |
Входные данные
Можно передать строку, содержащую путь добавления.Update-FormatData
Выходные данные
None
Этот командлет не создает никаких выходных данных.
Примечания
Update-FormatDataтакже обновляет данные форматирования для команд в сеансе, импортированных из модулей. Если файл форматирования для модуля изменяется, можно выполнитьUpdate-FormatDataкоманду, чтобы обновить данные форматирования для импортированных команд. Импортировать модуль снова не требуется.