Get-Verb
Ottiene i verbi di PowerShell approvati.
Sintassi
Get-Verb
[[-Verb] <String[]>]
[[-Group] <String[]>]
[<CommonParameters>]
Descrizione
La Get-Verb
funzione ottiene i verbi approvati per l'uso nei comandi di PowerShell.
È consigliabile che i nomi dei cmdlet e delle funzioni di PowerShell abbiano il Verb-Noun
formato e includano un verbo approvato. Questa procedura rende più coerenti, prevedibili e facili da usare i nomi dei comandi.
I comandi che usano verbi non approvati, vengono comunque eseguiti in PowerShell. Tuttavia, quando si importa un modulo che include un comando con un verbo non approvato nel nome, il Import-Module
comando visualizza un messaggio di avviso.
Nota
Elenco verbo che Get-Verb
restituisce potrebbe non essere completo. Per un elenco aggiornato dei verbi di PowerShell approvati con descrizioni, vedere Verbi approvati.
Esempio
Esempio 1 - Ottenere un elenco di tutti i verbi
Get-Verb
Esempio 2: ottenere un elenco di verbi approvati che iniziano con "un"
Get-Verb un*
Verb AliasPrefix Group Description
---- ----------- ----- -----------
Undo un Common Sets a resource to its previous state
Unlock uk Common Releases a resource that was locked
Unpublish ub Data Makes a resource unavailable to others
Uninstall us Lifecycle Removes a resource from an indicated location
Unregister ur Lifecycle Removes the entry for a resource from a repository
Unblock ul Security Removes restrictions to a resource
Unprotect up Security Removes safeguards from a resource that were added to prevent it from attack or loss
Esempio 3: ottenere tutti i verbi approvati nel gruppo Sicurezza
Get-Verb -Group Security
Verb AliasPrefix Group Description
---- ----------- ----- -----------
Block bl Security Restricts access to a resource
Grant gr Security Allows access to a resource
Protect pt Security Safeguards a resource from attack or loss
Revoke rk Security Specifies an action that does not allow access to a resource
Unblock ul Security Removes restrictions to a resource
Unprotect up Security Removes safeguards from a resource that were added to prevent it from attack or loss
Esempio 4: trova tutti i comandi in un modulo con verbi non approvati
Get-Command -Module Microsoft.PowerShell.Utility | Where-Object Verb -NotIn (Get-Verb).Verb
CommandType Name Version Source
----------- ---- ------- ------
Cmdlet Sort-Object 3.1.0.0 Microsoft.PowerShell.Utility
Cmdlet Tee-Object 3.1.0.0 Microsoft.PowerShell.Utility
Parametri
-Group
Ottiene solo i gruppi specificati. Immettere il nome di un gruppo. I caratteri jolly non sono consentiti.
Questo parametro è stato introdotto in PowerShell 6.0.
Type: | String[] |
Accepted values: | Common, Communications, Data, Diagnostic, Lifecycle, Other, Security |
Position: | 1 |
Default value: | All groups |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Verb
Ottiene solo i verbi specificati. Immettere il nome di un verbo o un modello di nome. I caratteri jolly sono consentiti.
Type: | String[] |
Position: | 0 |
Default value: | All verbs |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
Input
None
Non è possibile eseguire la pipe degli oggetti a questo cmdlet.
Output
Note
I verbi di PowerShell vengono assegnati a un gruppo in base all'uso più comune. I gruppi sono concepiti per semplificare la ricerca e il confronto dei verbi, non per limitarne l'uso. È possibile usare qualsiasi verbo approvato per qualsiasi tipo di comando.
Ogni verbo di PowerShell viene assegnato a uno dei gruppi seguenti.
- Comune: definire azioni generice che possono essere applicate a quasi tutti i cmdlet, ad esempio Aggiungi.
- Comunicazioni: definire azioni che si applicano alle comunicazioni, ad esempio Connect.
- Dati: definire azioni che si applicano alla gestione dei dati, ad esempio Backup.
- Diagnostica: definire azioni che si applicano alla diagnostica, ad esempio Debug.
- Ciclo di vita: definire azioni che si applicano al ciclo di vita di un cmdlet, ad esempio Complete.
- Sicurezza: definire azioni che si applicano alla sicurezza, ad esempio Revoca.
- Altro: definire altri tipi di azioni.
Alcuni dei cmdlet installati con PowerShell, ad esempio Tee-Object
e Where-Object
, usano verbi non approvati. Questi cmdlet sono eccezioni storiche e i relativi verbi vengono classificati come riservati.