Condividi tramite

Verbi approvati per i comandi di PowerShell

PowerShell usa una coppia verbo-sostantivo per i nomi dei cmdlet e per le classi .NET derivate. La parte verbo del nome identifica l'azione eseguita dal cmdlet. La parte sostantivo del nome identifica l'entità in 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 tale parola non è un verbo standard nella lingua inglese. Ad esempio, il termine New è un nome di verbo di PowerShell valido perché implica un'azione anche se non è 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 tale 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 è necessario rispettare per gli alias di comando simulando comandi noti di altri ambienti.

Raccomandazioni per la denominazione dei verbi

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

  • Usare uno dei nomi di verbo 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 verbi o gli alias riservati seguenti. 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 seguenti rappresentano azioni diverse.

New contro Add

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

New contro Set

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

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

Get contro Read

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 verbo Read per aprire una risorsa ed estrarre informazioni contenute all'interno.

Invoke contro Start

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

Ping contro Test

Usare il verbo Test.

Verbi comuni

PowerShell usa la classe di enumerazione System.Management.Automation.VerbsCommon per definire azioni generiche che possono essere applicate a quasi tutti i cmdlet. Nella tabella seguente sono elencati 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. Aggiungi, Allega, Concatena, Inserisci
Clear (cl) Rimuove tutte le risorse da un contenitore, ma non elimina il contenitore. Ad esempio, il Clear-Content cmdlet rimuove il contenuto di un file, ma non elimina il file. Svuota, Cancella, Rilascia, Deseleziona, Annulla
Close (cs) Modifica lo stato di una risorsa per renderlo 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 (ad esempio un file) da una posizione nell'archivio dati a un'altra posizione. Duplica, Clona, Replica, Sincronizza
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. Spingere, Dentro
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, Fuori
Find (fd) Cerca un oggetto in un contenitore sconosciuto, implicito, facoltativo o specificato. Ricerca
Format (f) Dispone gli oggetti in una maschera o in un layout specificato
Get (g) Specifica un'azione che recupera una risorsa. Questo verbo è associato a Set. Leggere, Aprire, Cat, Digitare, Dir, Ottenere, Scaricare, Acquisire, Esaminare, Trovare, Cerca
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. Blocco
Join (j) Combina le risorse in una sola risorsa. Ad esempio, il cmdlet Join-Path combina un percorso con uno dei relativi percorsi figlio per creare un singolo percorso. Questo verbo è associato a Split. Combinare, unire, connettere, associare
Lock (lk) Protegge una risorsa. Questo verbo è associato a Unlock. Limita, Proteggi
Move (m) Sposta una risorsa da una posizione a un'altra. Ad esempio, il cmdlet Move-Item sposta un elemento da una posizione nell'archivio dati a un'altra posizione. Trasferimento, nome, migrazione
New (n) Crea una risorsa. Il verbo Set può essere usato anche durante la creazione di una risorsa che include dati, ad esempio il cmdlet Set-Variable. Creare, generare, compilare, creare, allocare
Open (op) Modifica lo stato di una risorsa per renderlo accessibile, disponibile o utilizzabile. Questo verbo è associato a Close.
Optimize (om) Aumenta l'efficacia di una risorsa.
Pop (pop) Rimuove un elemento dalla parte superiore di uno stack. Ad esempio, il cmdlet Pop-Location modifica la posizione corrente nel percorso di cui è stato eseguito il push più 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 lo stato di una risorsa annullata.
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. Cancella, Taglia, Smaltisci, Scarta, Cancella
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. Cambiamento
Reset (rs) Imposta di nuovo una risorsa sullo stato originale.
Resize (rz) Modifica le dimensioni di una risorsa.
Search (sr) Crea un riferimento a una risorsa in un contenitore. Trova, Individua
Select (sc) Individua una risorsa in un contenitore. Ad esempio, il cmdlet Select-String trova testo in stringhe e file. Trova, Individua
Set (s) Sostituisce i dati in una risorsa esistente o crea una risorsa che contiene alcuni dati. Ad esempio, il cmdlet Set-Date modifica l'ora di sistema nel computer locale. Il verbo New può essere usato anche per creare una risorsa. Questo verbo è associato a Get. Scrittura, reimpostazione, assegnazione, configurazione, aggiornamento
Show (sh) Rende una risorsa visibile all'utente. Questo verbo è associato a Hide. Esposizione, produzione
Skip (sk) Ignora una o più risorse o punti in una sequenza. Bypass, Salto
Split (sl) Separa parti di una risorsa. Ad esempio, il cmdlet Split-Path restituisce parti diverse di un percorso. Questo verbo è associato a Join. Separare
Step (st) Passa al punto o alla risorsa successiva in una sequenza.
Switch (sw) Specifica un'azione che alterna due risorse, ad esempio per passare da due posizioni, responsabilità o stati.
Undo (un) Imposta una risorsa sullo stato precedente.
Unlock (uk) Rilascia una risorsa bloccata. Questo verbo è associato a Lock. Rilascia, Libera, Non sicuro
Watch (wc) Controlla o monitora continuamente una risorsa per individuare le modifiche.

Verbi di comunicazione

PowerShell usa la classe System.Management.Automation.VerbsCommunications per definire azioni applicabili alle comunicazioni. Nella tabella seguente sono elencati 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. Partecipa, Telnet, Accedi
Disconnect (dc) Interrompe il collegamento tra un'origine e una destinazione. Questo verbo è associato a Connect. Interruzione, disconnessione
Read (rd) Acquisisce informazioni da un'origine. Questo verbo è associato a Write. Acquisizione, richiesta, recupero
Receive (rc) Accetta informazioni inviate da un'origine. Questo verbo è associato a Send. Leggi, accetta, sbircia
Send (sd) Recapita informazioni a una destinazione. Questo verbo è associato a Receive. Put, Broadcast, Posta, Fax
Write (wr) Aggiunge informazioni a una destinazione. Questo verbo è associato a Read. Mettere, stampare

Verbi dati

PowerShell usa la classe System.Management.Automation.VerbsData per definire azioni applicabili alla gestione dei dati. Nella tabella seguente sono elencati la maggior parte dei verbi definiti.

Nome verbo (alias) Azione Sinonimi da evitare
Backup (ba) Archivia i dati replicandoli. Salva, Burn, Replica, Sincronizza
Checkpoint (ch) Crea uno snapshot dello stato corrente dei dati o della relativa configurazione. Differenza
Compare (cr) Valuta i dati di una risorsa rispetto ai dati di un'altra risorsa. Differenza
Compress (cm) Compatta i dati di una risorsa. Coppie con Expand. Compatto
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. Modificare, ridimensionare, ricampionare
ConvertFrom (cf) Converte un tipo primario di input (il sostantivo del cmdlet indica l'input) in uno o più tipi di output supportati. Esportazione, output, out
ConvertTo (ct) Converte da uno o più tipi di input a un tipo di output primario (il sostantivo del cmdlet indica il tipo di output). Importa, Input, In
Dismount (dm) Scollega un'entità denominata da una posizione. Questo verbo è associato a Mount. Smontare, scollegare
Edit (ed) Modifica i dati esistenti aggiungendo o rimuovendo il contenuto. Modificare, aggiornare, modificare
Expand (en) Ripristina i dati di una risorsa compressa nello stato originale. Questo verbo è associato a Compress. Esplodere, decomprimere
Export (ep) Incapsula l'input primario in un archivio dati permanente, ad esempio un file o in un formato di interscambio. Questo verbo è associato a Import. Estrarre, eseguire il backup
Group (gp) Dispone o associa una o più risorse
Import (ip) Crea una risorsa dai dati archiviati in un archivio dati permanente (ad esempio un file) o in un formato di interscambio. Ad esempio, il Import-Csv cmdlet importa dati da un file con valori delimitati da virgole (CSV) a oggetti che possono essere usati da altri cmdlet. Questo verbo è associato a Export. BulkLoad, Caricamento
Initialize (in) Prepara una risorsa per l'uso e la imposta su uno stato predefinito. Cancella, Inizializza, Rinnova, Ricostruisci, Reinizializza, Imposta
Limit (l) Applica vincoli a una risorsa. Quota
Merge (mg) Crea una singola risorsa da più risorse. Combinare, unire
Mount (mt) Associa un'entità denominata a una posizione. Questo verbo è associato a Dismount. Connettersi
Out (o) Invia dati all'esterno dell'ambiente. Ad esempio, il cmdlet Out-Printer invia dati a una stampante.
Publish (pb) Rende disponibile una risorsa ad altri utenti. Questo verbo è associato a Unpublish. Distribuire, rilasciare, installare
Restore (rr) Imposta una risorsa su uno stato predefinito, ad esempio uno stato impostato da Checkpoint. Ad esempio, il cmdlet Restore-Computer avvia un ripristino di sistema nel computer locale. Ripara, Restituisci, Annulla, Correggi
Save (sv) Mantiene i dati per evitare la perdita.
Sync (sy) Assicura che due o più risorse si trovino nello stesso stato. Replica, Coerce, Match
Unpublish (ub) Rende una risorsa non disponibile per altri utenti. Questo verbo è associato a Publish. Disinstallare, ripristinare, nascondere
Update (ud) Porta una risorsa up-to-date per mantenere lo stato, l'accuratezza, la conformità o la conformità. Ad esempio, il cmdlet Update-FormatData aggiorna e aggiunge i file di formattazione alla console di PowerShell corrente. Aggiorna, Rinnova, Ricalcola, Reindicizza

Verbi di diagnostica

PowerShell usa la classe System.Management.Automation.VerbsDiagnostic per definire azioni applicabili alla diagnostica. Nella tabella seguente sono elencati la maggior parte dei verbi definiti.

Verbo (alias) Azione Sinonimi da evitare
Debug (db) Esamina una risorsa per diagnosticare i problemi operativi. Diagnosticare
Measure (ms) Identifica le risorse utilizzate da un'operazione specificata o recupera le statistiche relative a una risorsa. Calcolare, determinare, analizzare
Ping (pi) Deprecato: usare invece il verbo Test.
Repair (rp) Ripristina una risorsa in una condizione utilizzabile Correzione, ripristino
Resolve (rv) Esegue il mapping di una rappresentazione abbreviata di una risorsa a una rappresentazione più completa. Espandi, determina
Test (t) Verifica l'operazione o la coerenza di una risorsa. Diagnosticare, analizzare, salvare, verificare
Trace (tr) Tiene traccia delle attività di una risorsa. Traccia, segui, ispeziona, scava

Verbi relativi al ciclo di vita

PowerShell usa la classe System.Management.Automation.VerbsLifecycle per definire azioni applicabili al ciclo di vita di una risorsa. Nella tabella seguente sono elencati 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. Certificare
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) Riconosce, verifica o convalida lo stato di una risorsa o di un processo. Confermare, accettare, certificare, convalidare, verificare
Deny (dn) Rifiuta, oggetti, blocchi o si oppone allo stato di una risorsa o di un processo. Block, Object, Reject, Reject
Deploy (dp) Invia un'applicazione, un sito Web o una soluzione a una destinazione remota in modo che un consumer di tale soluzione possa accedervi dopo il completamento della distribuzione. Questo verbo è stato aggiunto in PowerShell 6.
Disable (d) Configura una risorsa in uno stato non disponibile o inattivo. Ad esempio, il cmdlet Disable-PSBreakpoint rende inattivo un punto di interruzione. Questo verbo è associato a Enable. Interrompi, Nascondi
Enable (e) Configura una risorsa in uno stato disponibile o attivo. Ad esempio, il cmdlet Enable-PSBreakpoint rende attivo un punto di interruzione. Questo verbo è associato a Disable. Inizio, inizio
Install (is) Inserisce una risorsa in una posizione e, facoltativamente, la inizializza. Questo verbo è associato a Uninstall. Configurazione
Invoke (i) Esegue un'azione, ad esempio l'esecuzione di un comando o un metodo. Esegui, Avvia
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 richiede le autorizzazioni.
Restart (rt) Arresta un'operazione e quindi la avvia nuovamente. Ad esempio, il cmdlet Restart-Service si arresta e quindi avvia un servizio. Riciclare
Resume (ru) Avvia un'operazione sospesa. Ad esempio, il cmdlet Resume-Service avvia un servizio 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. Avviare, avviare, avviare, avviare
Stop (sp) Interrompe un'attività. Questo verbo è associato a Start. Termina, Uccidi, Termina, Annulla
Submit (sb) Presenta una risorsa per l'approvazione. Inserisci
Suspend (ss) Sospende un'attività. Ad esempio, il cmdlet Suspend-Service sospende un servizio. Questo verbo è associato a Resume. Pausa
Uninstall (us) Rimuove una risorsa da una posizione indicata. Questo verbo è associato a Install.
Unregister (ur) Rimuove la voce per 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. Sospensione, pausa

Verbi di sicurezza

PowerShell usa la classe System.Management.Automation.VerbsSecurity per definire azioni applicabili alla sicurezza. Nella tabella seguente sono elencati 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. Impedisci, Limita, Nega
Grant (gr) Consente l'accesso a una risorsa. Questo verbo è associato a Revoke. Consenti, Abilita
Protect (pt) Protegge una risorsa da attacchi o perdite. Questo verbo è associato a Unprotect. Crittografa, Salvaguarda, Seal
Revoke (rk) Specifica un'azione che non consente l'accesso a una risorsa. Questo verbo è associato a Grant. Rimuovi, Disabilita
Unblock (ul) Rimuove le restrizioni per una risorsa. Questo verbo è associato a Block. Cancella, Consenti
Unprotect (up) Rimuove le misure di sicurezza da una risorsa aggiunta per impedirne l'attacco o la perdita. Questo verbo è associato a Protect. Decrittografare, Unseal

Altri verbi

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

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

Vedere anche