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

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 настраивает столбцы для удобочитаемости.

Пример 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

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

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

  • EnumOnly: отображает свойства объектов в коллекции.
  • CoreOnly: отображает свойства объекта коллекции.
  • Both: отображает свойства объекта коллекции и свойства объектов в коллекции.
Тип: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 ожидает сортировки объектов. Используйте командлет Sort-Object перед использованием Format-Wide для группировки объектов.

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

  • Name (или Label) — <string>
  • Expression - <string> или <script block>
  • FormatString - <string>

Дополнительные сведения см. в разделе about_Calculated_Properties.

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

-InputObject

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

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

-Property

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

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

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

  • Expression - <string> или <script block>
  • FormatString - <string>

Дополнительные сведения см. в разделе about_Calculated_Properties.

Тип: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

Вы можете передать любой объект в этот командлет.

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

Microsoft.PowerShell.Commands.Internal.Format

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

Примечания

PowerShell включает следующие псевдонимы для Format-Wide:

  • Все платформы:
    • fw

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

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