Delen via

Goedgekeurde werkwoorden voor PowerShell-opdrachten

  • Artikel

PowerShell maakt gebruik van een werkwoord-zelfstandig naamwoordpaar voor de namen van cmdlets en voor hun afgeleide .NET-klassen. Het werkwoordgedeelte van de naam identificeert de actie die door de cmdlet wordt uitgevoerd. Het zelfstandig naamwoord van de naam identificeert de entiteit waarop de actie wordt uitgevoerd. Met de Get-Command cmdlet worden bijvoorbeeld alle opdrachten opgehaald die zijn geregistreerd in PowerShell.

Notitie

PowerShell gebruikt de term werkwoord om een woord te beschrijven dat een actie impliceert, zelfs als dat woord geen standaardwoord is in de Engelse taal. De term Nieuwe is bijvoorbeeld een geldige PowerShell-werkwoordsnaam, omdat het een actie impliceert, ook al is het geen werkwoord in de Engelse taal.

Elk goedgekeurd werkwoord heeft een overeenkomend aliasvoorvoegsel gedefinieerd. We gebruiken dit aliasvoorvoegsel in aliassen voor opdrachten die dat werkwoord gebruiken. Het aliasvoorvoegsel voor Import is bijvoorbeeld ip en de alias voor Import-Module wordt daarom ipmo. Dit is een aanbeveling, maar geen regel; in het bijzonder hoeft deze niet te worden gerespecteerd voor opdrachtaliassen die bekende opdrachten uit andere omgevingen nabootsen.

Aanbevelingen voor naamgeving van werkwoorden

Met de volgende aanbevelingen kunt u een geschikt werkwoord voor uw cmdlet kiezen om consistentie te garanderen tussen de cmdlets die u maakt, de cmdlets die worden geleverd door PowerShell en de cmdlets die door anderen zijn ontworpen.

  • Een van de vooraf gedefinieerde werkwoordnamen van PowerShell gebruiken
  • Gebruik het werkwoord om het algemene bereik van de actie te beschrijven en gebruik parameters om de actie van de cmdlet verder te verfijnen.
  • Gebruik geen synoniem van een goedgekeurd werkwoord. Gebruik bijvoorbeeld altijd Remove, gebruik nooit Delete of Eliminate.
  • Gebruik alleen de vorm van elk werkwoord dat in dit onderwerp wordt vermeld. Gebruik bijvoorbeeld Get, maar gebruik geen Getting of Gets.
  • Gebruik niet de volgende gereserveerde werkwoorden of aliassen. De PowerShell-taal en een paar cmdlets gebruiken deze werkwoorden onder uitzonderlijke omstandigheden.
    • ForEach (foreach)
    • Ping (pi)
    • Sorteren (sr)
    • Tee (te)
    • Waar (wh)

Mogelijk krijgt u een volledige lijst met werkwoorden met behulp van de cmdlet Get-Verb.

Vergelijkbare werkwoorden voor verschillende acties

De volgende vergelijkbare werkwoorden vertegenwoordigen verschillende acties.

Nieuw versus toevoegen

Gebruik de New werkwoord om een nieuwe resource te maken. Gebruik de Add om iets toe te voegen aan een bestaande container of resource. Add-Content bijvoorbeeld uitvoer toevoegt aan een bestaand bestand.

Nieuw versus set

Gebruik de New werkwoord om een nieuwe resource te maken. Gebruik de Set werkwoord om een bestaande resource te wijzigen, eventueel als deze niet bestaat, zoals de Set-Variable cmdlet.

Gebruik de Find werkwoord om naar een object te zoeken. Gebruik de Search werkwoord om een verwijzing naar een resource in een container te maken.

Get vs. Read

Gebruik de Get werkwoord om informatie te verkrijgen over een resource (zoals een bestand) of om een object te verkrijgen waarmee u in de toekomst toegang hebt tot de resource. Gebruik de Read werkwoord om een resource te openen en informatie te extraheren in de resource.

Aanroepen versus starten

Gebruik het Invoke werkwoord om synchrone bewerkingen uit te voeren, zoals het uitvoeren van een opdracht en wachten tot deze is beëindigd. Gebruik de Start werkwoord om asynchrone bewerkingen te starten, zoals het starten van een autonoom proces.

Ping versus test

Gebruik de Test werkwoord.

Algemene werkwoorden

PowerShell maakt gebruik van de opsommingsklasse System.Management.Automation.VerbsCommon om algemene acties te definiëren die op vrijwel elke cmdlet kunnen worden toegepast. De volgende tabel bevat de meeste gedefinieerde werkwoorden.

Werkwoord (alias) Handeling Synoniemen om te voorkomen
toevoegen (a) Voegt een resource toe aan een container of koppelt een item aan een ander item. De cmdlet Add-Content voegt bijvoorbeeld inhoud toe aan een bestand. Dit werkwoord is gekoppeld aan Remove. Toevoegen, bijvoegen, samenvoegen, invoegen
wissen (cl) Hiermee verwijdert u alle resources uit een container, maar wordt de container niet verwijderd. De cmdlet Clear-Content verwijdert bijvoorbeeld de inhoud van een bestand, maar verwijdert het bestand niet. Leegmaken, wissen, losmaken, markeren, opheffen, nullify
sluiten (cs) Hiermee wijzigt u de status van een resource om deze ontoegankelijk, niet beschikbaar of onbruikbaar te maken. Dit werkwoord is gekoppeld aan Open.
kopiëren (cp) Kopieert een resource naar een andere naam of naar een andere container. De Copy-Item cmdlet kopieert bijvoorbeeld een item (zoals een bestand) van de ene locatie in het gegevensarchief naar een andere locatie. Dupliceren, klonen, repliceren, synchroniseren
Enter (et) Hiermee geeft u een actie op waarmee de gebruiker naar een resource kan gaan. De cmdlet Enter-PSSession plaatst de gebruiker bijvoorbeeld in een interactieve sessie. Dit werkwoord is gekoppeld aan Exit. Duwen, naar
afsluiten (ex) Hiermee stelt u de huidige omgeving of context in op de laatst gebruikte context. De cmdlet Exit-PSSession plaatst de gebruiker bijvoorbeeld in de sessie die is gebruikt om de interactieve sessie te starten. Dit werkwoord is gekoppeld aan Enter. Pop, Out
Zoeken (fd) Hiermee wordt gezocht naar een object in een container die onbekend, impliciet, optioneel of opgegeven is. Zoeken
opmaak (f) Objecten in een opgegeven formulier of indeling rangschikken
(g) ophalen Hiermee geeft u een actie op waarmee een resource wordt opgehaald. Dit werkwoord is gekoppeld aan Set. Lezen, Openen, Kat, Type, Dir, Verkrijgen, Dump, Verkrijgen, Onderzoeken, Zoeken, Zoeken
verbergen (h) Maakt een resource niet detecteerbaar. Een cmdlet waarvan de naam de term Verbergen bevat, kan bijvoorbeeld een service van een gebruiker verbergen. Dit werkwoord is gekoppeld aan Show. Blokkeren
Join (j) Resources worden gecombineerd tot één resource. De cmdlet Join-Path combineert bijvoorbeeld een pad met een van de onderliggende paden om één pad te maken. Dit werkwoord is gekoppeld aan Split. Combineren, Unite, Connect, Associate
vergrendelen (lk) Beveiligt een resource. Dit werkwoord is gekoppeld aan Unlock. Beperken, beveiligen
verplaatsen (m) Hiermee verplaatst u een resource van de ene locatie naar de andere. De cmdlet Move-Item verplaatst bijvoorbeeld een item van de ene locatie in het gegevensarchief naar een andere locatie. Overdracht, naam, migreren
Nieuwe (n) Hiermee maakt u een resource. (De Set werkwoord kan ook worden gebruikt bij het maken van een resource die gegevens bevat, zoals de Set-Variable-cmdlet.) Maken, genereren, bouwen, maken, toewijzen
openen (op) Hiermee wijzigt u de status van een resource om deze toegankelijk, beschikbaar of bruikbaar te maken. Dit werkwoord is gekoppeld aan Close.
optimaliseren (om) Verhoogt de effectiviteit van een resource.
Pop- (pop) Hiermee verwijdert u een item boven aan een stapel. De cmdlet Pop-Location wijzigt bijvoorbeeld de huidige locatie in de locatie die het laatst naar de stack is gepusht.
Push (pu) Voegt een item toe aan de bovenkant van een stapel. De cmdlet Push-Location pusht bijvoorbeeld de huidige locatie naar de stack.
opnieuw (opnieuw) Hiermee stelt u een resource opnieuw in op de status die ongedaan is gemaakt.
verwijderen (r) Hiermee verwijdert u een resource uit een container. De cmdlet Remove-Variable verwijdert bijvoorbeeld een variabele en de bijbehorende waarde. Dit werkwoord is gekoppeld aan Add. Wissen, knippen, verwijderen, verwijderen, wissen
naam van wijzigen (rn) Hiermee wijzigt u de naam van een resource. De cmdlet Rename-Item, die wordt gebruikt voor toegang tot opgeslagen gegevens, wijzigt bijvoorbeeld de naam van een item in het gegevensarchief. Veranderen
opnieuw instellen (rs) Hiermee stelt u een resource terug in de oorspronkelijke staat.
formaat vanwijzigen (rz) Hiermee wijzigt u de grootte van een resource.
zoeken (sr) Hiermee maakt u een verwijzing naar een resource in een container. Zoeken, zoeken
(sc) selecteren Hiermee wordt een resource in een container gevonden. De cmdlet Select-String zoekt bijvoorbeeld tekst in tekenreeksen en bestanden. Zoeken, zoeken
(s) instellen Vervangt gegevens in een bestaande resource of maakt een resource die enkele gegevens bevat. De cmdlet Set-Date wijzigt bijvoorbeeld de systeemtijd op de lokale computer. (De New werkwoord kan ook worden gebruikt om een resource te maken.) Dit werkwoord is gekoppeld aan Get. Schrijven, Opnieuw instellen, Toewijzen, Configureren, Bijwerken
(sh) weergeven Hiermee wordt een resource zichtbaar voor de gebruiker. Dit werkwoord is gekoppeld aan Hide. Weergeven, produceren
(sk) overslaan Slaat een of meer resources of punten in een reeks over. Bypass, Jump
splitsen (sl) Scheidt delen van een resource. De cmdlet Split-Path retourneert bijvoorbeeld verschillende onderdelen van een pad. Dit werkwoord is gekoppeld aan Join. Scheiden
stap (st) Hiermee gaat u naar het volgende punt of de volgende resource in een reeks.
Switch (sw) Hiermee geeft u een actie op die tussen twee resources wisselt, bijvoorbeeld tussen twee locaties, verantwoordelijkheden of statussen.
ongedaan maken (ongedaan maken) Hiermee stelt u een resource in op de vorige status.
ontgrendelen (uk) Hiermee wordt een resource uitgebracht die is vergrendeld. Dit werkwoord is gekoppeld aan Lock. Release, Onbeperkt, Onbeveiligd
Watch (wc) Controleert of bewaakt voortdurend een resource op wijzigingen.

Communicatiewerkwoorden

PowerShell maakt gebruik van de klasse System.Management.Automation.VerbsCommunications om acties te definiëren die van toepassing zijn op communicatie. De volgende tabel bevat de meeste gedefinieerde werkwoorden.

Werkwoord (alias) Handeling Synoniemen om te voorkomen
Verbinding maken (CC) Hiermee maakt u een koppeling tussen een bron en een bestemming. Dit werkwoord is gekoppeld aan Disconnect. Deelnemen, Telnet, aanmelden
verbinding verbreken (dc) Hiermee wordt de koppeling tussen een bron en een bestemming verbroken. Dit werkwoord is gekoppeld aan Connect. Pauze, afmelden
lezen (rd) Haalt gegevens op uit een bron. Dit werkwoord is gekoppeld aan Write. Verkrijgen, vragen, ophalen
ontvangen (rc) Accepteert informatie die is verzonden vanuit een bron. Dit werkwoord is gekoppeld aan Send. Lezen, accepteren, bekijken
verzenden (sd) Levert informatie aan een bestemming. Dit werkwoord is gekoppeld aan Receive. Put, Broadcast, Mail, Fax
schrijven (wr) Hiermee voegt u informatie toe aan een doel. Dit werkwoord is gekoppeld aan Read. Plaatsen, afdrukken

Gegevenswerkwoorden

PowerShell maakt gebruik van de klasse System.Management.Automation.VerbsData om acties te definiëren die van toepassing zijn op gegevensverwerking. De volgende tabel bevat de meeste gedefinieerde werkwoorden.

Werkwoordnaam (alias) Handeling Synoniemen om te voorkomen
Back-up (ba) Slaat gegevens op door deze te repliceren. Opslaan, branden, repliceren, synchroniseren
controlepunt (ch) Hiermee maakt u een momentopname van de huidige status van de gegevens of van de configuratie. Diff
vergelijken (cr) Evalueert de gegevens van de ene resource op basis van de gegevens uit een andere resource. Diff
comprimeren (cm) Compacteert de gegevens van een resource. Paren met Expand. Compact
converteren (cv) Hiermee wijzigt u de gegevens van de ene weergave in een andere weergave wanneer de cmdlet bidirectionele conversie ondersteunt of wanneer de cmdlet conversie tussen meerdere gegevenstypen ondersteunt. Wijzigen, formaat wijzigen, opnieuw wijzigen
ConvertFrom (cf) Converteert één primair type invoer (het naamwoord cmdlet geeft de invoer aan) naar een of meer ondersteunde uitvoertypen. Exporteren, uitvoer, uit
ConvertTo (ct) Converteert van een of meer typen invoer naar een primair uitvoertype (het zelfstandig naamwoord van de cmdlet geeft het uitvoertype aan). Importeren, invoeren, in
ontkoppel (dm) Loskoppelt een benoemde entiteit van een locatie. Dit werkwoord is gekoppeld aan Mount. Ontkoppelen, ontkoppelen
bewerken (ed) Hiermee wijzigt u bestaande gegevens door inhoud toe te voegen of te verwijderen. Wijzigen, bijwerken, wijzigen
uitvouwen (en) Hiermee herstelt u de gegevens van een resource die is gecomprimeerd naar de oorspronkelijke staat. Dit werkwoord is gekoppeld aan Compress. Exploderen,Comprimeren
exporteren (ep) De primaire invoer wordt ingekapseld in een permanent gegevensarchief, zoals een bestand, of in een uitwisselingsindeling. Dit werkwoord is gekoppeld aan Import. Extraheren, back-up
Groep (gp) Een of meer resources rangschikt of koppelt
importeren (IP) Hiermee maakt u een resource op basis van gegevens die zijn opgeslagen in een permanent gegevensarchief (zoals een bestand) of in een uitwisselingsindeling. De Import-Csv cmdlet importeert bijvoorbeeld gegevens uit een CSV-bestand (door komma's gescheiden waarden) naar objecten die kunnen worden gebruikt door andere cmdlets. Dit werkwoord is gekoppeld aan Export. Bulksgewijs laden, laden
initialiseren (in) Bereidt een resource voor op gebruik en stelt deze in op een standaardstatus. Wissen, Init, Vernieuwen, Opnieuw opbouwen, Opnieuw initialiseren, Instellen
beperken (l) Hiermee past u beperkingen toe op een resource. Quotum
samenvoegen (mg) Hiermee maakt u één resource van meerdere resources. Combineren, deelnemen
koppelen (mt) Koppelt een benoemde entiteit aan een locatie. Dit werkwoord is gekoppeld aan Dismount. Verbinden
(o) Hiermee worden gegevens uit de omgeving verzonden. De cmdlet Out-Printer verzendt bijvoorbeeld gegevens naar een printer.
Publiceren (pb) Hiermee maakt u een resource beschikbaar voor anderen. Dit werkwoord is gekoppeld aan Unpublish. Implementeren, vrijgeven, installeren
herstellen (rr) Hiermee stelt u een resource in op een vooraf gedefinieerde status, zoals een status die door Checkpointis ingesteld. De cmdlet Restore-Computer start bijvoorbeeld een systeemherstel op de lokale computer. Herstellen, Retourneren, Ongedaan maken, Herstellen
Opslaan (sv) Behoudt gegevens om verlies te voorkomen.
synchroniseren (sy) Verzekert dat twee of meer resources dezelfde status hebben. Repliceren, coerce, overeenkomst
publicatie ongedaan maken (ub) Maakt een resource niet beschikbaar voor anderen. Dit werkwoord is gekoppeld aan Publish. Verwijderen, terugzetten, verbergen
bijwerken (ud) Brengt een resource up-to-datum om de status, nauwkeurigheid, conformiteit of naleving te behouden. De Update-FormatData cmdlet wordt bijvoorbeeld bijgewerkt en voegt opmaakbestanden toe aan de huidige PowerShell-console. Vernieuwen, Vernieuwen, Herberekenen, Opnieuw indexeren

Diagnostische werkwoorden

PowerShell maakt gebruik van de klasse System.Management.Automation.VerbsDiagnostic om acties te definiëren die van toepassing zijn op diagnostische gegevens. De volgende tabel bevat de meeste gedefinieerde werkwoorden.

Werkwoord (alias) Handeling Synoniemen om te voorkomen
foutopsporing (db) Onderzoekt een resource om operationele problemen vast te stellen. Diagnosticeren
meten (ms) Identificeert resources die worden gebruikt door een opgegeven bewerking of haalt statistieken over een resource op. Berekenen, bepalen, analyseren
Ping (pi) Afgeschaft: gebruik in plaats daarvan het testwoord.
herstellen (rp) Hiermee herstelt u een resource naar een bruikbare voorwaarde Herstellen, herstellen
Resolve (rv) Hiermee wordt een verkorte weergave van een resource toegewezen aan een volledigere weergave. Uitvouwen, bepalen
test (t) Controleert de bewerking of consistentie van een resource. Diagnose, analyseren, resteren, controleren
Tracering (tr) Houdt de activiteiten van een resource bij. Bijhouden, volgen, inspecteren, graven

Levenscycluswerkwoorden

PowerShell maakt gebruik van de klasse System.Management.Automation.VerbsLifecycle om acties te definiëren die van toepassing zijn op de levenscyclus van een resource. De volgende tabel bevat de meeste gedefinieerde werkwoorden.

Werkwoord (alias) Handeling Synoniemen om te voorkomen
goedkeuren (ap) Bevestigt of gaat akkoord met de status van een resource of proces.
Assert (as) Bevestigt de status van een resource. Certify
build- (bd) Hiermee maakt u een artefact (meestal een binair document) uit een set invoerbestanden (meestal broncode of declaratieve documenten.) Dit werkwoord is toegevoegd in PowerShell 6.
voltooien (cp) Hiermee wordt een bewerking afgesloten.
(cn) bevestigen Hiermee wordt de status van een resource of proces bevestigd, gecontroleerd of gevalideerd. Bevestigen, ermee akkoord gaan, certificeren, valideren, verifiëren
weigeren (dn) Weigert, objecten, blokken of verzet zich tegen de status van een resource of proces. Blokkeren, Object, Weigeren, Weigeren
Implementeren (dp) Hiermee verzendt u een toepassing, website of oplossing naar een extern doel[s] op een zodanige manier dat een consument van die oplossing deze kan openen nadat de implementatie is voltooid. Dit werkwoord is toegevoegd in PowerShell 6.
(d) uitschakelen Hiermee configureert u een resource naar een niet-beschikbare of inactieve status. De cmdlet Disable-PSBreakpoint maakt bijvoorbeeld een onderbrekingspunt inactief. Dit werkwoord is gekoppeld aan Enable. Stoppen, Verbergen
(e) inschakelen Hiermee configureert u een resource in een beschikbare of actieve status. De cmdlet Enable-PSBreakpoint maakt bijvoorbeeld een onderbrekingspunt actief. Dit werkwoord is gekoppeld aan Disable. Starten, beginnen
installeren (is) Hiermee plaatst u een resource op een locatie en initialiseert u deze desgewenst. Dit werkwoord is gekoppeld aan Uninstall. Configuratie
(i) aanroepen Voert een actie uit, zoals het uitvoeren van een opdracht of een methode. Uitvoeren, starten
(rg) registreren Hiermee maakt u een vermelding voor een resource in een opslagplaats, zoals een database. Dit werkwoord is gekoppeld aan Unregister.
aanvraag (rq) Vraagt om een resource of vraagt om machtigingen.
opnieuw opstarten (rt) Stopt een bewerking en start deze opnieuw. De Restart-Service cmdlet stopt bijvoorbeeld en start vervolgens een service. Recycleren
hervatten (ru) Start een bewerking die is onderbroken. De cmdlet Resume-Service start bijvoorbeeld een service die is onderbroken. Dit werkwoord is gekoppeld aan Suspend.
(sa) starten Hiermee wordt een bewerking gestart. De cmdlet Start-Service start bijvoorbeeld een service. Dit werkwoord is gekoppeld aan Stop. Starten, initiëren, opstarten
stoppen (sp) Stopt met een activiteit. Dit werkwoord is gekoppeld aan Start. Beëindigen, Beëindigen, Beëindigen, Annuleren
verzenden (sb) Geeft een resource weer voor goedkeuring. Verzenden
(ss) onderbreken Onderbreekt een activiteit. Met de Suspend-Service cmdlet wordt bijvoorbeeld een service onderbroken. Dit werkwoord is gekoppeld aan Resume. Pauze
verwijderen (us) Hiermee verwijdert u een resource van een aangegeven locatie. Dit werkwoord is gekoppeld aan Install.
registratie van ongedaan maken (uw) Hiermee verwijdert u de vermelding voor een resource uit een opslagplaats. Dit werkwoord is gekoppeld aan Register. Verwijderen
wachten (w) Onderbreekt een bewerking totdat een opgegeven gebeurtenis plaatsvindt. De Wait-Job cmdlet onderbreekt bijvoorbeeld bewerkingen totdat een of meer van de achtergrondtaken zijn voltooid. Slaapstand, pauzeren

Beveiligingswoorden

PowerShell maakt gebruik van de klasse System.Management.Automation.VerbsSecurity om acties te definiëren die van toepassing zijn op beveiliging. De volgende tabel bevat de meeste gedefinieerde werkwoorden.

Werkwoord (alias) Handeling Synoniemen om te voorkomen
blokkeren (bl) Hiermee beperkt u de toegang tot een resource. Dit werkwoord is gekoppeld aan Unblock. Voorkomen, beperken, weigeren
Grant (gr) Hiermee heeft u toegang tot een resource. Dit werkwoord is gekoppeld aan Revoke. Toestaan, inschakelen
beveiligen (pt) Beschermt een resource tegen aanvallen of verlies. Dit werkwoord is gekoppeld aan Unprotect. Versleutelen, beveiligen, verzegelen
(rk) intrekken Hiermee geeft u een actie op die geen toegang tot een resource toestaat. Dit werkwoord is gekoppeld aan Grant. Verwijderen, uitschakelen
deblokkeren (ul) Hiermee verwijdert u beperkingen voor een resource. Dit werkwoord is gekoppeld aan Block. Wissen, Toestaan
Beveiliging opheffen (omhoog) Hiermee verwijdert u beveiliging van een resource die is toegevoegd om te voorkomen dat deze wordt aangevallen of verloren. Dit werkwoord is gekoppeld aan Protect. Ontsleutelen, Unseal

Andere werkwoorden

PowerShell maakt gebruik van de klasse System.Management.Automation.VerbsOther om canonieke werkwoordnamen te definiëren die niet passen in een specifieke werkwoordscategorie, zoals de algemene werkwoorden, communicatie, gegevens, levenscyclus of namen van beveiligingswerkwoorden.

Werkwoord (alias) Handeling Synoniemen om te voorkomen
(u) gebruiken Gebruikt of bevat een resource om iets te doen.

Zie ook