Show-Command
Cria comandos do Windows PowerShell em uma janela de comando gráfico.
Sintaxe
Default (Predefinição)
Show-Command
[[-Name] <String>]
[-Height <Double>]
[-Width <Double>]
[-NoCommonParameter]
[-ErrorPopup]
[-PassThru]
[<CommonParameters>]
Description
O cmdlet Show-Command permite criar um comando do Windows PowerShell em uma janela de comando. Você pode usar os recursos da janela de comando para executar o comando ou fazer com que ele retorne o comando para você.
Show-Command é uma ferramenta de ensino e aprendizagem muito útil. Show-Command funciona em todos os tipos de comando, incluindo cmdlets, funções, fluxos de trabalho e comandos CIM.
Sem parâmetros, Show-Command exibe uma janela de comando que lista todos os comandos disponíveis em todos os módulos instalados. Para localizar os comandos em um módulo, selecione o módulo na lista suspensa Módulos. Para selecionar um comando, clique no nome do comando.
Para usar a janela de comando, selecione um comando, usando o Nome ou clicando no nome do comando na lista Comandos
Quando estiver pronto, você pode clicar em
No ISE (Ambiente de Script Integrado) do Windows PowerShell, uma variação da janela Show-Command é exibida por padrão. Para obter informações sobre como usar essa janela de comando, consulte os tópicos da Ajuda do ISE do Windows PowerShell.
Este cmdlet foi introduzido no Windows PowerShell 3.0.
Exemplos
Exemplo 1: Abrir a janela Comandos
PS C:\> Show-Command
Este comando exibe a exibição padrão da janela Show-Command. A janela Comandos exibe uma lista de todos os comandos em todos os módulos instalados no computador.
Exemplo 2: Abrir um cmdlet na janela Comandos
PS C:\> Show-Command -Name "Invoke-Command"
Este comando abre a exibição do cmdlet Invoke-Command na janela Show-Command. Você pode usar a exibição Invoke-Command para executar comandos Invoke-Command.
Exemplo 3: Abrir um cmdlet com parâmetros especificados
PS C:\> Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup
Este comando abre uma janela Show-Command para o cmdlet Connect-PSSession. Ele usa os parâmetros Height e Width para especificar a dimensão da janela de comando e o parâmetro ErrorPopup para exibir a janela de comando de erro.
Quando você clica em Executar, o comando Connect-PSSession é executado, assim como se você digitasse o comando Connect-PSSession na linha de comando.
Exemplo 4: Especificar novos valores de parâmetro padrão para um cmdlet
PS C:\> $PSDefaultParameterValues = @{"Show-Command:Height" = 700; "Show-Command:Width" = 1000; "Show-Command:ErrorPopup" = $True}
Este comando usa a variável automática $PSDefaultParameterValues para definir novos valores padrão para os parâmetros Height, Widthe ErrorPopup do cmdlet Show-Command. Agora, quando você executa um comando Show-Command, os novos padrões são aplicados automaticamente.
Para usar esses valores padrão em cada sessão do Windows PowerShell, adicione a variável $PSDefaultParameterValues ao seu perfil do Windows PowerShell. Para obter mais informações, consulte about_Profiles e about_Parameters_Default_Values.
Exemplo 5: Enviar saída para uma vista de grelha
PS C:\> Show-Command Get-ChildItem | Out-GridView
Este comando mostra como usar o Show-Command e Out-GridView cmdlets juntos.
O comando usa o cmdlet Show-Command para abrir uma janela de comando para o cmdlet Get-ChildItem.
Quando você clica no botão Executar, o comando Get-ChildItem é executado e gera saída.
O operador de pipeline ( | ) envia a saída do comando
Exemplo 6: Exibir um comando criado na janela Comandos
PS C:\> Show-Command -PassThru
Get-EventLog -LogName "Windows PowerShell" -Newest 5
Este comando mostra o comando que você criou na janela Show-Command. O comando usa o parâmetro PassThru, que retorna o Show-Command resulta em uma cadeia de caracteres.
Por exemplo, se você usar a janela Show-Command para criar um comando Get-EventLog que obtenha os cinco eventos mais recentes no log de eventos do Windows PowerShell e clique em OK, o comando retornará a saída a seguir.
Exibir a cadeia de caracteres de comando ajuda você a aprender o Windows PowerShell.
Exemplo 7: Salvar um comando em uma variável
PS C:\> $C = Show-Command -PassThru
This command displays the command string in the $C variable.
PS C:\> $C
Get-EventLog -LogName "Windows PowerShell" -Newest 5
These commands use the Invoke-Expression cmdlet to run the string in the $C variable. The first command uses the full cmdlet name. The second command uses the "iex" alias for the **Invoke-Expression** cmdlet. These commands are equivalent and you can use them interchangeably.The output shows the five newest events in the Windows PowerShell event log.
PS C:\> Invoke-Expression $C
PS C:\> iex $C
Index Time EntryType Source InstanceID Message
----- ---- --------- ------ ---------- -------
11520 Dec 16 16:37 Information PowerShell 400 Engine state is changed from None to Available....
11519 Dec 16 16:37 Information PowerShell 600 Provider "Variable" is Started. ...
11518 Dec 16 16:37 Information PowerShell 600 Provider "Registry" is Started. ...
11517 Dec 16 16:37 Information PowerShell 600 Provider "Function" is Started. ...
11516 Dec 16 16:37 Information PowerShell 600 Provider "FileSystem" is Started. ...
Este comando mostra como executar a cadeia de caracteres de comando que você obtém quando usa o parâmetro PassThru do cmdlet Show-Command. Essa estratégia permite que você veja o comando e use-o.
O primeiro comando usa o parâmetro
O comando abre uma janela Show-Command. Nesse caso, usamos a janela Show-Command para criar um comando Get-EventLog que obtém os cinco eventos mais recentes no log de eventos do Windows PowerShell. Quando você clica em OK, Show-Command retorna a cadeia de comando, que é salva na variável $C.
Exemplo 8: Salvar a saída de um comando em uma variável
PS C:\> $P = Show-Command Get-Process -ErrorPopup
The second command displays the value in the $P variable.
PS C:\> $P
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
473 33 94096 112532 709 2.06 4492 powershell
Esses comandos usam o parâmetro ErrorPopup do cmdlet Show-Command para salvar a saída de um comando em uma variável.
O primeiro comando executa o cmdlet Show-Command com o parâmetro ErrorPopup. Além de exibir erros em uma janela, ErrorPopup retorna a saída do comando para o comando atual, em vez de criar um novo comando.
Quando você executa esse comando, a janela Show-Command é aberta.
Você pode usar os recursos da janela para definir valores de parâmetro.
Para executar o comando, clique no botão
Parâmetros
-ErrorPopup
Indica que o cmdlet exibe erros em uma janela pop-up, além de exibi-los na linha de comando. Por padrão, quando um comando executado em uma janela Show-Command gera um erro, o erro é exibido somente na linha de comando.
Além disso, quando você executa o comando (usando o botão
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Height
Especifica a altura da janela Show-Command em pixels. Insira um valor entre 300 e o número de pixels na resolução da tela. Se o valor for muito grande para exibir a janela de comando na tela, Show-Command gerará um erro. A altura padrão é de 600 pixels. Para um comando Show-Command que inclui o parâmetro Name, a altura padrão é de 300 pixels.
Propriedades dos parâmetros
| Tipo: | Double |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
Exibe uma janela de comando para o comando especificado. Insira o nome de um comando, como o nome de um cmdlet, função, fluxo de trabalho ou comando CIM. Se você omitir esse parâmetro, Show-Command exibirá uma janela de comando que lista todos os comandos do Windows PowerShell em todos os módulos instalados no computador.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | CommandName |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-NoCommonParameter
Indica que esse cmdlet omite a seção Common Parameters da exibição de comandos. Por padrão, os parâmetros comuns aparecem em uma seção expansível na parte inferior da janela de comando.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-PassThru
Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet não gera nenhuma saída.
Para executar a cadeia de comandos, copie-a e cole-a no prompt de comando ou salve-a em uma variável e use o cmdlet Invoke-Expression para executar a cadeia de caracteres na variável.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Width
Especifica a largura da janela Show-Command em pixels. Insira um valor entre 300 e o número de pixels na resolução da tela. Se o valor for muito grande para exibir a janela de comando na tela, Show-Command gerará um erro. A largura padrão é de 300 pixels.
Propriedades dos parâmetros
| Tipo: | Double |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
None
Não é possível canalizar a entrada para Show-Command.
Saídas
System.String, System.Object
Quando você usa o parâmetro PassThru, Show-Command retorna uma cadeia de comando. Quando você usa o parâmetro ErrorPopup, Show-Command retorna a saída do comando (qualquer objeto). Caso contrário, Show-Command não gerará nenhuma saída.
Notas
- Show-Command não funciona em sessões remotas.