Condividi tramite

Verbi approvati per i comandi di PowerShell

  • Articolo

PowerShell usa una coppia verbo-sostantivo per i nomi dei cmdlet e per le classi .NET derivate. La componente verbo del nome identifica l'azione eseguita dal cmdlet. La componente sostantivo del nome identifica l'entità su cui viene eseguita l'azione. Ad esempio, il cmdlet Get-Command recupera tutti i comandi registrati in PowerShell.

Nota

PowerShell usa il termine verbo per descrivere una parola che implica un'azione, anche se la parola in questione non è un verbo standard nella lingua inglese. Il termine New, ad esempio, è un nome di verbo di PowerShell valido perché implica un'azione anche se non corrisponde a un verbo nella lingua inglese.

Ogni verbo approvato ha un prefisso alias corrispondente definito. Questo prefisso alias viene usato negli alias per i comandi che usano questo verbo. Ad esempio, il prefisso alias per Import è ip e, di conseguenza, l'alias per Import-Module è ipmo. Si tratta di una raccomandazione, ma non di una regola. In particolare, non deve essere necessariamente rispettata per gli alias di comandi che simulano comandi noti di altri ambienti.

Raccomandazioni per la denominazione dei verbi

Le raccomandazioni seguenti consentono di scegliere un verbo appropriato per il cmdlet, per garantire la coerenza tra i cmdlet creati, quelli forniti da PowerShell e i cmdlet progettati da altri utenti.

  • Usare uno dei nomi di verbi predefiniti forniti da PowerShell
  • Usare il verbo per descrivere l'ambito generale dell'azione e usare i parametri per perfezionare ulteriormente l'azione del cmdlet.
  • Non usare un sinonimo di un verbo approvato. Ad esempio, usare sempre Remove, non usare mai Delete o Eliminate.
  • Usare solo il formato di ogni verbo elencato in questo argomento. Ad esempio, usare Get, ma non usare Getting o Gets.
  • Non usare i seguenti verbi o alias riservati. Il linguaggio di PowerShell e alcuni cmdlet rari usano questi verbi in circostanze eccezionali.
    • ForEach (foreach)
    • Ping (pi)
    • Sort (sr)
    • Tee (te)
    • Where (wh)

È possibile ottenere un elenco completo di verbi usando il cmdlet Get-Verb.

Verbi simili per azioni diverse

I verbi simili riportati di seguito rappresentano azioni diverse.

Nuovo e Aggiungi

Usare il verbo New per creare una nuova risorsa. Usare per Add aggiungere un elemento a un contenitore o a una risorsa esistente. Ad esempio, Add-Content aggiunge l'output a un file esistente.

New e Set

Usare il verbo New per creare una nuova risorsa. Usare il verbo Set per modificare una risorsa esistente, eventualmente creandola se non esiste, come il cmdlet Set-Variable.

Usare il verbo Find per cercare un oggetto. Usare il verbo Search per creare un riferimento a una risorsa in un contenitore.

Get e Lettura

Usare il verbo Get per ottenere informazioni su una risorsa, ad esempio un file, o per ottenere un oggetto con cui è possibile accedere alla risorsa in futuro. Usare il Read verbo per aprire una risorsa ed estrarre le informazioni contenute all'interno di .

Invoke e Inizia

Usare il verbo Invoke per eseguire operazioni sincrone, come l'esecuzione di un comando e l'attesa del suo completamento. Usare il Start verbo per avviare operazioni asincrone, ad esempio l'avvio di un processo autonomo.

Ping e Test

Usare il verbo Test.

Verbi comuni

PowerShell usa la classe di enumerazione System.Management.Automation.VerbsCommon per definire azioni generiche che possono applicabili a quasi tutti i cmdlet. La tabella seguente elenca la maggior parte dei verbi definiti.

Verbo (alias) Azione Sinonimi da evitare
Add (a) Aggiunge una risorsa a un contenitore o collega un elemento a un altro elemento. Ad esempio, il cmdlet Add-Content aggiunge contenuto a un file. Questo verbo è associato a Remove. Append, Attach, Concatenate, Insert
Clear (cl) Rimuove tutte le risorse da un contenitore, ma non elimina il contenitore. Ad esempio, il cmdlet Clear-Content rimuove il contenuto di un file ma non elimina il file. Flush, Erase, Release, Unmark, Unset, Nullify
Close (cs) Modifica lo stato di una risorsa per renderla inaccessibile, non disponibile o inutilizzabile. Questo verbo è associato a Open.
Copy (cp) Copia una risorsa in un altro nome o in un altro contenitore. Ad esempio, il cmdlet Copy-Item copia un elemento, come un file, da una posizione nell'archivio dati in un'altra posizione. Duplicate, Clone, Replicate, Sync
Enter (et) Specifica un'azione che consente all'utente di spostarsi in una risorsa. Ad esempio, il cmdlet Enter-PSSession inserisce l'utente in una sessione interattiva. Questo verbo è associato a Exit. Push, Into
Exit (ex) Imposta l'ambiente o il contesto corrente sul contesto usato più di recente. Ad esempio, il cmdlet Exit-PSSession inserisce l'utente nella sessione usata per avviare la sessione interattiva. Questo verbo è associato a Enter. Pop, Out
Find (fd) Cerca un oggetto in un contenitore sconosciuto, implicito, facoltativo o specificato. Ricerca
Formato (f) Dispone gli oggetti in un form o in un layout specificato
Get (g) Specifica un'azione che recupera una risorsa. Questo verbo è associato a Set. Read, Open, Cat, Type, Dir, Obtain, Dump, Acquire, Examine, Find, Search
Hide (h) Rende una risorsa non rilevabile. Ad esempio, un cmdlet il cui nome include il verbo Hide potrebbe nascondere un servizio a un utente. Questo verbo è associato a Show. Blocca
Join (j) Combina le risorse in un'unica risorsa. Ad esempio, il cmdlet Join-Path combina un percorso con uno dei percorsi figlio per creare un singolo percorso. Questo verbo è associato a Split. Combine, Unite, Connect, Associate
Lock (lk) Protegge una risorsa. Questo verbo è associato a Unlock. Restrict, Secure
Move (m) Sposta una risorsa da un percorso a un altro. Ad esempio, il cmdlet Move-Item sposta un elemento da una posizione nell'archivio dati in un'altra posizione. Transfer, Name, Migrate
New (n) Crea una risorsa. Quando si crea una risorsa che include dati, può essere usato anche il verbo Set, come nel cmdlet Set-Variable. Create, Generate, Build, Make, Allocate
Open (op) Modifica lo stato di una risorsa per renderla accessibile, disponibile o utilizzabile. Questo verbo è associato a Close.
Optimize (om) Aumenta l'efficacia di una risorsa.
Pop (pop) Rimuove un elemento dall'inizio di uno stack. Ad esempio, il cmdlet Pop-Location imposta il percorso corrente sul percorso di cui è stato eseguito il push più di recente nello stack.
Push (pu) Aggiunge un elemento all'inizio di uno stack. Ad esempio, il cmdlet Push-Location esegue il push del percorso corrente nello stack.
Redo (re) Reimposta una risorsa sullo stato che è stato annullato.
Remove (r) Elimina una risorsa da un contenitore. Ad esempio, il cmdlet Remove-Variable elimina una variabile e il relativo valore. Questo verbo è associato a Add. Clear, Cut, Dispose, Discard, Erase
Rename (rn) Modifica il nome di una risorsa. Ad esempio, il cmdlet Rename-Item, usato per accedere ai dati archiviati, modifica il nome di un elemento nell'archivio dati. Modifica
Reset (rs) Ripristina lo stato originale di una risorsa.
Resize(rz) Modifica la dimensione di una risorsa.
Search (sr) Crea un riferimento a una risorsa in un contenitore. Find, Locate
Select (sc) Individua una risorsa in un contenitore. Ad esempio, il cmdlet Select-String trova testo in stringhe e file. Find, Locate
Set (s) Sostituisce i dati in una risorsa esistente o crea una risorsa contenente alcuni dati. Ad esempio, il cmdlet Set-Date modifica l'ora di sistema nel computer locale (per creare una risorsa può essere usato anche il verbo New). Questo verbo è associato a Get. Write, Reset, Assign, Configure
Show (sh) Rende visibile una risorsa all'utente. Questo verbo è associato a Hide. Display, Produce
Skip (sk) Ignora una o più risorse o punti in una sequenza. Bypass, Jump
Split (sl) Separa le parti di una risorsa. Ad esempio, il cmdlet Split-Path restituisce parti diverse di un percorso. Questo verbo è associato a Join. Separa
Step (st) Passa al punto o alla risorsa successiva in una sequenza.
Switch (sw) Specifica un'azione che si alterna tra due risorse, ad esempio per passare da una posizione, responsabilità o stato all'altro.
Undo (un) Imposta una risorsa sullo stato precedente.
Unlock (uk) Rilascia una risorsa bloccata. Questo verbo è associato a Lock. Release, Unrestrict, Unsecure
Watch (wc) Controlla o monitora continuamente una risorsa per individuare eventuali modifiche.

Verbi di comunicazione

PowerShell usa la classe System.Management.Automation.VerbsCommunications per definire le azioni che si applicano alle comunicazioni. La tabella seguente elenca la maggior parte dei verbi definiti.

Verbo (alias) Azione Sinonimi da evitare
Connect (cc) Crea un collegamento tra un'origine e una destinazione. Questo verbo è associato a Disconnect. Join, Telnet
Disconnect (dc) Interrompe il collegamento tra un'origine e una destinazione. Questo verbo è associato a Connect. Break, Logoff
Read (rd) Acquisisce informazioni da un'origine. Questo verbo è associato a Write. Acquire, Prompt, Get
Receive (rc) Accetta le informazioni inviate da un'origine. Questo verbo è associato a Send. Read, Accept, Peek
Send (sd) Recapita le informazioni a una destinazione. Questo verbo è associato a Receive. Put, Broadcast, Mail, Fax
Write (wr) Aggiunge informazioni a una destinazione. Questo verbo è associato a Read. Put, Print

Verbi di dati

PowerShell usa la classe System.Management.Automation.VerbsData per definire le azioni che si applicano alla gestione dei dati. La tabella seguente elenca la maggior parte dei verbi definiti.

Nome del verbo (alias) Azione Sinonimi da evitare
Backup (ba) Archivia i dati eseguendone la replica. Save, Burn, Replicate, Sync
Checkpoint (ch) Crea uno snapshot dello stato corrente dei dati o della relativa configurazione. Diff
Compare (cr) Valuta i dati di una risorsa in base a quelli di un'altra risorsa. Diff
Compress (cm) Compatta i dati di una risorsa. È associato a Expand. Compact
Convert (cv) Modifica i dati da una rappresentazione a un'altra quando il cmdlet supporta la conversione bidirezionale o quando il cmdlet supporta la conversione tra più tipi di dati. Change, Resize, Resample
ConvertFrom (cf) Converte un tipo di input primario (il nome del cmdlet indica l'input) in uno o più tipi di output supportati. Export, Output, Out
ConvertTo (ct) Esegue la conversione da uno o più tipi di input a un tipo di output primario (il nome del cmdlet indica il tipo di output). Import, Input, In
Dismount (dm) Scollega un'entità denominata da un percorso. Questo verbo è associato a Mount. Unmount, Unlink
Edit (ed) Modifica i dati esistenti aggiungendo o rimuovendo contenuto. Change, Update, Modify
Expand (en) Ripristina i dati di una risorsa che è stata compressa allo stato originale. Questo verbo è associato a Compress. Explode, Uncompress
Export (ep) Incapsula l'input primario in un archivio dati persistente, ad esempio un file, o in un formato di interscambio. Questo verbo è associato a Import. Extract, Backup
Gruppo (gp) Dispone o associa una o più risorse
Import (ip) Crea una risorsa da dati archiviati in un archivio dati permanente (ad esempio un file) o in un formato di interscambio. Ad esempio, il cmdlet Import-CSV importa i dati da un file con valori delimitati da virgole (CSV) in oggetti che possono essere usati da altri cmdlet. Questo verbo è associato a Export. BulkLoad, Load
Initialize (in) Prepara una risorsa per l'uso e la imposta su uno stato predefinito. Erase, Init, Renew, Rebuild, Reinitialize, Setup
Limit (l) Applica vincoli a una risorsa. Quota
Merge (mg) Crea un'unica risorsa da più risorse. Combine, Join
Mount (mt) Collega un'entità denominata a un percorso. Questo verbo è associato a Dismount. Connessione
Out (o) Invia dati all'esterno dell'ambiente. Ad esempio, il cmdlet Out-Printer invia dati a una stampante.
Publish (pb) Rende una risorsa disponibile ad altri utenti. Questo verbo è associato a Unpublish. Deploy, Release, Install
Restore (rr) Imposta una risorsa su uno stato predefinito, come uno stato impostato da Checkpoint. Ad esempio, il cmdlet Restore-Computer avvia un ripristino di sistema nel computer locale. Repair, Return, Undo, Fix
Save (sv) Conserva i dati per evitare perdite.
Sync (sy) Assicura che due o più risorse si trovino nello stesso stato. Replicate, Coerce, Match
Unpublish (ub) Rende una risorsa non disponibile ad altri utenti. Questo verbo è associato a Publish. Uninstall, Revert, Hide
Update (ud) Tiene aggiornata una risorsa per mantenerne lo stato, l'accuratezza e la conformità. Ad esempio, il cmdlet Update-FormatData aggiorna e aggiunge file di formattazione alla console di PowerShell corrente. Refresh, Renew, Recalculate, Re-index

Verbi di diagnostica

PowerShell usa la classe System.Management.Automation.VerbsDiagnostic per definire le azioni che si applicano alla diagnostica. La tabella seguente elenca la maggior parte dei verbi definiti.

Verbo (alias) Azione Sinonimi da evitare
Debug (db) Esamina una risorsa per diagnosticare problemi operativi. Diagnosi
Measure (ms) Identifica le risorse usate da un'operazione specificata o recupera le statistiche relative a una risorsa. Calculate, Determine, Analyze
Ping (pi) Deprecato: usare invece il verbo Test.
Repair (rp) Riporta una risorsa a una condizione utilizzabile Fix, Restore
Resolve (rv) Esegue il mapping di una rappresentazione abbreviata di una risorsa a una rappresentazione più completa. Expand, Determine
Test (t) Verifica l'operazione o la coerenza di una risorsa. Diagnose, Analyze, Salvage, Verify
Trace (tr) Tiene traccia delle attività di una risorsa. Track, Follow, Inspect, Dig

Verbi del ciclo di vita

PowerShell usa la classe System.Management.Automation.VerbsLifeCycle per definire le azioni che si applicano al ciclo di vita di una risorsa. La tabella seguente elenca la maggior parte dei verbi definiti.

Verbo (alias) Azione Sinonimi da evitare
Approve (ap) Conferma o accetta lo stato di una risorsa o di un processo.
Assert (as) Afferma lo stato di una risorsa. Certify
Build (bd) Crea un artefatto, in genere un file binario o un documento, da un set di file di input, in genere codice sorgente o documenti dichiarativi. Questo verbo è stato aggiunto in PowerShell 6.
Complete (cp) Conclude un'operazione.
Confirm (cn) Conferma, verifica o convalida lo stato di una risorsa o di un processo. Acknowledge, Agree, Certify, Validate, Verify
Deny (dn) Rifiuta, blocca, obietta o si oppone allo stato di una risorsa o di un processo. Block, Object, Refuse, Reject
Deploy (dp) Invia un'applicazione, un sito Web o una soluzione a una o più destinazioni remote in modo che un utente di tale soluzione possa accedervi al termine della distribuzione. Questo verbo è stato aggiunto in PowerShell 6.
Disable (d) Configura una risorsa su uno stato non disponibile o inattivo. Ad esempio, il cmdlet Disable-PSBreakpoint rende inattivo un punto di interruzione. Questo verbo è associato a Enable. Halt, Hide
Enable (e) Configura una risorsa su uno stato disponibile o attivo. Ad esempio, il cmdlet Enable-PSBreakpoint rende attivo un punto di interruzione. Questo verbo è associato a Disable. Start, Begin
Install (is) Inserisce una risorsa in un percorso e, facoltativamente, la inizializza. Questo verbo è associato a Uninstall. Configurazione
Invoke (i) Esegue un'azione, come l'esecuzione di un comando o di un metodo. Run, Start
Register (rg) Crea una voce per una risorsa in un repository, ad esempio un database. Questo verbo è associato a Unregister.
Request (rq) Richiede una risorsa o chiede le autorizzazioni.
Restart (rt) Arresta un'operazione, quindi la avvia nuovamente. Ad esempio, il cmdlet Restart-Service arresta e quindi avvia un servizio. Ripetere il ciclo
Resume (ru) Avvia un'operazione precedentemente sospesa. Ad esempio, il cmdlet Resume-Service avvia un servizio che è stato sospeso. Questo verbo è associato a Suspend.
Start (sa) Avvia un'operazione. Ad esempio, il cmdlet Start-Service avvia un servizio. Questo verbo è associato a Stop. Launch, Initiate, Boot
Stop (sp) Interrompe un'attività. Questo verbo è associato a Start. End, Kill, Terminate, Cancel
Submit (sb) Presenta una risorsa per l'approvazione. Pubblica
Suspend (ss) Sospende un'attività. Ad esempio, il cmdlet Suspend-Service sospende un servizio. Questo verbo è associato a Resume. Sospendi
Uninstall (us) Rimuove una risorsa da una posizione indicata. Questo verbo è associato a Install.
Unregister (ur) Rimuove la voce di una risorsa da un repository. Questo verbo è associato a Register. Rimuovi
Wait (w) Sospende un'operazione fino a quando non si verifica un evento specificato. Ad esempio, il cmdlet Wait-Job sospende le operazioni fino al completamento di uno o più processi in background. Sleep, Pause

Verbi di sicurezza

PowerShell usa la classe System.Management.Automation.VerbsSecurity per definire le azioni che si applicano alla sicurezza. La tabella seguente elenca la maggior parte dei verbi definiti.

Verbo (alias) Azione Sinonimi da evitare
Block (bl) Limita l'accesso a una risorsa. Questo verbo è associato a Unblock. Prevent, Limit, Deny
Grant (gr) Consente l'accesso a una risorsa. Questo verbo è associato a Revoke. Allow, Enable
Protect (pt) Protegge una risorsa da attacchi o perdite. Questo verbo è associato a Unprotect. Encrypt, Safeguard, Seal
Revoke (rk) Specifica un'azione che non consente l'accesso a una risorsa. Questo verbo è associato a Grant. Remove, Disable
Unblock (ul) Rimuove le restrizioni per una risorsa. Questo verbo è associato a Block. Clear, Allow
Unprotect (up) Rimuove le misure di sicurezza di una risorsa aggiunte per impedirne l'attacco o la perdita. Questo verbo è associato a Protect. Decrypt, Unseal

Altri verbi

PowerShell usa la classe System.Management.Automation.VerbsOther per definire i nomi di verbi canonici che non rientrano in una categoria specifica del nome del verbo, ad esempio i verbi comuni, delle comunicazioni, dei dati, del ciclo di vita o di sicurezza.

Verbo (alias) Azione Sinonimi da evitare
Use (u) Usa o include una risorsa per eseguire un'operazione.

Vedere anche