Show-Command

Show-Command
    [[-Name] <String>]
    [-Height <Double>]
    [-Width <Double>]
    [-NoCommonParameter]
    [-ErrorPopup]
    [-PassThru]
    [<CommonParameters>]

Этот командлет доступен только на платформе Windows.

Командлет Show-Command позволяет создать команду PowerShell в командном окне. Вы можете использовать функции командного окна для выполнения команды или возврата команды.

Show-Command — это очень полезное средство обучения и обучения. Show-Command работает со всеми типами команд, включая командлеты, функции, рабочие процессы и команды CIM.

Без параметров отображается окно команд, Show-Command в котором перечислены все доступные команды во всех установленных модулях. Чтобы найти команды в модуле, выберите модуль из раскрывающегося списка модулей. Чтобы выбрать команду, щелкните имя команды.

Чтобы использовать командное окно, выберите команду с помощью поля Имя или щелкнув имя команды в списке Команды . Каждый набор параметров отображается на отдельной вкладке. Звездочки указывают обязательные параметры. Чтобы ввести значения для параметра, введите значение в текстовом поле или выберите значение из раскрывающегося списка. Чтобы добавить параметр переключателя, щелкните, чтобы установить флажок параметра.

Когда вы будете готовы, щелкните Копировать, чтобы скопировать команду, созданную в буфер обмена, или нажать кнопку Выполнить, чтобы выполнить команду. Вы также можете использовать параметр PassThru , чтобы вернуть команду в хост-программу, например консоль PowerShell. Чтобы отменить выделение команды и вернуться в представление, отображающее все команды, нажмите клавиши CTRL и щелкните выбранную команду.

В интегрированной среде сценариев PowerShell (ISE) по умолчанию отображается вариант Show-Command окна. Сведения об использовании этого командного окна см. в разделах справки по isE PowerShell.

Этот командлет был повторно введен в PowerShell 7.

Так как для этого командлета требуется пользовательский интерфейс, он не работает в Windows Server Core или Windows Nano Server. Этот командлет доступен только в системах Windows, поддерживающих рабочий стол Windows.

В этом примере отображается представление Show-Command окна по умолчанию. В окне "Команды" отображается список всех команд во всех модулях, установленных на компьютере.

Show-Command

В этом примере отображается Invoke-Command командлет в окне командной строки . Это отображение можно использовать для выполнения Invoke-Command команд.

Show-Command -Name "Invoke-Command"

Эта команда открывает Show-Command окно для командлетаConnect-PSSession.

Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup

Параметры высоты и ширины указывают измерение командного окна. Параметр ErrorPopup отображает окно команды ошибки.

При нажатии кнопки "Выполнить" команда выполняется так же, Connect-PSSession как если бы вы ввели Connect-PSSession команду в командной строке.

В этом примере используется автоматическая $PSDefaultParameterValues переменная для задания новых значений по умолчанию для параметров Height, Width и ErrorPopup командлета Show-Command .

$PSDefaultParameterValues = @{
    "Show-Command:Height" = 700
    "Show-Command:Width" = 1000
    "Show-Command:ErrorPopup" = $true
}

Теперь при выполнении Show-Command команды новые значения по умолчанию применяются автоматически. Чтобы использовать эти значения по умолчанию в каждом сеансе PowerShell, добавьте $PSDefaultParameterValues переменную в профиль PowerShell. Дополнительные сведения см. в разделе about_Profiles и about_Parameters_Default_Values.

Эта команда показывает, как совместно использовать Show-Command командлеты и Out-GridView командлеты.

Show-Command Get-ChildItem | Out-GridView

Команда использует Show-Command командлет для открытия командного окна для командлетаGet-ChildItem. При нажатии кнопки Get-ChildItem"Выполнить" команда запускается и создает выходные данные. Оператор конвейера (|) отправляет выходные данные команды Out-GridView командлету, который отображает Get-ChildItem выходные данные Get-ChildItem в интерактивном окне.

В этом примере показана команда, созданная в Show-Command окне. Команда использует параметр PassThru , который возвращает Show-Command результаты в строке.

Show-Command -PassThru

Get-EventLog -LogName "Windows PowerShell" -Newest 5

Например, если вы используете Show-Command окно для создания Get-EventLog команды, которая получает пять новых событий в журнале событий Windows PowerShell, а затем нажмите кнопку "ОК", команда возвращает выходные данные, показанные выше. Просмотр командной строки поможет вам узнать PowerShell.

В этом примере показано, как запустить командную строку, которую вы получаете при использовании параметра PassThru командлета Show-Command . Эта стратегия позволяет просматривать команду и использовать ее.

$C = Show-Command -PassThru
$C
Invoke-Expression $C

Get-EventLog -LogName "PowerShell" -Newest 5

Index Time          EntryType   Source                 InstanceID Message
----- ----          ---------   ------                 ---------- -------
11520 Dec 16 16:37  Information Windows PowerShell            400 Engine state is changed from None to Available...
11519 Dec 16 16:37  Information Windows PowerShell            600 Provider "Variable" is Started. ...
11518 Dec 16 16:37  Information Windows PowerShell            600 Provider "Registry" is Started. ...
11517 Dec 16 16:37  Information Windows PowerShell            600 Provider "Function" is Started. ...
11516 Dec 16 16:37  Information Windows PowerShell            600 Provider "FileSystem" is Started. ...

Первая команда использует параметр PassThru командлета Show-Command и сохраняет результаты команды в переменной $C . В этом случае мы используем Show-Command окно для создания Get-EventLog команды, которая получает пять новых событий в журнале событий Windows PowerShell. При нажатии кнопки ОКShow-Command возвращает командную строку, которая сохраняется в переменной$C.

В этом примере используется параметр ErrorPopup для сохранения выходных данных команды в переменной.

$P = Show-Command Get-Process -ErrorPopup
$P

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
    473      33    94096     112532   709     2.06   4492 powershell

Помимо отображения ошибок в окне, ErrorPopup возвращает вывод команды текущей команде, а не создает новую команду. При выполнении Show-Command этой команды откроется окно. Вы можете использовать функции окна для установки значений параметров. Чтобы выполнить команду, нажмите кнопку "Запустить " в Show-Command окне.

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

Невозможно передать объекты в этот командлет.

По умолчанию этот командлет не возвращает выходные данные.

При использовании параметра PassThru этот командлет возвращает командную строку.

При использовании параметра ErrorPopup этот командлет возвращает выходные данные команды (любой объект).

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

• Виндоус:
  • shcm

Этот командлет доступен только на платформах Windows.

Show-Command не работает в удаленных сеансах.