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


Out-Null

Скрывает выходные данные вместо отправки его вниз конвейера или его отображения.

Синтаксис

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

Out-Null
    [-InputObject <PSObject>]
    [<CommonParameters>]

Описание

Командлет Out-Null отправляет выходные данные в значение NULL, в результате удалив его из конвейера и предотвращая отображение выходных данных на экране. Это влияет только на стандартный выходной поток. Другие выходные потоки, такие как поток ошибок, не затрагиваются. Будут отображаться исключения. Это упрощает проверку команды на наличие ошибок.

Примеры

Пример 1. Удаление выходных данных

Get-ChildItem | Out-Null

Эта команда получает элементы в текущем каталоге, но её результат не передаётся через конвейер и не отображается в командной строке. Это полезно для скрытия выходных данных, которые вам не нужны.

Параметры

-InputObject

Указывает объект, который будет отправлен в NULL (удалён из потока обработки). Введите переменную, содержащую объекты, или введите команду или выражение, которое получает объекты.

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

Тип:PSObject
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

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

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

PSObject

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

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

None

Этот командлет не возвращает выходные данные.

Примечания

  • Командлеты, содержащие глагол Out (командлеты Out), не имеют параметров для имен или путей к файлам. Чтобы отправить данные в командлет Out, используйте оператор конвейера (|) для отправки выходных данных команды Windows PowerShell командлету. Вы также можете хранить данные в переменной и использовать параметр InputObject для передачи данных командлету. Дополнительные сведения см. в примерах.
  • Out-Null не возвращает выходные объекты. Если вы передаете выходные данные Out-Null командлету Get-Member, Get-Member сообщает, что объекты не были указаны.