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 di insegnamento e apprendimento 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 o 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.

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 (I edizione Standard) 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 I edizione Standard.

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 Di comando . È possibile usare questa visualizzazione per eseguire Invoke-Command i comandi.

Show-Command -Name "Invoke-Command"

Esempio 3: Aprire un cmdlet con 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 Get-ChildItem comando viene eseguito e generato l'output. 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 di 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, usiamo la Show-Command finestra per creare un Get-EventLog comando 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 $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, 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.

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, copiarlo e incollarlo al prompt dei comandi o salvarlo 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.