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 de cmdlet uitvoert. Het zelfstandig naamwoorddeel van de naam identificeert de entiteit waarop de actie wordt uitgevoerd. De cmdlet Get-Command haalt bijvoorbeeld alle opdrachten op 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 standaardwerkwoord in de Engelse taal is. De term Nieuw is bijvoorbeeld een geldige PowerShell-werkwoordnaam omdat het een actie impliceert, ook al is het geen werkwoord in de Engelse taal.

Voor elke goedgekeurde werkwoord is een bijbehorend alias voorvoegsel gedefinieerd. We gebruiken dit alias-voorvoegsel in aliassen voor opdrachten die dat werkwoord gebruiken. Het voorvoegsel van de alias Import voor is bijvoorbeeld en daarom is ip de alias voor Import-Module ipmo. Dit is een aanbeveling, maar geen regel; in het bijzonder hoeft dit niet te worden gerespecteerd voor opdrachtaliassen die bekende opdrachten van andere omgevingen nabootsen.

Werkwoordnaamgeving Aanbevelingen

De volgende aanbevelingen helpen u bij het kiezen van een geschikt werkwoord voor uw cmdlet, 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.

  • Gebruik een van de vooraf gedefinieerde werkwoordnamen van PowerShell
  • 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 , Removegebruik nooit Delete of Eliminate.
  • Gebruik alleen de vorm van elk werkwoord dat in dit onderwerp wordt vermeld. Gebruik bijvoorbeeld , Getmaar gebruik niet Getting of Gets.
  • Gebruik niet de volgende gereserveerde werkwoorden of aliassen. De PowerShell-taal en enkele zeldzame cmdlets gebruiken deze werkwoorden in uitzonderlijke omstandigheden.
    • ForEach (foreach)
    • Ping (pi)
    • Sorteren (sr)
    • Tee (te)
    • Where (wh)

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

Vergelijkbare werkwoorden voor verschillende acties

De volgende vergelijkbare werkwoorden vertegenwoordigen verschillende acties.

Nieuw versus Toevoegen

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

Nieuw versus ingesteld

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

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

Get vs. Read

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

Aanroepen versus starten

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

Ping versus testen

Gebruik het werkwoord Test .

Veelvoorkomende woorden

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

Werkwoord (alias) Actie 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. Append, Attach, Concatenate, Insert
Clear (cl) Hiermee verwijdert u alle resources uit een container, maar verwijdert u de container niet. De cmdlet Clear-Content verwijdert bijvoorbeeld de inhoud van een bestand, maar verwijdert het bestand niet. Leegzetten, wissen, vrijgeven, markering verwijderen, onbezegeld, nullify
Sluiten (cs) Wijzigt 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 cmdlet Copy-Item kopieert bijvoorbeeld een item (zoals een bestand) van de ene locatie in het gegevensopslag 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. Push, Into
Afsluiten (bijvoorbeeld) Hiermee stelt u de huidige omgeving of context in op de meest recent gebruikte context. De cmdlet plaatst Exit-PSSession 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) Zoekt naar een object in een container die onbekend, impliciet, optioneel of opgegeven is. Zoeken
Indeling (f) Rangschikt objecten in een opgegeven vorm of indeling
Get (g) Hiermee geeft u een actie op die een resource op haalt. Dit werkwoord is gekoppeld aan Set. Lezen, Openen, Cat, Type, Dir, Verkrijgen, Dump, Verkrijgen, Onderzoeken, Zoeken, Zoeken
Verbergen (h) Maakt een resource niet detecteerbaar. Een cmdlet waarvan de naam het woord Verbergen bevat, kan bijvoorbeeld een service van een gebruiker afwijsen. Dit werkwoord is gekoppeld aan Show. Blokkeren
Lid worden (j) Combineert resources in één resource. De cmdlet combineert Join-Path bijvoorbeeld een pad met een van de onderliggende paden om één pad te maken. Dit werkwoord is gekoppeld aan Split. Combineren, Combineren, Verbinding maken, Koppelen
Vergrendeling (kunt u doen) Beveiligt een resource. Deze werkwoord is gekoppeld aan Unlock. Beperken, beveiligen
Verplaatsen (m) Hiermee verplaatst u een resource van de ene locatie naar de andere. De cmdlet verplaatst Move-Item bijvoorbeeld een item van de ene locatie in het gegevensopslag naar een andere locatie. Overdracht, Naam, Migreren
Nieuw (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) Wijzigt de status van een resource om deze toegankelijk, beschikbaar of bruikbaar te maken. Deze werkwoord is gekoppeld aan Close.
Optimaliseren (om) Verhoogt de effectiviteit van een resource.
Pop (pop) Hiermee verwijdert u een item aan de bovenkant van een stack. De cmdlet wijzigt Pop-Location bijvoorbeeld de huidige locatie in de locatie die het laatst naar de stack is ge pusht.
Push (pu) Hiermee voegt u een item toe aan de bovenkant van een stack. De cmdlet Push-Location pusht bijvoorbeeld de huidige locatie naar de stack.
Opnieuw doen (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 waarde ervan. Deze werkwoord is gekoppeld aan Add. Wissen, Knippen, Verwijderen, Verwijderen, Wissen
Naam wijzigen (rn) Wijzigt 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 gegevensopslag. Wijziging
Opnieuw instellen (rs) Hiermee stelt u een resource terug naar de oorspronkelijke status.
Resize(rz) Wijzigt de grootte van een resource.
Zoeken (sr) Hiermee maakt u een verwijzing naar een resource in een container. Zoeken, Zoeken
Selecteer (sc) Zoekt een resource in een container. De cmdlet zoekt Select-String bijvoorbeeld tekst in tekenreeksen en bestanden. Zoeken, Zoeken
Instellen (s) Vervangt gegevens van een bestaande resource of maakt een resource die enkele gegevens bevat. De cmdlet wijzigt Set-Date bijvoorbeeld de systeemtijd op de lokale computer. (De New werkwoord kan ook worden gebruikt om een resource te maken.) Deze werkwoord is gekoppeld aan Get. Schrijven, Opnieuw instellen, Toewijzen, Configureren
Show (sh) Maakt een resource zichtbaar voor de gebruiker. Deze werkwoord is gekoppeld aan Hide. Weergeven, Produceren
Overslaan (sk) Een of meer resources of punten in een reeks omzeilt. Bypass, Jump
Splitsen (sl) Scheidt delen van een resource. Split-Path De cmdlet retourneert bijvoorbeeld verschillende onderdelen van een pad. Deze werkwoord is gekoppeld aan Join. Aparte
Stap (st) Wordt verplaatst naar het volgende punt of de volgende resource in een reeks.
Switch (sw) Hiermee geeft u een actie op die wordt afgewisseld tussen twee resources, zoals om te wisselen tussen twee locaties, verantwoordelijkheden of staten.
Ongedaan maken (un) Hiermee stelt u een resource in op de vorige status.
Ontgrendelen (VK) Geeft een resource vrij die is vergrendeld. Deze werkwoord is gekoppeld aan Lock. Release, Unrestrict, Onbeveiligd
Bekijken (wc) Een resource wordt voortdurend gecontroleerd of gecontroleerd 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) Actie Synoniemen om te voorkomen
Verbinding maken (cc) Hiermee maakt u een koppeling tussen een bron en een bestemming. Deze werkwoord is gekoppeld aan Disconnect. Deelnemen, Telnet
Verbinding verbreken (dc) De koppeling tussen een bron en een bestemming wordt breekt. Deze werkwoord is gekoppeld aan Connect. Break, Logoff
Lezen (rd) Verkrijgt informatie uit een bron. Deze werkwoord is gekoppeld aan Write. Verkrijgen, vragen, verkrijgen
Ontvangen (rc) Accepteert informatie die is verzonden vanuit een bron. Deze werkwoord is gekoppeld aan Send. Lezen, Accepteren, Bekijken
Verzenden (sd) Levert informatie aan een bestemming. Deze werkwoord is gekoppeld aan Receive. Put, Broadcast, Mail, Fax
Schrijven (wr) Voegt informatie toe aan een doel. Deze werkwoord is gekoppeld aan Read. Put, Print

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) Actie 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. Versch
Vergelijken (cr) Evalueert de gegevens van de ene resource op de gegevens van een andere resource. Versch
Comprimeren (cm) Compersteert de gegevens van een resource. Wordt gekoppeld aan Expand. Comprimeren
Converteren (cv) Wijzigt de gegevens van de ene weergave in de andere wanneer de cmdlet bidirectionele conversie ondersteunt of wanneer de cmdlet conversie tussen meerdere gegevenstypen ondersteunt. Wijzigen, Het wijzigen van deize, Resample
ConvertFrom (cf) Converteert één primair type invoer (het zelfstandig 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 cmdlet geeft het uitvoertype aan). Importeren, invoeren, in
Ontkoppelen (dm) Een benoemde entiteit wordt losgekoppeld van een locatie. Deze werkwoord is gekoppeld aan Mount. Ontkoppelen, Ontkoppelen
Bewerken (ed) Wijzigt bestaande gegevens door inhoud toe te voegen of te verwijderen. Wijzigen, Bijwerken, Wijzigen
Uitbreiden (en) Herstelt de gegevens van een resource die is gecomprimeerd naar de oorspronkelijke staat. Deze werkwoord is gekoppeld aan Compress. Decomprimeren
Exporteren (ep) De primaire invoer wordt ingekapseld in een permanent gegevensopslag, zoals een bestand, of in een uitwisselingsindeling. Deze werkwoord is gekoppeld aan Import. Extraheren, back-up maken
Groep (gp) Rangschikt of koppelt een of meer resources
Importeren (ip) Hiermee maakt u een resource van gegevens die zijn opgeslagen in een permanent gegevensopslag (zoals een bestand) of in een uitwisselingsindeling. Import-CSV De cmdlet importeert bijvoorbeeld gegevens uit een CSV-bestand (door komma's gescheiden waarden) naar objecten die kunnen worden gebruikt door andere cmdlets. Deze werkwoord is gekoppeld aan Export. Bulkloaden, laden
Initialiseren (in) Bereidt een resource voor op gebruik en stelt deze in op een standaardtoestand. Wissen, Init, Vernieuwen, Herbouwen, Opnieuwialiseren, Instellen
Limiet (l) Beperkingen worden toegepast op een resource. Quota
Samenvoegen (mg) Hiermee maakt u één resource van meerdere resources. Combineren, koppelen
Mount (mt) Koppelt een benoemde entiteit aan een locatie. Deze werkwoord is gekoppeld aan Dismount. Verbinding maken
Uit (o) Verzendt gegevens uit de omgeving. De cmdlet verzendt Out-Printer bijvoorbeeld gegevens naar een printer.
Publiceren (pb) Maakt een resource beschikbaar voor anderen. Deze 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 is ingesteld door Checkpoint. De cmdlet start Restore-Computer bijvoorbeeld een systeemherstel op de lokale computer. Herstellen, Retourneren, Ongedaan maken, Herstellen
Opslaan (sv) Behoudt gegevens om verlies te voorkomen.
Synchroniseren (sy) Zorgt ervoor dat twee of meer resources dezelfde status hebben. Repliceren, coerce, overeenkomst
Publiceren ongedaan maken (ub) Maakt een resource niet beschikbaar voor anderen. Deze werkwoord is gekoppeld aan Publish. Verwijderen, terugdraaien, verbergen
Bijwerken (ud) Zorgt dat een resource up-to-date blijft om de status, nauwkeurigheid, conformiteit of naleving te behouden. De cmdlet werkt Update-FormatData bijvoorbeeld bij en voegt opmaakbestanden toe aan de huidige PowerShell-console. Vernieuwen, Vernieuwen, Opnieuw berekenen, Opnieuw indexeren

Diagnostische woorden

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) Actie Synoniemen om te voorkomen
Fouten opsporen (db) Onderzoekt een resource om operationele problemen vast te stellen. Diagnosticeren
Meting (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 werkwoord Test.
Reparatie (rp) Herstelt een resource naar een gebruiksbare voorwaarde Herstellen, herstellen
Oplossen (opgelost) Kaarten verkorte weergave van een resource in een meer volledige weergave. Uitbreiden, Bepalen
Testen (t) Controleert de bewerking of consistentie van een resource. Diagnose, Analyseren, Resten, Verifiëren
Trace (tr) Houdt de activiteiten van een resource bij. Bijhouden, Volgen, Inspecteren, Dig

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) Actie Synoniemen om te voorkomen
Goedkeuren (ap) Bevestigt of akkoord gaat met de status van een resource of proces.
Assert (als) Bevestigt de status van een resource. Certify
Build (bd) Hiermee maakt u een artefact (meestal een binair of document) uit een set invoerbestanden (meestal broncode of declaratieve documenten).) Dit werkwoord is toegevoegd in PowerShell 6.
Voltooien (cp) Een bewerking wordt afgesloten.
Bevestigen (cn) Bevestigt, verifieert of valideert de status van een resource of proces. Bevestigen, Akkoord, Certificeren, Valideren, Verifiëren
Weigeren (dn) Weigert, objecten, blokken of verneert de status van een resource of proces. Blokkeren, Object, Weigeren, Weigeren
Implementeren (dp) Verzendt een toepassing, website of oplossing naar een extern doel[s] zodanig dat een consument van die oplossing er toegang toe heeft nadat de implementatie is voltooid. Dit werkwoord is toegevoegd in PowerShell 6.
Uitschakelen (d) Hiermee configureert u een resource in een niet-beschikbare of inactieve status. Disable-PSBreakpoint De cmdlet maakt bijvoorbeeld een onderbrekingspunt inactief. Dit werkwoord is gekoppeld aan Enable. Stoppen, verbergen
Inschakelen (e) Hiermee configureert u een resource naar een beschikbare of actieve status. De cmdlet Enable-PSBreakpoint maakt bijvoorbeeld een onderbrekingspunt actief. Dit werkwoord is gekoppeld aan Disable. Starten, Beginnen
Installeren (is) Plaatst een resource op een locatie en initialiseert deze optioneel. Dit werkwoord is gekoppeld aan Uninstall. Instellen
Aanroepen (i) Voert een actie uit, zoals het uitvoeren van een opdracht of een methode. Uitvoeren, Starten
Registreren (rg) 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. Restart-Service De cmdlet stopt bijvoorbeeld en start vervolgens een service. Recyclen
Hervatten (ru) Start een bewerking die is opgeschort. Resume-Service De cmdlet start bijvoorbeeld een service die is opgeschort. Dit werkwoord is gekoppeld aan Suspend.
Starten (sa) Initieert een bewerking. De cmdlet Start-Service start bijvoorbeeld een service. Dit werkwoord is gekoppeld aan Stop. Starten, initiëren, opstarten
Stoppen (sp) Stopt een activiteit. Dit werkwoord is gekoppeld aan Start. Beëindigen, beëindigen, beëindigen, annuleren
Verzenden (sb) Geeft een resource voor goedkeuring. Plaatsen
Suspend (ss) Een activiteit pauzeert. Suspend-Service De cmdlet pauzeert bijvoorbeeld een service. Dit werkwoord is gekoppeld aan Resume. Onderbreken
Verwijderen (vs) Hiermee verwijdert u een resource van een aangegeven locatie. Dit werkwoord is gekoppeld aan Install.
Registratie ongedaan maken (uw) Hiermee verwijdert u de vermelding voor een resource uit een opslagplaats. Dit werkwoord is gekoppeld aan Register. Verwijderen
Wachten (w) Pauzeert een bewerking totdat een opgegeven gebeurtenis plaatsvindt. Met de Wait-Job cmdlet worden bewerkingen bijvoorbeeld onderbroken totdat een of meer achtergrondtaken zijn voltooid. Slaapstand, Onderbreken

Beveiligingswerkwoorden

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) Actie Synoniemen om te voorkomen
Blok (bl) Hiermee beperkt u de toegang tot een resource. Dit werkwoord is gekoppeld aan Unblock. Voorkomen, Beperken, Weigeren
Verlenen (gr) Hiermee staat u toegang tot een resource toe. 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
Intrekken (rk) Hiermee geeft u een actie op die geen toegang tot een resource toestaat. Dit werkwoord is gekoppeld aan Grant. Verwijderen, Uitschakelen
Blokkering opheffen (ul) Hiermee verwijdert u beperkingen voor een resource. Dit werkwoord is gekoppeld aan Block. Leeg, Toestaan
Beveiliging opheffen (omhoog) Hiermee verwijdert u veiligheidsmaatregelen van een resource die is toegevoegd om aanvallen of verlies te voorkomen. Dit werkwoord is gekoppeld aan Protect. Ontsleutelen, niet-versleuteld

Andere werkwoorden

PowerShell maakt gebruik van de klasse System.Management.Automation.VerbsOther voor het definiëren van canonieke werkwoordnamen die niet in een specifieke werkwoordnaamcategorie passen, zoals de algemene werkwoordnamen, de algemene werkwoordnamen, de communicatie, de gegevens, de levenscyclus of de naamwoorden voor beveiligingswerkwoorden.

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

Zie ook