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 Show-Command cmdlet 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 per restituire il comando all'utente.

Show-Command è uno strumento molto utile per l'insegnamento e l'apprendimento. 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 dalla casella di riepilogo a discesa. Per aggiungere un parametro opzionale, fare clic per selezionare la casella di controllo del parametro.

Al termine, è possibile fare clic su Copy per copiare il comando appena creato negli Appunti o fare clic su Run 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 Show-Command finestra 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 Show-Command finestra. 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 Invoke-Command cmdlet nella finestra Comando . È possibile usare questa visualizzazione per eseguire Invoke-Command i comandi.

Show-Command -Name "Invoke-Command"

Esempio 3: Aprire un cmdlet con i parametri specificati

Questo comando apre una Show-Command finestra per ilConnect-PSSessioncmdlet .

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

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

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

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

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

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

Quando si esegue un Show-Command comando, le nuove impostazioni predefinite vengono applicate automaticamente. Per usare questi valori predefiniti in ogni sessione di PowerShell, aggiungere la $PSDefaultParameterValues variabile 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 Show-Command cmdlet e Out-GridView .

Show-Command Get-ChildItem | Out-GridView

Il comando usa il Show-Command cmdlet per aprire una finestra di comando per ilGet-ChildItemcmdlet . Quando si fa clic sul pulsante Esegui , il comando viene eseguito e generato l'output Get-ChildItem . L'operatore pipeline ( | ) invia l'output del Get-ChildItem comando al Out-GridView cmdlet , 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 Show-Command finestra. Il comando usa il parametro PassThru , che restituisce i Show-Command risultati in una stringa.

Show-Command -PassThru

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

Ad esempio, se si usa la Show-Command finestra per creare un Get-EventLog comando che ottiene i cinque eventi più recenti nel registro eventi Windows PowerShell e quindi fare clic su OK, il comando restituisce l'output illustrato in precedenza. 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 Show-Command cmdlet . Questa strategia consente di visualizzare il comando e di 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 Show-Command cmdlet e salva i risultati del comando nella $C variabile . In questo caso, viene usata la Show-Command finestra per creare un Get-EventLog comando che ottiene i cinque eventi più recenti nel registro eventi Windows PowerShell. Quando si fa clic su OK, Show-Command restituisce la stringa di comando salvata nella $C variabile .

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

In questo esempio viene usato 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 Show-Command finestra. È possibile usare la funzionalità della finestra per impostare i valori dei parametri. Per eseguire il comando, fare clic sul pulsante Esegui nella Show-Command finestra.

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 Show-Command finestra genera un errore, l'errore viene visualizzato solo nella riga di comando.

Inoltre, quando si esegue il comando (usando il pulsante Esegui nella Show-Command finestra), 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.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Height

Specifica l'altezza della Show-Command finestra 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 Show-Command comando che include il parametro Name , l'altezza predefinita è 300 pixel.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Visualizza una finestra di comando per il comando specificato. Immettere il nome di un comando, ad esempio il nome di un cmdlet, una funzione o 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.

Type:	String
Aliases:	CommandName
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Restituisce un oggetto che rappresenta l'elemento in uso. Per impostazione predefinita, il cmdlet non genera alcun output. Per eseguire la stringa di comando, copiarla e incollarla al prompt dei comandi o salvarla in una variabile e usare il Invoke-Expression cmdlet per eseguire la stringa nella variabile.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Width

Specifica la larghezza della Show-Command finestra 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.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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:

Windows:
- shcm

Questo cmdlet è disponibile solo nelle piattaforme Windows.

Show-Command non funziona nelle sessioni remote.

Condividi tramite