Поделиться через

Format-Wide

  • Ссылка
Модуль:
Microsoft.PowerShell.Utility

Форматирует объекты в виде широкой таблицы, отображающей только одно свойство каждого объекта.

Синтаксис

Format-Wide
      [[-Property] <Object>]
      [-AutoSize]
      [-Column <int>]
      [-GroupBy <Object>]
      [-View <string>]
       [-ShowError]
      [-DisplayError]
      [-Force]
      [-Expand <string>]
      [-InputObject <psobject>] 
      [<CommonParameters>]

Описание

Командлет Format-Wide форматирует объекты в виде широкой таблицы, отображающей только одно свойство каждого объекта. Чтобы определить, какое свойство отображается, можно использовать параметр свойства .

Примеры

Пример 1. Форматирование имен файлов в текущем каталоге

Эта команда отображает имена файлов в текущем каталоге в трех столбцах на экране.

Get-ChildItem | Format-Wide -Column 3

Командлет Get-ChildItem получает объекты, представляющие каждый файл в каталоге. Оператор конвейера (|) передает объекты файлов через конвейер в Format-Wide, который форматирует их для выходных данных. Параметр столбца указывает количество столбцов.

Пример 2. Форматирование имен разделов реестра

Эта команда отображает имена разделов реестра в разделе HKEY_CURRENT_USER\Software\Microsoft.

Get-ChildItem HKCU:\software\microsoft | Format-Wide -Property pschildname -AutoSize

Командлет Get-ChildItem получает объекты, представляющие ключи. Путь указывается как HKCU:, один из дисков, предоставляемых поставщиком реестра PowerShell, а затем путь к ключу. Оператор конвейера (|) передает объекты раздела реестра через конвейер в Format-Wide, который форматирует их для выходных данных. Параметр Property указывает имя свойства, а параметр autoSize autoSize настраивает столбцы для удобочитаемости.

Пример 3. Устранение ошибок формата

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

PS /> Get-Date | Format-Wide { $_ / $null } -DisplayError


#ERR

PS /> Get-Date | Format-Wide { $_ / $null } -ShowError


Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (12/21/2018 8:18:01 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

Параметры

-AutoSize

Настраивает размер столбца и количество столбцов на основе ширины данных. По умолчанию размер столбца и число определяются представлением. Нельзя использовать параметры столбца autoSize и столбца в той же команде.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Column

Указывает количество столбцов в отображении. Нельзя использовать параметры столбца autoSize и столбца в той же команде.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisplayError

Отображает ошибки в командной строке. Этот параметр редко используется, но его можно использовать в качестве средства отладки при форматировании выражений в команде Format-Wide, и выражения, как представляется, не работают.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Expand

Форматирует объект коллекции, а также объекты в коллекции. Этот параметр предназначен для форматирования объектов, поддерживающих интерфейс ICollection (System.Collections). Значение по умолчанию — EnumOnly.

Допустимые значения:

  • Перечисление: отображает свойства объектов в коллекции.
  • CoreOnly: отображает свойства объекта коллекции.
  • Оба: отображает свойства объекта коллекции и свойства объектов в коллекции.
Тип:String
Допустимые значения:CoreOnly, EnumOnly, Both
Position:Named
Default value:EnumOnly
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

Указывает, что этот командлет переопределяет ограничения, которые препятствуют успешной команде, поэтому изменения не компрометирует безопасность. Например, Force переопределит атрибут только для чтения или создаст каталоги для завершения пути к файлу, но не будет пытаться изменить разрешения файла.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-GroupBy

Форматирует выходные данные в группах на основе общего свойства или значения. Введите выражение или свойство выходных данных.

Значение параметра GroupBy может быть новым вычисляемым свойством. Чтобы создать вычисляемое свойство, используйте хэш-таблицу. Допустимые значения для этого параметра:

  • Имя (или метка) <строки>
  • > блока скрипта> или <строкового <
  • Строка formatString <>
Тип:Object
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

Указывает объекты для форматирования. Введите переменную, содержащую объекты, или введите команду или выражение, которое получает объекты.

Тип:PSObject
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Property

Указывает свойства объекта, отображаемые в отображении, и порядок их отображения. Разрешены подстановочные знаки.

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

Значение параметра свойства может быть новым вычисляемым свойством. Чтобы создать вычисляемое свойство, используйте хэш-таблицу. Допустимые ключи:

  • > блока скрипта> или <строкового <
  • Строка formatString <>
Тип:Object
Position:0
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-ShowError

Отправляет ошибки через конвейер. Этот параметр редко используется, но его можно использовать в качестве средства отладки при форматировании выражений в команде Format-Wide, и выражения, как представляется, не работают.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-View

Задает имя альтернативного формата таблицы или представления. Нельзя использовать свойств и просмотр параметров в той же команде.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

PSObject

Можно передать любой объект в Format-Wide.

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

Microsoft.PowerShell.Commands.Internal.Format

Format-Wide возвращает объекты формата, представляющие таблицу.

Примечания

Вы также можете ссылаться на Format-Wide по встроенному псевдониму, fw. Дополнительные сведения см. в about_Aliases.

Параметр GroupBy предполагает, что объекты отсортированы. Используйте Sort-Object перед использованием Format-Custom для группировки объектов.

Параметр View позволяет указать альтернативный формат таблицы. Представления, определенные в *.format.PS1XML файлах в каталоге PowerShell, можно создать собственные представления в новых файлах PS1XML и использовать командлет Update-FormatData для включения их в PowerShell.

Альтернативное представление параметра представления должно использовать формат таблицы; Если это не так, команда завершается ошибкой. Если альтернативное представление является списком, используйте Format-List. Если альтернативное представление не является списком или таблицей, используйте формат custom.