Format-List

Format-List
    [[-Property] <Object[]>]
    [-GroupBy <Object>]
    [-View <string>]
    [-ShowError]
    [-DisplayError]
    [-Force]
    [-Expand <string>]
    [-InputObject <psobject>]
    [<CommonParameters>]

Командлет Format-List форматирует выходные данные команды в виде списка свойств, в которых каждое свойство отображается в отдельной строке. Вы можете использовать Format-List для форматирования и отображения всех или выбранных свойств объекта в виде списка (Format-List -Property *).

Поскольку в списке для каждого элемента доступно больше места, чем в таблице, PowerShell отображает больше свойств объекта, и значения свойств реже обрезаются.

Get-Service | Format-List

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

Эти команды отображают сведения о файлах PS1XML в каталоге PowerShell в виде списка.

$A = Get-ChildItem $PSHOME\*.ps1xml
Format-List -InputObject $A

Первая команда получает объекты, представляющие файлы, и сохраняет их в переменной $A.

Вторая команда использует Format-List для форматирования сведений об объектах, хранящихся в $A. Эта команда использует параметр InputObject для передачи переменной в Format-List, который затем отправляет отформатированные выходные данные в командлет вывода по умолчанию для отображения.

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

Get-Process | Format-List -Property Name, BasePriority, PriorityClass

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

Эта команда отображает все свойства процесса Winlogon.

Get-Process winlogon | Format-List -Property *

Он использует командлет Get-Process для получения объекта, представляющего процесс Winlogon. Оператор конвейера (|) передает объект процесса Winlogon через конвейер в Format-List. Команда использует параметр Property, чтобы указать свойства и *, чтобы указать все свойства. Так как имя параметра свойства является необязательным, его можно опустить и ввести команду как . Format-List автоматически отправляет результаты в командлет вывода по умолчанию для отображения.

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

PC /> Get-Date | Format-List DayOfWeek, { $_ / $null } -DisplayError

DayOfWeek    : Friday
 $_ / $null  : #ERR

PC /> Get-Date | Format-List DayOfWeek, { $_ / $null } -ShowError

DayOfWeek    : Friday
 $_ / $null  :

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

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

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

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

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

Командлеты формата, такие как Format-List, упорядочивают отображаемые данные, но не отображают их. Данные отображаются выходными возможностями PowerShell и командлетами, содержащими глагол Out (командлеты Out), например, Out-Host или Out-File.

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

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

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

Если вы хотите использовать Format-List с параметром свойства , необходимо включить параметр Force при любом из следующих условий:

• Входные объекты форматируются вне полосы с помощью метода ToString(). Это относится к [string] и примитивным типам .NET, которые являются супермножеством встроенных числовых типов, таких как [int], [long]и другие.

• Входные объекты не имеют открытых свойств.

• Входные объекты — это экземпляры типов оболочки PowerShell, которые используются для выходных потоков, отличных от потока выходных данных Success. Это применяется только в том случае, если эти типы оболочки отправляются в поток выходных данных Success, что требует либо их перехвата через общие параметры, такие как ErrorVariable, либо использования перенаправления, например *>&1.

  • Типы оболочки включают:

    • System.Management.Automation.ErrorRecord
    • System.Management.Automation.WarningRecord
    • System.Management.Automation.VerboseRecord
    • System.Management.Automation.DebugRecord
    • System.Management.Automation.InformationRecord