Condividi tramite

Get-Verb

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Ottiene i verbi di PowerShell approvati.

Sintassi

Get-Verb
   [[-Verb] <String[]>]
   [[-Group] <String[]>]
   [<CommonParameters>]

Descrizione

La funzione Get-Verb ottiene i verbi approvati per l'uso nei comandi di PowerShell.

È consigliabile che i nomi di cmdlet e funzioni di PowerShell abbiano il formato Verb-Noun e includano un verbo approvato. Questa procedura rende i nomi dei comandi più coerenti, prevedibili e facili da usare.

I comandi che usano verbi non approvati continuano a essere eseguiti in PowerShell. Tuttavia, quando si importa un modulo che include un comando con un verbo non approvato nel nome, il comando Import-Module visualizza un messaggio di avviso.

Nota

L'elenco di verbi restituito Get-Verb 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.

Tipo:String[]
Valori accettati:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Posizione:1
Valore predefinito:All groups
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Verb

Ottiene solo i verbi specificati. Immettere il nome di un verbo o un modello di nome. Sono consentiti caratteri jolly.

Tipo:String[]
Posizione:0
Valore predefinito:All verbs
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

VerbInfo

Note

I verbi di PowerShell vengono assegnati a un gruppo in base all'uso più comune. I gruppi sono progettati per semplificare la ricerca e il confronto dei verbi, non per limitare 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 Add.
  • 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 applicabili alla diagnostica, ad esempio Debug.
  • Ciclo di vita: definire azioni applicabili 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 cronologiche e i relativi verbi vengono classificati come riservati.