Show-Command
Crea i comandi di Windows PowerShell in una finestra di comando grafica.
Sintassi
Show-Command
[[-Name] <String>]
[-Height <Double>]
[-Width <Double>]
[-NoCommonParameter]
[-ErrorPopup]
[-PassThru]
[<CommonParameters>]
Descrizione
Il cmdlet Show-Command consente di creare un comando di Windows 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 in 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 dei comandi, 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.
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 Windows PowerShell. Per annullare la selezione dei comandi e tornare alla visualizzazione che visualizza tutti i comandi, premere CTRL e fare clic sul comando selezionato.
In Windows PowerShell Integrated Scripting Environment (ISE) una variante della finestra Show-Command è visualizzata per impostazione predefinita. Per informazioni sull'uso di questa finestra di comando, vedere gli argomenti della Guida ISE Windows PowerShell.
Questo cmdlet è stato introdotto in Windows PowerShell 3.0.
Esempio
Esempio 1: Aprire la finestra Comandi
PS C:\> Show-Command
Questo comando consente di mostrare la visualizzazione predefinita della finestra Show-Command. La finestra Comandi visualizza un elenco di tutti i comandi in tutti i moduli installati nel computer.
Esempio 2: Aprire un cmdlet nella finestra Comandi
PS C:\> Show-Command -Name "Invoke-Command"
Questo comando apre il cmdlet Invoke-Command visualizzato nella finestra Show-Command . È possibile usare la visualizzazione Invoke-Command per eseguire i comandi Invoke-Command .
Esempio 3: Aprire un cmdlet con parametri specificati
PS C:\> Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup
Questo comando apre una finestra Show-Command per il cmdlet Connect-PSSession. Usa i parametri Height e Width per specificare la dimensione della finestra di comando e il parametro ErrorPopup per visualizzare la finestra di comando di errore.
Quando fa clic su Run, il comando Connect-PSSession viene eseguito esattamente come se il comando Connect-PSSession fosse stato digitato nella riga di comando.
Esempio 4: Specificare nuovi valori di parametro predefiniti per un cmdlet
PS C:\> $PSDefaultParameterValues = @{"Show-Command:Height" = 700; "Show-Command:Width" = 1000; "Show-Command:ErrorPopup" = $True}
Questo comando usa la variabile automatica $PSDefaultParameterValues per impostare nuovi valori predefiniti per i parametri Height, Width e ErrorPopup del cmdlet Show-Command. Ora, quando si esegue un comando Show-Command, i nuovi valori predefiniti vengono applicati automaticamente.
Per usare questi valori predefiniti in ogni sessione di Windows PowerShell, aggiungere la variabile $PSDefaultParameterValues al profilo di Windows PowerShell. Per altre informazioni, vedere about_Profiles e about_Parameters_Default_Values.
Esempio 5: Inviare l'output a una visualizzazione griglia
PS C:\> Show-Command Get-ChildItem | Out-GridView
Questo comando illustra come usare insieme i cmdlet Show-Command e Out-GridView.
Il comando usa il cmdlet Show-Command per aprire una finestra di comando per il cmdlet Get-ChildItem. Quando si fa clic sul pulsante Run, il comando Get-ChildItem viene eseguito e genera l'output. L'operatore pipeline (|) invia l'output del comando Get-ChildItem al cmdlet Out-GridView, che visualizza l'output di Get-ChildItem in una finestra interattiva.
Esempio 6: Visualizzare un comando creato nella finestra Comandi
PS C:\> Show-Command -PassThru
Get-EventLog -LogName "Windows PowerShell" -Newest 5
Questo comando mostra il comando creato nella finestra Show-Command. Il comando usa il parametro PassThru , che restituisce i risultati show-Command in una stringa.
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 Windows PowerShell, quindi fare clic su OK, il comando restituisce l'output seguente.
La visualizzazione della stringa di comando consente di acquisire familiarità con Windows PowerShell.
Esempio 7: Salvare un comando in una variabile
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. ...
Questo comando mostra come eseguire la stringa di comando che si ottiene quando si usa il parametro PassThru del cmdlet Show-Command. Questa strategia consente di visualizzare il comando e di usarlo.
Il primo comando usa il parametro PassThru del cmdlet Show-Command. Salva i risultati del comando nella variabile $C.
Il comando apre una finestra Show-Command . In questo caso, si usa la finestra Show-Command per creare un comando Get-EventLog 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 variabile $C.
Esempio 8: Salvare l'output di un comando in una variabile
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
Questi comandi usano il parametro ErrorPopup del cmdlet Show-Command per salvare l'output di un comando in una variabile.
Il primo comando esegue il cmdlet Show-Command con il parametro ErrorPopup. 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 la funzionalità della finestra per impostare i valori dei parametri. Per eseguire il comando, fare clic sul pulsante Run 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 Show-Command genera un errore, l'errore viene visualizzato solo nella riga di comando.
Inoltre, quando si esegue il comando (tramite il pulsante Run nella finestra Show-Command), 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: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 Show-Command 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, di un flusso di lavoro o di un comando CIM. Se si omette questo parametro, Show-Command visualizza una finestra di comando che elenca tutti i comandi di Windows 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: | None |
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 nel prompt dei comandi o salvarla in una variabile e usare il cmdlet Invoke-Expression per eseguire la stringa nella variabile.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Double |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
None
Non è possibile inviare l'input della pipe a Show-Command.
Output
System.String, System.Object
Quando si usa il parametro PassThru, Show-Command restituisce una stringa di comando. Quando si usa il parametro ErrorPopup, Show-Command restituisce l'output del comando (qualsiasi oggetto). In caso contrario, Show-Command non genera alcun output.
Note
- Show-Command non funziona nelle sessioni remote.