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

Format-Custom

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

Использует пользовательское представление для форматирования выходных данных.

Синтаксис

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

Описание

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

Примеры

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

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

Эта команда форматирует сведения о Start-Transcript командлете в формате, определенном представлением MyView, пользовательским представлением, созданным пользователем. Чтобы выполнить эту команду успешно, необходимо сначала создать новый файл PS1XML, определить представление MyView , а затем использовать Update-FormatData команду для добавления PS1XML-файла в PowerShell.

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

Get-Process Winlogon | Format-Custom

Эта команда форматирует сведения о процессе Winlogon в альтернативном настроенном представлении. Так как команда не использует параметр View , Format-Custom использует настраиваемое представление по умолчанию для форматирования данных.

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

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

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

Задает количество столбцов в отображаемых данных.

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

-DisplayError

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

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

-Expand

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

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

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

-Force

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

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

-GroupBy

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

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

  • Имя (или метка) — <string>
  • Выражение — <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

Задает свойства объекта, которые будут включены в вывод, и порядок их вывода. Разрешено использовать подстановочные знаки.

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

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

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

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

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

-ShowError

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

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

-View

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

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

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

PSObject

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

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

Microsoft.PowerShell.Commands.Internal.Format

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

Примечания

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

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

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

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