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сообщает, что объекты не были указаны.