Show-Command

Riferimento

Modulo:: Microsoft.PowerShell.Utility

Visualizza le informazioni sui comandi di PowerShell in una finestra grafica.

Sintassi

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

Descrizione

Questo cmdlet è disponibile solo nella piattaforma Windows.

Il cmdlet Show-Command consente di creare un comando di PowerShell in una finestra di comando. È possibile usare le funzionalità della finestra di comando per eseguire il comando o restituirlo all'utente.

Show-Command è uno strumento di apprendimento e insegnamento molto utile. Show-Command funziona su tutti i tipi di comando, inclusi cmdlet, funzioni, flussi di lavoro e comandi CIM.

Senza parametri, Show-Command visualizza una finestra di comando che elenca tutti i comandi disponibili in tutti i moduli installati. Per trovare i comandi in un modulo, selezionare il modulo dall'elenco a discesa Moduli. Per selezionare un comando, fare clic sul nome del comando.

Per usare la finestra di comando, selezionare un comando usando il nome oppure facendo clic sul nome del comando nell'elenco comandi. Ogni set di parametri viene visualizzato in una scheda separata. Gli asterischi indicano i parametri obbligatori. Per immettere i valori per un parametro, digitare il valore nella casella di testo o selezionare il valore nella casella di riepilogo a discesa. Per aggiungere un parametro switch, fare clic per selezionare la casella di controllo del parametro.

Quando si è pronti, è possibile fare clic su Copia per copiare il comando creato negli Appunti oppure fare clic su Esegui per eseguire il comando. È anche possibile usare il parametro PassThru per restituire il comando al programma host, ad esempio la console di PowerShell. Per annullare la selezione del comando e tornare alla visualizzazione che visualizza tutti i comandi, premere CTRL e fare clic sul comando selezionato.

In PowerShell Integrated Scripting Environment (ISE) viene visualizzata una variante della finestra Show-Command per impostazione predefinita. Per informazioni sull'uso di questa finestra di comando, vedere gli argomenti della Guida di PowerShell ISE.

Questo cmdlet è stato reintrodotto in PowerShell 7.

Poiché questo cmdlet richiede un'interfaccia utente, non funziona in Windows Server Core o Windows Nano Server. Questo cmdlet è disponibile solo nei sistemi Windows che supportano Windows Desktop.

Esempio

Esempio 1: Aprire la finestra Comandi

In questo esempio viene visualizzata la visualizzazione predefinita della finestra di Show-Command. Nella finestra comandi viene visualizzato un elenco di tutti i comandi in tutti i moduli installati nel computer.

Show-Command

Esempio 2: Aprire un cmdlet nella finestra Comandi

In questo esempio viene visualizzato il cmdlet nella finestra comando . È possibile usare questa visualizzazione per eseguire Invoke-Command comandi.

Show-Command -Name "Invoke-Command"

Esempio 3: Aprire un cmdlet con parametri specificati

Questo comando apre una finestra di Show-Command per il cmdletConnect-PSSession.

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

I parametri Height e Width Width specificano la dimensione della finestra di comando. Il parametro ErrorPopup visualizza la finestra di comando dell'errore.

Quando si fa clic su Esegui, viene eseguito il comando Connect-PSSession, come se si digitasse il comando Connect-PSSession nella riga di comando.

Esempio 4: Specificare nuovi valori di parametro predefiniti per un cmdlet

In questo esempio viene usata la variabile automatica $PSDefaultParameterValues per impostare nuovi valori predefiniti per i parametri Height Widthe ErrorPopup del cmdlet Show-Command.

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

Quando si esegue un comando Show-Command, le nuove impostazioni predefinite vengono applicate automaticamente. Per usare questi valori predefiniti in ogni sessione di PowerShell, aggiungere la variabile $PSDefaultParameterValues al profilo di PowerShell. Per altre informazioni, vedere about_Profiles e about_Parameters_Default_Values.

Esempio 5: Inviare l'output a una visualizzazione griglia

Questo comando illustra come usare insieme i cmdlet Show-Command e Out-GridView.

Show-Command Get-ChildItem | Out-GridView

Il comando usa il cmdlet Show-Command per aprire una finestra di comando per il cmdletGet-ChildItem. Quando si fa clic sul pulsante Esegui , il comando viene eseguito e generato l'output. L'operatore pipeline ( | ) invia l'output del comando Get-ChildItem al cmdlet Out-GridView, che visualizza l'output Get-ChildItem in una finestra interattiva.

Esempio 6: Visualizzare un comando creato nella finestra Comandi

Questo esempio mostra il comando creato nella finestra di Show-Command. Il comando usa il parametro PassThru, che restituisce il Show-Command restituisce una stringa.

Show-Command -PassThru

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

Ad esempio, se si usa la finestra Show-Command per creare un comando Get-EventLog che ottiene i cinque eventi più recenti nel registro eventi di Windows PowerShell e quindi fare clic su OK, il comando restituisce l'output illustrato sopra. La visualizzazione della stringa di comando consente di apprendere PowerShell.

Esempio 7: Salvare un comando in una variabile

In questo esempio viene illustrato come eseguire la stringa di comando che si ottiene quando si usa il parametro PassThru del cmdlet . Questa strategia consente di visualizzare il comando e usarlo.

$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. ...

Il primo comando usa il parametro PassThru del cmdlet Show-Command e salva i risultati del comando nella variabile $C. In questo caso, usiamo la finestra Show-Command per creare un comando Get-EventLog che ottiene i cinque eventi più recenti nel registro eventi di Windows PowerShell. Quando si fa clic su OK, Show-Command restituisce la stringa di comando salvata nella variabile $C.

Esempio 8: Salvare l'output di un comando in una variabile

Questo esempio usa il parametro ErrorPopup per salvare l'output di un comando in una variabile.

$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

Oltre a visualizzare gli errori in una finestra, ErrorPopup restituisce l'output del comando al comando corrente, anziché creare un nuovo comando. Quando si esegue questo comando, viene visualizzata la finestra Show-Command. È possibile usare le funzionalità della finestra per impostare i valori dei parametri. Per eseguire il comando, fare clic sul pulsante Esegui nella finestra Show-Command.

Parametri

-ErrorPopup

Indica che il cmdlet visualizza gli errori in una finestra popup, oltre a visualizzarli nella riga di comando. Per impostazione predefinita, quando un comando eseguito in una finestra di Show-Command genera un errore, l'errore viene visualizzato solo nella riga di comando.

Inoltre, quando si esegue il comando (usando il pulsante Esegui nella finestra di ), il parametro ErrorPopup restituisce i risultati del comando al comando corrente, anziché eseguire il comando e restituire l'output a un nuovo comando. È possibile usare questa funzionalità per salvare i risultati del comando in una variabile.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Height

Specifica l'altezza della finestra Show-Command in pixel. Immettere un valore compreso tra 300 e il numero di pixel nella risoluzione dello schermo. Se il valore è troppo grande per visualizzare la finestra di comando sullo schermo, Show-Command genera un errore. L'altezza predefinita è 600 pixel. Per un comando che include il parametro Nome , l'altezza predefinita è 300 pixel.

Tipo:	Double
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Name

Visualizza una finestra di comando per il comando specificato. Immettere il nome di un comando, ad esempio il nome di un cmdlet, di una funzione o di un comando CIM. Se si omette questo parametro, Show-Command visualizza una finestra di comando che elenca tutti i comandi di PowerShell in tutti i moduli installati nel computer.

Tipo:	String
Alias:	CommandName
Posizione:	0
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-NoCommonParameter

Indica che questo cmdlet omette la sezione Parametri comuni della visualizzazione del comando. Per impostazione predefinita, i parametri comuni vengono visualizzati in una sezione espandibile nella parte inferiore della finestra di comando.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PassThru

Restituisce un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet non genera alcun output. Per eseguire la stringa di comando, copiarlo e incollarlo al prompt dei comandi o salvarlo in una variabile e usare il cmdlet Invoke-Expression per eseguire la stringa nella variabile.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Width

Specifica la larghezza della finestra Show-Command in pixel. Immettere un valore compreso tra 300 e il numero di pixel nella risoluzione dello schermo. Se il valore è troppo grande per visualizzare la finestra di comando sullo schermo, Show-Command genera un errore. La larghezza predefinita è 300 pixel.

Tipo:	Double
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

None

Per impostazione predefinita, questo cmdlet non restituisce alcun output.

String

Quando si usa il parametro PassThru, questo cmdlet restituisce una stringa di comando.

Object

Quando si usa il parametro ErrorPopup , questo cmdlet restituisce l'output del comando (qualsiasi oggetto).

Note

PowerShell include gli alias seguenti per Show-Command:

Finestre:
- shcm

Questo cmdlet è disponibile solo nelle piattaforme Windows.

Show-Command non funziona nelle sessioni remote.

Condividi tramite