Поставщики
Поставщик в PowerShell — это интерфейс, который позволяет файловой системе, например, получить доступ к хранилищу данных. В PowerShell имеется ряд встроенных поставщиков.
Как видно в предыдущих результатах, существуют встроенные поставщики для реестра, псевдонимов, переменных среды, файловой системы, функций, переменных, сертификатов и WSMan.
Фактические диски, используемые этими поставщиками для предоставления хранилища данных, можно определить с помощью командлета . Командлет не только отображает диски, предоставляемые поставщиками, но и выводит логические диски Windows, включая диски, сопоставленные с сетевыми папками.
Сторонние модули, такие как модуль PowerShell для Active Directory и модуль PowerShell для SQL Server, имеют собственные поставщики PowerShell и PSDrive.
Импортируем модули PowerShell для Active Directory и SQL Server.
Проверим, были ли добавлены дополнительные поставщики PowerShell.
Обратите внимание, что в предыдущем наборе результатов теперь существует два новых поставщика PowerShell: один для Active Directory и другой для SQL Server. Для каждого из этих модулей также был добавлен диск PSDrive
Для каждого из этих модулей также был добавлен диск PSDrive.
Доступ к дискам PSDrive осуществляется так же, как к традиционной файловой системе.
Параметры
-DisplayError
Указывает, что этот командлет отображает ошибки в командной строке. Этот параметр используется редко, но его можно использовать в качестве средства отладки при форматировании выражений в команде, а выражения не работают.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Expand
Указывает отформатированный объект коллекции, а также объекты в коллекции. Этот параметр предназначен для форматирования объектов, поддерживающих интерфейс System.Collections.ICollection . Значение по умолчанию — . Допустимые значения для этого параметра:
- . отображаются свойства объектов в коллекции.
- . отображаются свойства объекта коллекции.
- . отображаются свойства объекта коллекции и свойства объектов, содержащихся в коллекции.
Type: | String |
Accepted values: | CoreOnly, EnumOnly, Both |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Указывает, что этот командлет отображает все сведения об ошибке. Используйте с параметром DisplayError или ShowError . По умолчанию, когда объект ошибки записывается в потоки ошибок или отображения, отображаются только некоторые сведения об ошибке.
Также требуется при форматировании определенных типов .NET. Дополнительные сведения см. в разделе .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GroupBy
Указывает выходные данные в группах на основе общего свойства или значения. Введите выражение или свойство вывода.
Значение параметра GroupBy может быть новым вычисляемым свойством. Вычисляемое свойство может быть блоком скрипта или хэш-таблицей. Допустимые пары «ключ-значение»:
- (или ) —
- — или
- —
Дополнительные сведения см. в разделе about_Calculated_Properties.
Type: | Object |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Задает объекты, подлежащие форматированию. Введите переменную, которая содержит объекты, или команду или выражение, которое возвращает объекты.
Type: | PSObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Property
Задает свойства объекта, которые будут включены в вывод, и порядок их вывода.
Разрешено использовать подстановочные знаки.
Если этот параметр не указан, свойства включаются в вывод в зависимости от отображаемого объекта. Имя параметра Свойство является необязательным. Нельзя использовать параметры Property и View в одной команде.
Значение параметра Property может быть новым вычисляемым свойством. Вычисляемое свойство может быть блоком скрипта или хэш-таблицей. Допустимые пары «ключ-значение»:
- (или ) —
- — или
- —
Дополнительные сведения см. в разделе about_Calculated_Properties.
Type: | Object |
Position: | |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ShowError
Указывает, что командлет отправляет ошибки через конвейер. Этот параметр используется редко, но его можно использовать в качестве средства отладки при форматировании выражений в команде, а выражения не работают.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-View
Указывает имя альтернативного формата списка или представления. Нельзя использовать параметры Property и View в одной команде.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Примеры
Пример 1. Преобразование формата строки
Первая команда создает массив, содержащий имена и фамилии.
Вторая команда форматирует имена в соответствии с примером. Она помещает фамилию в первую очередь в выходные данные, за которой следует инициал.
Пример 2. Упрощение формата строки
Первая команда создает массив, содержащий первые, средние и фамилии
Обратите внимание, что последняя запись не имеет среднего имени
Вторая команда форматирует имена в соответствии с примером. Он помещает фамилию в выходные данные, а затем имя. Все отчество удалены; запись без среднего имени обрабатывается правильно.
Пример 3. Управление выходными данными, если строки не соответствуют примеру
Первая команда создает массив, содержащий первые, средние и фамилии
Обратите внимание, что последняя запись не имеет среднего имени
Вторая команда форматирует имена в соответствии с примером. Он помещает отчество в выходные данные, за которым следует имя. Последняя запись пропускается, так как она не соответствует образцу шаблона: она не имеет отчество.
Пример 4
Осторожность при использовании пространств красоты
Первая команда создает массив имен и фамилий
Обратите внимание, что второе и четвертое элементы имеют дополнительное место в конце после фамилии
Вторая команда преобразует все строки, соответствующие образцу шаблона: слово, пробел, слово и конечное конечное пробел, все это до знака равенства()
Кроме того, обратите внимание на начальное пространство в выходных данных
Пример 5. Форматирование сведений о процессе с несколькими шаблонами
$ExamplePatterns определяет различные ожидаемые шаблоны в данных с помощью примеров.
Первый шаблон считывается следующим образом:
- ожидает строк, где слово заключено в двойные кавычки, а затем запятая,
- а затем второе и последнее слово, заключенное в кавычки;
- без пробелов в строке. В выходных данных: сначала поместите второе слово,
- без кавычек, то один пробел, а затем первое слово без кавычек.
Второй шаблон считывается следующим образом:
- ожидает строк, где слово заключено в двойные кавычки, а затем запятая,
- а затем число, заключенное в кавычки;
- без пробелов в строке. В выходных данных: сначала поместите число,
- без кавычек, то один пробел, а затем слово без кавычек.
Третий шаблон считывается следующим образом:
- ожидает строк, в которых два слова с дефисом между ними заключены в
- двойные кавычки, затем запятая, а затем число, заключенное в кавычки;
- без пробелов между запятой и третьей двойной кавычками.
- В выходных данных: сначала поместите число без кавычек, а затем один пробел,
- и затем дефисированные слова без кавычек.
Четвертый и последний, шаблон, считывает следующее:
- ожидает строк, где два слова с пробелом между ними заключены в
- двойные кавычки, затем запятая, а затем число, заключенное в кавычки;
- без пробелов между запятой и третьей двойной кавычками.
- В выходных данных: сначала поместите число без кавычек, а затем один пробел,
- и затем слова с пробелом между, без кавычек.
Первая команда получает все процессы с помощью командлета Get-Process. Команда передает их в командлет Select-Object, который выбирает имя процесса и идентификатор процесса. В конце конвейера команда преобразует выходные данные в разделенные запятыми значения без сведений о типе с помощью командлета ConvertTo-Csv. Команда сохраняет результаты в переменной $Processes . $Processes теперь содержит имена процессов и PID.
Вторая команда задает пример переменной, которая изменяет порядок входных элементов. Команда охватывает каждую строку в .
Примечание
Четвертый шаблон неявно говорит, что сопоставляются два или более слов, разделенных пробелами. Без четвертого шаблона сопоставляется только первое слово строки, заключенной в двойные кавычки.
Примечания
PowerShell включает следующие псевдонимы для :
- Для всех платформ.
Вы также можете ссылаться на по встроенному псевдониму . Подробнее см. в статье about_Aliases.
Параметр GroupBy предполагает, что объекты отсортированы. Используйте перед использованием для группировки объектов.
Параметр View позволяет указать альтернативный формат таблицы. Можно использовать представления, определенные в файлах в каталоге PowerShell, или создавать собственные представления в новых PS1XML-файлах и использовать командлет для их включения в PowerShell.
Альтернативное представление для параметра View должно использовать табличный формат; Если это не так, команда завершается ошибкой. Если альтернативным представлением является список, используйте . Если альтернативное представление не является ни списком, ни таблицей, используйте .
Примеры
Пример 1. Форматирование служб компьютеров
Эта команда форматирует сведения о службах на компьютере в виде списка. По умолчанию сведения о службах форматируются в виде таблицы. Командлет получает объекты, представляющие службы на компьютере. Оператор конвейера () передает результаты через конвейер в .
Затем команда форматирует сведения о службе в списке и отправляет их в командлет вывода по умолчанию для отображения.
Пример 2. Форматирование файлов PS1XML
Эти команды отображают сведения о файлах PS1XML в каталоге PowerShell в виде списка.
Первая команда получает объекты, представляющие файлы, и сохраняет их в переменной .
Вторая команда использует для форматирования сведений об объектах, хранящихся в . Эта команда использует параметр InputObject для передачи переменной в , который затем отправляет форматированные выходные данные в командлет вывода по умолчанию для отображения.
Пример 3. Форматирование свойств процесса по имени
Эта команда отображает имя, базовый приоритет и класс приоритета каждого процесса на компьютере.
Он использует командлет для получения объекта, представляющего каждый процесс. Оператор конвейера () передает объекты процесса через конвейер в . форматирует процессы в виде списка указанных свойств. Имя параметра Property является необязательным, поэтому его можно опустить.
Пример 4. Форматирование всех свойств процесса
Эта команда отображает все свойства процесса Winlogon.
Для получения объекта, представляющего процесс Winlogon, используется командлет Get-Process. Оператор конвейера () передает объект процесса Winlogon через конвейер в . Команда использует параметр Property для указания свойств и для указания всех свойств.
Так как имя параметра Property является необязательным, его можно опустить и ввести команду как . автоматически отправляет результаты в командлет вывода по умолчанию для отображения.
Параметры
-Append
Добавляет выходные данные в конец существующего файла. Если кодировка не указана, командлет использует кодировку по умолчанию. Эта кодировка может не совпадать с кодировкой целевого файла. Это то же поведение, что и оператор перенаправления ().
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encoding
Указывает тип кодировки для целевого файла. Значение по умолчанию — .
Ниже приведены допустимые значения для этого параметра.
- Использует 7-разрядную кодировку ASCII.
- Использует UTF-16 с порядком байтов большого байта.
- Использует кодировку, соответствующую активной кодовой странице системы (обычно ANSI).
- Использует кодировку, соответствующую текущей кодовой странице изготовителя оборудования.
- аналогичен .
- Использует UTF-16 с порядком байтов с маленьким байтом.
- аналогичен .
- Использует UTF-7.
- Использует UTF-8.
- Использует UTF-32 с порядком байтов с маленьким байтом.
Type: | String |
Accepted values: | ASCII, BigEndianUnicode, Default, OEM, String, Unicode, Unknown, UTF7, UTF8, UTF32 |
Position: | 1 |
Default value: | Unicode |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FilePath
Указывает путь к выходному файлу.
Type: | String |
Position: | |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Переопределяет атрибут только для чтения и перезаписывает существующий файл, доступный только для чтения. Параметр Force не переопределяет ограничения безопасности.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Указывает объекты, которые нужно записать в файл. Введите переменную, которая содержит объекты, или команду или выражение, которое возвращает объекты.
Type: | PSObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LiteralPath
Указывает путь к выходному файлу. Параметр LiteralPath используется точно так же, как он типизированный.
Подстановочные знаки не принимаются. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки позволяют PowerShell не интерпретировать какие-либо символы как escape-последовательности. Дополнительные сведения см. в разделе about_Quoting_Rules.
Type: | String |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoClobber
NoClobber предотвращает перезапись существующего файла и отображает сообщение о том, что файл уже существует. По умолчанию, если файл существует по указанному пути, он перезаписывается без предупреждения.
Type: | SwitchParameter |
Aliases: | NoOverwrite |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoNewline
Указывает, что содержимое, записанное в файл, не заканчивается символом новой строки. Строковые представления входных объектов объединяются для формирования выходных данных. Пробелы или новые строки не вставляются между выходными строками. После последней выходной строки новая строка не добавляется.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Width
Указывает количество символов в каждой строке выходных данных. Все остальные знаки отсекаются, а не переносятся на следующую строку. Если этот параметр не используется, ширина определяется характеристиками узла. По умолчанию для консоли PowerShell используется 80 символов. Если вы хотите управлять шириной для всех вызовов , а также операторов перенаправления ( и ), задайте перед использованием .
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Параметры
-Depth
Задает количество столбцов в отображаемых данных.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayError
Отображает сообщения об ошибках в командной строке. Этот параметр используется редко, но его можно использовать в качестве средства отладки при форматировании выражений в команде, а выражения не работают.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Expand
Форматирует объект коллекции, а также объекты, содержащиеся в коллекции. Этот параметр предназначен для форматирования объектов, поддерживающих интерфейс System.Collections.ICollection . Значение по умолчанию — EnumOnly.
Допустимые значения:
- EnumOnly — отображаются свойства объектов в коллекции.
- CoreOnly — отображаются свойства объекта коллекции.
- Оба: отображает свойства объекта коллекции и объектов в коллекции.
Type: | String |
Accepted values: | CoreOnly, EnumOnly, Both |
Position: | Named |
Default value: | EnumOnly |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Заставляет командлет отображать полные сведения об ошибках. Используйте с параметрами DisplayError или ShowError . По умолчанию при записи объекта ошибки в поток ошибок или поток отображения отображаются только некоторые сведения об ошибке.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GroupBy
Форматирует вывод в группы на основе общего свойства или значения. Введите выражение или свойство вывода.
Значение параметра GroupBy может быть новым вычисляемым свойством. Вычисляемое свойство может быть блоком скрипта или хэш-таблицей. Допустимые пары «ключ-значение»:
- Имя (или метка) —
- Выражение — или
- Formatstring-
Дополнительные сведения см. в разделе about_Calculated_Properties.
Type: | Object |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Задает объекты, подлежащие форматированию. Введите переменную, которая содержит объекты, или команду или выражение, которое возвращает объекты.
Type: | PSObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Property
Задает свойства объекта, которые будут включены в вывод, и порядок их вывода.
Разрешено использовать подстановочные знаки.
Если этот параметр не указан, свойства включаются в вывод в зависимости от отображаемого объекта. Имя параметра Свойство является необязательным. Нельзя использовать параметры Property и View в одной команде.
Значение параметра Property может быть новым вычисляемым свойством. Вычисляемое свойство может быть блоком скрипта или хэш-таблицей. Допустимые пары «ключ-значение»:
- Выражение — или
- Глубина-
Дополнительные сведения см. в разделе about_Calculated_Properties.
Type: | Object |
Position: | |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ShowError
Отправляет ошибки по конвейеру. Этот параметр используется редко, но его можно использовать в качестве средства отладки при форматировании выражений в команде, а выражения не работают.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-View
Указывает имя альтернативного формата или представления. Если этот параметр не указан, используется настраиваемое представление по умолчанию. Нельзя использовать параметры Property и View в одной команде.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Markdown для примеров кода
Markdown поддерживает два разных стиля кода.
- Код охватывает фрагменты кода (встроенный) , помеченный одним символом обратной кавычки ( ). Используется в абзаце, а не в виде автономного блока.
- Блоки кода — многострочный блок, заключенный в строки тройного обратного деления ( ). Блоки кода также могут иметь метку языка после обратных импульсов. Метка языка включает выделение синтаксиса для содержимого блока кода.
Блоки кода следует ограждать. Никогда не используйте отступы для блоков кода. Markdown допускает этот шаблон, но это может быть проблематично, и его следует избегать.
Блок кода — одна или несколько строк кода, заключенных в границу кода Triple-обратных тактов ( ).
Маркеры границ кода должны находиться в отдельных строках до и после примера кода. Маркер в начале блока может иметь метку языка (необязательно). Открытая система публикации Майкрософт (OPS) использует метку языка для поддержки функции выделения синтаксиса.
Полный список поддерживаемых тегов языков см. в разделе в централизованном руководством для участников.
OPS также добавляет кнопку Копировать, при нажатии которой содержимое блока кода копируется в буфер обмена. Это позволяет быстро вставить код в скрипт для тестирования примера кода. Однако не все примеры в нашей документации должны выполняться как есть. Некоторые блоки кода являются простыми иллюстрациями концепции PowerShell.
В нашей документации используются три типа блоков кода:
- Блоки синтаксиса
- пояснительные примеры;
- исполняемые примеры.
Блоки кода синтаксиса
Блоки кода синтаксиса используются для описания синтаксической структуры команды. Не используйте тег языка в границе кода. В этом примере представлены все возможные параметры командлета .
В этом примере представлена общая форма оператора :
пояснительные примеры;
Пояснительные примеры служат для иллюстрации какого-либо аспекта PowerShell. Они не предназначены для копирования в буфер обмена для выполнения. Они наиболее часто используются для простых примеров, которые легко вводить и легко понимать. Блок кода может включать в себя командную строку PowerShell и выходные данные примера.
Ниже приведен простой пример, иллюстрирующий операторы сравнения PowerShell. Этот пример не предусматривает копирование и выполнение читателем.
исполняемые примеры.
Сложные примеры или примеры, предназначенные для копирования и выполнения, должны использовать следующую разметку в блок-стиле:
Выходные данные команд PowerShell должны выноситься в отдельные блоки кода с меткой Output, чтобы не происходило выделение синтаксических конструкций. Пример:
Метка » выходной код» не является официальным «языком», поддерживаемым системой выделения синтаксиса.
Однако эта метка полезна, поскольку OPS добавляет метку Output в рамку поля кода на веб-странице. В поле «вывод» отсутствует выделение синтаксиса.
Примеры
Пример 1. Форматирование выходных данных с помощью пользовательского представления
Эта команда форматирует сведения о командлете в формате, определенном представлением MyView, пользовательским представлением, созданным пользователем. Для успешного выполнения этой команды необходимо сначала создать новый файл PS1XML, определить представление MyView , а затем с помощью команды добавить файл PS1XML в PowerShell.
Пример 2. Форматирование выходных данных с представлением по умолчанию
Эта команда форматирует сведения о процессе Winlogon в альтернативном настраиваемом представлении.
Так как команда не использует параметр View , для форматирования данных используется настраиваемое представление по умолчанию.
Правила в отношении стиля оформления кода
Избегайте продолжения строк в примерах кода
Старайтесь не использовать символы продолжения строки () в примерах кода PowerShell. Они малозаметны, а лишние пробелы в конце строки могут вызвать проблемы.
- Используйте PowerShell Сплаттинг, чтобы уменьшить длину строки для командлетов, имеющих несколько параметров.
- Воспользуйтесь преимуществами естественных возможностей переноса строк в PowerShell, например после символов вертикальной черты (), открывающих фигурных скобок ( ), круглых скобок ( ) и квадратных скобок ( ).
Избегайте использования приглашения командной строки PowerShell в примерах
Использование строки запроса не рекомендуется и должно быть ограничено сценариями, предназначенными для иллюстрации использования командной строки. В большинстве этих примеров строка запроса должна иметь значение. Она не зависит от меток ОС.
В примерах требуются запросы для демонстрации команд, которые изменяют запрос, или если отображаемый путь важен для сценария. В приведенном ниже примере демонстрируется, как меняется строка приглашения при использовании поставщика реестра.
Не используйте псевдонимы в примерах
Используйте полное имя всех командлетов и параметров, если только не задокументирован псевдоним.
Имена командлетов и параметров должны использовать правильные имена в стиле Pascal .
Использование параметров в примерах
Избегайте использования позиционных параметров. Как правило, в примере всегда следует включать имя параметра, даже если параметр является позиционированным. Это снижает вероятность возникновения путаницы.
Определения ключей хэш-таблицы
- / — указывает имя создаваемого свойства. Можно использовать или его псевдоним, взаимозаменяемо.
- — блок скрипта, используемый для вычисления значения нового свойства.
- — Используется командлетами, которые создают табличные выходные данные, чтобы определить, как значения отображаются в столбце. Значение должно быть равно , или .
- — задает строку формата, определяющую форматирование значения для выходных данных. Дополнительные сведения о строках форматирования см. в разделе «Типы формата» в .NET.
- — указывает столбец максимальной ширины в таблице при отображении значения. Значение должно быть больше .
- — Параметр Depth указывает глубину расширения для всех свойств. Ключ позволяет указать глубину расширения для каждого свойства.
- / — позволяет указать порядок сортировки для одного или нескольких свойств. Это логические значения.
Хэш-хэш-ключи не нужно указывать, если указанный префикс имени является однозначным. Например, можно использовать вместо этого.
Изучение объектов с помощью Get-Member
Научившись находить нужный командлет, вы, возможно, захотите узнать больше о результате его выполнения, то есть о выходных данных. Выходные данные представляют интерес по нескольким причинам, в число которых входят следующие:
- Автономность. Можно выполнить всего одну команду и отобразить результаты в каком-либо отчете. Вопрос в том, какой результат выдает команда: подходящий или требующий изменений.
- Использование в конвейере. В PowerShell распространена возможность включения нескольких команд в конвейер для получения данных, фильтрации и преобразования. Чтобы команда подходила для использования в конвейере, необходимо иметь представление о ее входных и выходных данных. Суть в том, что выходные данные команды являются входными данными другой команды.
Командлет отображает тип, свойства и методы объекта результата. Передайте выходные данные, которые требуется изучить, в командлет .
В выходных данных отображается возвращаемый тип, а затем — все свойства и методы объекта. Вот фрагмент такого результата:
Как правило, объект обычно имеет множество свойств и методов, поэтому чтобы упростить поиск нужного компонента, можно отфильтровать результаты. С помощью параметра можно указать, к примеру, отображение всех методов, как показано в приведенном ниже примере.
При получении ответа PowerShell обычно выводит лишь несколько свойств. В приведенном выше ответе отображаются , и . Чтобы изменить эти выходные данные, можно воспользоваться командлетом . позволяет указать необходимые для отображения столбцы. В командлете можно указать имя столбца, список с разделителями-запятыми или подстановочный знак . Ниже приведен пример использования командлета используется для извлечения и .
Поиск по типу
Другой способ поиска нужной команды заключается в поиске команд, работающих с одним и тем же типом. При выполнении вы получили возвращаемый тип в виде первой строки ответа, как показано ниже:
Теперь вы можете использовать этот тип и искать команды следующим образом:
Результатом выполнения приведенной выше команды является список команд, которые работают исключительно с типом :
Как видите, зная тип команды, можно значительно сузить область поиска интересующих команд.
Параметры
-InputObject
Указывает объекты для записи в строку. Введите переменную, которая содержит объекты, или команду или выражение, которое возвращает объекты.
Type: | PSObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoNewline
Удаляет все новые строки из выходных данных, созданных методом форматирования PowerShell. Новые строки, которые являются частью строковых объектов, сохраняются.
Этот параметр появился в PowerShell 6.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Stream
По умолчанию выводит одну строку в формате, которая отображается в консоли, включая все пустые заголовки или конечные новые строки. Параметр Stream позволяет выводить каждую строку по очереди. Единственным исключением являются многостроковые строки. В этом случае будет по-прежнему выводить строку в виде одной многостроочной строки.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Width
Указывает количество символов в каждой строке выходных данных. Все дополнительные символы помещаются в следующую строку или усекаются в зависимости от используемого командлета модуля форматирования. Параметр Width применяется только к отформатированным объектам. Если данный параметр не указан, ширина определяется характеристиками основного приложения. В окнах терминала (консоли) в качестве значения по умолчанию используется текущая ширина окна. Окна консоли PowerShell по умолчанию шириной 80 символов при установке.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |