Format-Custom

Синтаксис

Default (по умолчанию)

Format-Custom
    [[-Property] <Object[]>]
    [-Depth <Int32>]
    [-GroupBy <Object>]
    [-View <String>]
    [-ShowError]
    [-DisplayError]
    [-Force]
    [-Expand <String>]
    [-InputObject <PSObject>]
    [<CommonParameters>]

Описание

Примеры

Пример 1. Форматирование выходных данных с настраиваемым представлением

Get-Command Start-Transcript | Format-Custom -View MyView

Пример 2. Форматирование выходных данных с представлением по умолчанию

Get-Process Winlogon | Format-Custom

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

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

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  = #ERR
}

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

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  =
}

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

Параметры

-Depth

Указывает количество столбцов в отображении.

Свойства параметра

Наборы параметров

-DisplayError

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

Свойства параметра

Наборы параметров

-Expand

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

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

• EnumOnly: Показывает свойства объектов в коллекции.
• CoreOnly: отображает свойства объекта коллекции.
• Оба: отображает свойства объекта коллекции и объектов в коллекции.

Свойства параметра

Наборы параметров

-Force

Указывает командлету отображать всю информацию об ошибке. Используйте параметры DisplayError или ShowError. По умолчанию, когда объект ошибки записывается в потоки ошибки или отображения, отображаются только некоторые сведения об ошибке.

Свойства параметра

Наборы параметров

-GroupBy

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

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

• Имя (или метка) — <string>
• Выражение: <string> или <script block>
• FormatString — <string>

См. раздел about_Calculated_Propertiesдля получения дополнительных сведений.

Свойства параметра

Наборы параметров

-InputObject

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

Свойства параметра

Наборы параметров

-Property

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

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

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

• Выражение: <string> или <script block>
• Глубина — <int32>

См. раздел about_Calculated_Propertiesдля получения дополнительных сведений.

Свойства параметра

Наборы параметров

-ShowError

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

Свойства параметра

Наборы параметров

-View

Задает имя альтернативного формата или представления. Если этот параметр не указан, Format-Custom использует пользовательское представление по умолчанию. Вы не можете использовать свойство и параметр представления в одной и той же команде.

Свойства параметра

Наборы параметров

CommonParameters

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

PSObject

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

Microsoft.PowerShell.Commands.Internal.Format

Примечания

Связанные ссылки

• об_вычисляемых_свойствах
• Формат-Хекс
• Формат-Список
• Format-Table
• По всему формату
• Get-Process