Show-Command
Crea comandi di Windows PowerShell in una finestra di comando grafica.
Sintassi
Default (Impostazione predefinita)
Show-Command
[[-Name] <String>]
[-Height <Double>]
[-Width <Double>]
[-NoCommonParameter]
[-ErrorPopup]
[-PassThru]
[<CommonParameters>]
Descrizione
Il cmdlet Show-Command
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. È inoltre possibile utilizzare il parametro PassThru per restituire il comando al programma host, ad esempio la console di Windows 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 Windows PowerShell Integrated Scripting Environment (ISE), per impostazione predefinita viene visualizzata una variante della finestra Show-Command
Questo cmdlet è stato introdotto in Windows PowerShell 3.0.
Esempio
Esempio 1: Aprire la finestra Comandi
PS C:\> Show-Command
Questo comando visualizza la visualizzazione predefinita della finestra
Esempio 2: Aprire un cmdlet nella finestra Comandi
PS C:\> Show-Command -Name "Invoke-Command"
Questo comando apre la visualizzazione del cmdlet Invoke-Command nella finestra
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
Quando si fa clic su
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
Per utilizzare questi valori predefiniti in ogni sessione di Windows PowerShell, aggiungere la variabile $PSDefaultParameterValues al profilo di Windows PowerShell. Per ulteriori 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
Il comando usa il cmdlet Show-Command
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
Ad esempio, se si usa la finestra
La visualizzazione della stringa di comando consente di apprendere 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 illustra come eseguire la stringa di comando che si ottiene quando si usa il parametro PassThru
Il primo comando utilizza 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, viene utilizzata 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, che viene 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
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, si apre 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 un 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
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Height
Specifica l'altezza della finestra show-command
Proprietà dei parametri
| Tipo: | Double |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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, un flusso di lavoro o 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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | CommandName |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Width
Specifica la larghezza della finestra di show-command
Proprietà dei parametri
| Tipo: | Double |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
None
Non è possibile inviare tramite pipe l'input a Show-Command.
Output
System.String, System.Object
Quando si usa il parametro
Note
- Show-Command non funziona nelle sessioni remote.